NetworkStream.Write Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Überlädt

Write(ReadOnlySpan<Byte>)	Schreibt Daten aus einer schreibgeschützten Bytespanne in die NetworkStream .
Write(Byte[], Int32, Int32)	Schreibt Daten aus einem festgelegten Bereich eines Bytearrays in NetworkStream.

Write(ReadOnlySpan<Byte>)

Quelle:

NetworkStream.cs

Schreibt Daten aus einer schreibgeschützten Bytespanne in die NetworkStream .

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))

Parameter

buffer

ReadOnlySpan<Byte>

Die Daten, die in NetworkStream geschrieben werden sollen.

Ausnahmen

InvalidOperationException

NetworkStream unterstützt keine Schreibvorgänge.

IOException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

- oder -

Beim Schreiben in das Netzwerk ist ein Fehler aufgetreten.

ObjectDisposedException

Der NetworkStream ist geschlossen.

Hinweise

Diese Methode sendet alle Bytes an buffer das Netzwerk. Die Write -Methode blockiert, bis die angeforderte Anzahl von Bytes gesendet oder ein SocketException ausgelöst wird.

Hinweis

Überprüfen Sie, ob der NetworkStream beschreibbar ist, indem Sie die CanWrite -Eigenschaft aufrufen. Wenn Sie versuchen, in eine NetworkStream zu schreiben, die nicht beschreibbar ist, erhalten Sie eine InvalidOperationException.

Hinweis

Wenn Sie eine IOExceptionerhalten, überprüfen Sie die InnerException -Eigenschaft, um zu ermitteln, ob sie durch ein SocketExceptionverursacht wurde. Wenn ja, verwenden Sie die ErrorCode -Eigenschaft, um den spezifischen Fehlercode abzurufen. Eine ausführliche Beschreibung des Fehlers finden Sie in der Dokumentation zum API-Code der Windows Sockets Version 2.

Write(Byte[], Int32, Int32)

Quelle:

NetworkStream.cs

Schreibt Daten aus einem festgelegten Bereich eines Bytearrays in NetworkStream.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

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

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parameter

buffer

Byte[]

Ein Array vom Typ Byte, das die Daten enthält, die in den NetworkStream geschrieben werden sollen.

offset

Int32

Die Position im buffer, an der mit dem Schreiben von Daten begonnen werden soll.

count

Int32

Die Anzahl der Bytes, die in den NetworkStream geschrieben werden sollen.

Ausnahmen

ArgumentNullException

Der buffer-Parameter ist null.

ArgumentOutOfRangeException

Der offset-Parameter ist kleiner als 0.

- oder -

Der offset-Parameter ist größer als die Länge von buffer.

- oder -

Der size-Parameter ist kleiner als 0.

- oder -

Der size-Parameter ist größer als die Länge von buffer abzüglich des Werts des offset-Parameters.

InvalidOperationException

NetworkStream unterstützt keine Schreibvorgänge.

IOException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

- oder -

Beim Schreiben in das Netzwerk ist ein Fehler aufgetreten.

ObjectDisposedException

Der NetworkStream ist geschlossen.

Beispiele

Im folgenden Codebeispiel wird überprüft, ob der NetworkStream beschreibbar ist. Wenn dies der Write Grund ist, wird zum Schreiben einer kleinen Nachricht verwendet.

// 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

Hinweise

Diese Methode beginnt bei dem angegebenen offset und sendet size Bytes aus dem Inhalt von buffer an das Netzwerk. Die Write -Methode blockiert, bis die angeforderte Anzahl von Bytes gesendet oder ein SocketException ausgelöst wird.

Hinweis

Überprüfen Sie, ob der NetworkStream beschreibbar ist, indem Sie die CanWrite -Eigenschaft aufrufen. Wenn Sie versuchen, in eine NetworkStream zu schreiben, die nicht beschreibbar ist, erhalten Sie eine InvalidOperationException.

Hinweis

Wenn Sie eine IOExceptionerhalten, überprüfen Sie die InnerException -Eigenschaft, um zu ermitteln, ob sie durch ein SocketExceptionverursacht wurde. Wenn ja, verwenden Sie die ErrorCode -Eigenschaft, um den spezifischen Fehlercode abzurufen. Eine ausführliche Beschreibung des Fehlers finden Sie in der Dokumentation zum API-Code der Windows Sockets Version 2.

Weitere Informationen

• CanWrite
• Writeable