NetworkStream.Write Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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.