NetworkStream.WriteAsync Méthode

Définition

Surcharges

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Écrit des données dans NetworkStream à partir d’une plage de mémoire d’octets en mémoire en lecture seule en tant qu’opération asynchrone.Writes data to the NetworkStream from a read-only memory byte memory range as an asynchronous operation.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Écrit des données dans NetworkStream à partir d’une plage spécifiée d’un tableau d’octets en tant qu’opération asynchrone.Writes data to the NetworkStream from the specified range of a byte array as an asynchronous operation.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Écrit des données dans NetworkStream à partir d’une plage de mémoire d’octets en mémoire en lecture seule en tant qu’opération asynchrone.Writes data to the NetworkStream from a read-only memory byte memory range as an asynchronous operation.

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.ValueTask
Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Paramètres

buffer
ReadOnlyMemory<Byte>

Zone de mémoire qui contient les données à écrire dans NetworkStream.A region of memory that contains the data to write to the NetworkStream.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation.The token to monitor for cancellation requests.

Retours

ValueTask

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

Exceptions

NetworkStream ne prend pas en charge l’écriture.The NetworkStream does not support writing.

Une erreur s’est produite pendant l’accès au socket.An error occurred when accessing the socket.

- ou --or-

Une erreur s'est produite pendant l'écriture sur le réseau.There was a failure while writing to the network.

Le NetworkStream est fermé.The NetworkStream is closed.

Remarques

Cette méthode envoie tous les octets dans buffer le réseau.This method sends all bytes in buffer to the network.

Notes

Vérifiez si le NetworkStream est accessible en écriture en appelant la CanWrite propriété.Check to see if the NetworkStream is writable by calling the CanWrite property. Si vous tentez d’écrire dans un NetworkStream qui n’est pas accessible en écriture, vous obtiendrez un InvalidOperationException .If you attempt to write to a NetworkStream that is not writable, you will get an InvalidOperationException.

Notes

Si vous recevez un IOException , vérifiez la InnerException propriété pour déterminer si elle a été provoquée par un SocketException .If you receive an IOException, check the InnerException property to determine if it was caused by a SocketException. Si c’est le cas, utilisez la ErrorCode propriété pour obtenir le code d’erreur spécifique et reportez-vous à la documentation sur les codes d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.If so, use the ErrorCode property to obtain the specific error code and refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

S’applique à

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Écrit des données dans NetworkStream à partir d’une plage spécifiée d’un tableau d’octets en tant qu’opération asynchrone.Writes data to the NetworkStream from the specified range of a byte array as an asynchronous operation.

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);
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As Task

Paramètres

buffer
Byte[]

Tableau d’octets qui contient les données à écrire dans NetworkStream.A byte array that contains the data to write to the NetworkStream.

offset
Int32

Emplacement de buffer à partir duquel commencer à écrire les données.The location in buffer from which to start writing data.

size
Int32

Nombre d'octets à écrire dans NetworkStream.The number of bytes to write to the NetworkStream.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation.The token to monitor for cancellation requests.

Retours

Task

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

Exceptions

Le paramètre buffer a la valeur null.The buffer parameter is null.

Le paramètre offset est inférieur à 0.The offset parameter is less than 0.

- ou --or- Le paramètre offset est supérieur à la longueur de buffer.The offset parameter is greater than the length of buffer.

- ou --or- Le paramètre size est inférieur à 0.The size parameter is less than 0.

- ou --or- Le paramètre size est supérieur à la longueur de buffer moins la valeur du paramètre offset.The size parameter is greater than the length of buffer minus the value of the offset parameter.

NetworkStream ne prend pas en charge l’écriture.The NetworkStream does not support writing.

Une erreur s'est produite pendant l'écriture sur le réseau.There was a failure while writing to the network.

- ou --or-

Une erreur s’est produite pendant l’accès au socket.An error occurred when accessing the socket.

Le NetworkStream est fermé.The NetworkStream is closed.

Remarques

Cette méthode démarre à l’adresse spécifiée offset et envoie des size octets à partir du contenu de buffer au réseau.This method starts at the specified offset and sends size bytes from the contents of buffer to the network.

Notes

Vérifiez si le NetworkStream est accessible en écriture en appelant la CanWrite propriété.Check to see if the NetworkStream is writable by calling the CanWrite property. Si vous tentez d’écrire dans un NetworkStream qui n’est pas accessible en écriture, vous obtiendrez un InvalidOperationException .If you attempt to write to a NetworkStream that is not writable, you will get an InvalidOperationException.

Notes

Si vous recevez un IOException , vérifiez la InnerException propriété pour déterminer si elle a été provoquée par un SocketException .If you receive an IOException, check the InnerException property to determine if it was caused by a SocketException. Si c’est le cas, utilisez la ErrorCode propriété pour obtenir le code d’erreur spécifique et reportez-vous à la documentation sur les codes d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.If so, use the ErrorCode property to obtain the specific error code and refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

S’applique à