NetworkStream.Write Méthode

Définition

Espace de noms:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Surcharges

Write(ReadOnlySpan<Byte>)	Écrit des données dans le NetworkStream à partir d’une étendue d’octets en lecture seule.
Write(Byte[], Int32, Int32)	Écrit des données dans NetworkStream à partir d’une plage spécifiée d’un tableau d’octets.

Write(ReadOnlySpan<Byte>)

Source:

NetworkStream.cs

Écrit des données dans le NetworkStream à partir d’une étendue d’octets en lecture seule.

public override void Write (ReadOnlySpan<byte> buffer);

Paramètres

buffer

ReadOnlySpan<Byte>

Données à écrire dans le NetworkStream.

Exceptions

InvalidOperationException

NetworkStream ne prend pas en charge l’écriture.

IOException

Une erreur s’est produite pendant l’accès au socket.

- ou -

Une erreur s'est produite pendant l'écriture sur le réseau.

ObjectDisposedException

Le NetworkStream est fermé.

Remarques

Cette méthode envoie tous les octets au buffer réseau. La Write méthode se bloque jusqu’à ce que le nombre d’octets demandé soit envoyé ou qu’un SocketException soit levée.

Note

Vérifiez si est NetworkStream accessible en écriture en appelant la CanWrite propriété . Si vous essayez d’écrire dans un NetworkStream qui n’est pas accessible en écriture, vous obtenez un InvalidOperationException.

Note

Si vous recevez un IOException, case activée la InnerException propriété pour déterminer si elle a été provoquée par un 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 le code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Write(Byte[], Int32, Int32)

Source:

NetworkStream.cs

Écrit des données dans NetworkStream à partir d’une plage spécifiée d’un tableau d’octets.

public override void Write (byte[] buffer, int offset, int count);

Paramètres

buffer

Byte[]

Tableau de type Byte qui contient les données à écrire dans NetworkStream.

offset

Int32

Emplacement de buffer à partir duquel commencer à écrire les données.

count

Int32

Nombre d'octets à écrire dans NetworkStream.

Exceptions

ArgumentNullException

Le paramètre buffer a la valeur null.

ArgumentOutOfRangeException

Le paramètre offset est inférieur à 0.

- ou -

Le paramètre offset est supérieur à la longueur de buffer.

- ou -

Le paramètre size est inférieur à 0.

- ou -

Le paramètre size est supérieur à la longueur de buffer moins la valeur du paramètre offset.

InvalidOperationException

NetworkStream ne prend pas en charge l’écriture.

IOException

Une erreur s’est produite pendant l’accès au socket.

- ou -

Une erreur s'est produite pendant l'écriture sur le réseau.

ObjectDisposedException

Le NetworkStream est fermé.

Exemples

L’exemple de code suivant vérifie si est NetworkStream accessible en écriture. Si c’est le cas Write , est utilisé pour écrire un petit message.

// Examples for CanWrite, and CanWrite
// Check to see if this NetworkStream is writable.
if (myNetworkStream.CanWrite)
{
    byte[] myWriteBuffer = Encoding.ASCII.GetBytes("Are you receiving this message?");
    myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length);
}
else
{
    Console.WriteLine("Sorry.  You cannot write to this NetworkStream.");
}

Remarques

Cette méthode commence au spécifié offset et envoie size des octets du contenu de buffer au réseau. La Write méthode se bloque jusqu’à ce que le nombre d’octets demandé soit envoyé ou qu’un SocketException soit levée.

Note

Vérifiez si est NetworkStream accessible en écriture en appelant la CanWrite propriété . Si vous essayez d’écrire dans un NetworkStream qui n’est pas accessible en écriture, vous obtenez un InvalidOperationException.

Note

Si vous recevez un IOException, case activée la InnerException propriété pour déterminer si elle a été provoquée par un 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 le code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Voir aussi

• CanWrite
• Writeable