Teilen über


NetworkStream.Write Methode

Definition

Ü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
Quelle:
NetworkStream.cs
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

NetworkStream unterstützt keine Schreibvorgänge.

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

- oder -

Beim Schreiben in das Netzwerk ist ein Fehler aufgetreten.

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.

Gilt für:

Write(Byte[], Int32, Int32)

Quelle:
NetworkStream.cs
Quelle:
NetworkStream.cs
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 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)

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.

sizecount
Int32

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

Ausnahmen

Der buffer-Parameter ist null.

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.

NetworkStream unterstützt keine Schreibvorgänge.

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

- oder -

Beim Schreiben in das Netzwerk ist ein Fehler aufgetreten.

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

Gilt für: