NetworkStream.Write Méthode

  • Référence

Définition

Espace de noms:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
netstandard.dll
Assembly:
System.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
Source:
NetworkStream.cs
Source:
NetworkStream.cs

Écrit des données dans le 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

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.

Notes

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.

Notes

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.

S’applique à

Write(Byte[], Int32, Int32)

Source:
NetworkStream.cs
Source:
NetworkStream.cs
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(cli::array <System::Byte> ^ buffer, int offset, int size);
public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write (byte[] buffer, int offset, int size);
public override void Write (byte[] buffer, int offset, int count);
override this.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)
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

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.

sizecount
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 )
{
   array<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)
{
    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 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.

Notes

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.

Notes

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

S’applique à