NetworkStream.WriteAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Écrit des données dans la NetworkStream plage de mémoire en lecture seule en tant qu’opération asynchrone. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Écrit des données dans la NetworkStream plage spécifiée d’un tableau d’octets en tant qu’opération asynchrone. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
Écrit des données dans la NetworkStream plage de mémoire en lecture seule en tant qu’opération asynchrone.
public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParamètres
- buffer
- ReadOnlyMemory<Byte>
Région de mémoire qui contient les données à écrire dans le NetworkStream.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation.
Retours
Tâche qui représente l’opération d’écriture asynchrone.
Exceptions
Il NetworkStream ne prend pas en charge l’écriture.
Une erreur s’est produite lors de l’accès au socket.
-ou-
Une défaillance s’est produite lors de l’écriture sur le réseau.
La NetworkStream fermeture est terminée.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Cette méthode envoie tous les octets buffer au réseau.
Note
Vérifiez si l’écriture NetworkStream est accessible en appelant la CanWrite propriété. Si vous tentez d’écrire dans un NetworkStream fichier qui n’est pas accessible en écriture, vous obtiendrez un InvalidOperationException.
Note
Si vous recevez un IOException, vérifiez la InnerException propriété pour déterminer si elle a été provoquée par un SocketException. Si c’est le cas, utilisez la propriété ErrorCode pour obtenir le code d’erreur spécifique et reportez-vous à la documentation du code d’erreur api Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
S’applique à
WriteAsync(Byte[], Int32, Int32, CancellationToken)
Écrit des données dans la NetworkStream plage spécifiée d’un tableau d’octets en tant qu’opération asynchrone.
public:
override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);abstract member WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Taskoverride this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As TaskParamètres
- buffer
- Byte[]
Tableau d’octets qui contient les données à écrire dans le NetworkStream.
- offset
- Int32
Emplacement dans buffer lequel commencer l’écriture de données.
- countsize
- Int32
Nombre d’octets à écrire dans le NetworkStream.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation.
Retours
Tâche qui représente l’opération d’écriture asynchrone.
Exceptions
Le buffer paramètre est null.
Le offset paramètre est inférieur à 0.
-ou-
Le offset paramètre est supérieur à la longueur de buffer.
-ou-
Le size paramètre est inférieur à 0.
-ou-
Le size paramètre est supérieur à la longueur de buffer moins la valeur du offset paramètre.
Il NetworkStream ne prend pas en charge l’écriture.
Une défaillance s’est produite lors de l’écriture sur le réseau.
-ou-
Une erreur s’est produite lors de l’accès au socket.
La NetworkStream fermeture est terminée.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Cette méthode commence à l’octet spécifié offset et envoie count des octets du contenu du buffer réseau.
Note
Vérifiez si l’écriture NetworkStream est accessible en appelant la CanWrite propriété. Si vous tentez d’écrire dans un NetworkStream fichier qui n’est pas accessible en écriture, vous obtiendrez un InvalidOperationException.
Note
Si vous recevez un IOException, vérifiez la InnerException propriété pour déterminer si elle a été provoquée par un SocketException. Si c’est le cas, utilisez la propriété ErrorCode pour obtenir le code d’erreur spécifique et reportez-vous à la documentation du code d’erreur api Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(Byte[], Int32, Int32).