NetworkStream.Write Méthode

Définition

Espace de noms:
System.Net.Sockets
Assembly:
netstandard.dll
Assembly:
System.dll
Assembly:
System.Net.Sockets.dll

Surcharges

Nom Description
Write(ReadOnlySpan<Byte>)

Écrit des données à NetworkStream partir d’une étendue d’octets en lecture seule.
Write(Byte[], Int32, Int32)

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

Write(ReadOnlySpan<Byte>)

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

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);
public override void Write(ReadOnlySpan<byte> buffer);
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Paramètres

buffer
ReadOnlySpan<Byte>

Données à écrire dans le NetworkStream.

Exceptions

InvalidOperationException

Il NetworkStream ne prend pas en charge l’écriture.

IOException

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.

ObjectDisposedException

La NetworkStream fermeture est terminée.

Remarques

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

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 à

Write(Byte[], Int32, Int32)

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

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);
public override void Write(byte[] buffer, int offset, int size);
override this.Write : byte[] * int * int -> unit
abstract member Write : byte[] * int * int -> unit
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)

Paramètres

buffer
Byte[]

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

offset
Int32

Emplacement dans buffer lequel commencer l’écriture de données.

size
Int32

Nombre d’octets à écrire dans le NetworkStream.

Exceptions

ArgumentNullException

Le buffer paramètre est null.

ArgumentOutOfRangeException

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.

InvalidOperationException

Il NetworkStream ne prend pas en charge l’écriture.

IOException

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.

ObjectDisposedException

La NetworkStream fermeture est terminée.

Exemples

L’exemple de code suivant vérifie si l’écriture NetworkStream est accessible en écriture. Si c’est le cas, Write il 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.");
}

' Examples for CanWrite, and CanWrite  
' Check to see if this NetworkStream is writable.
If myNetworkStream.CanWrite Then
   
   Dim myWriteBuffer As Byte() = Encoding.ASCII.GetBytes("Are you receiving this message?")
   myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length)
Else
   Console.WriteLine("Sorry.  You cannot write to this NetworkStream.")
End If

Remarques

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

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.

Voir aussi

S’applique à