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
| Name | Beschreibung |
|---|---|
| Write(ReadOnlySpan<Byte>) |
Schreibt Daten aus einer schreibgeschützten Bytespanne in die NetworkStream Daten. |
| Write(Byte[], Int32, Int32) |
Schreibt Daten aus einem angegebenen Bereich eines Bytearrays in den NetworkStream angegebenen Bereich. |
Write(ReadOnlySpan<Byte>)
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
Schreibt Daten aus einer schreibgeschützten Bytespanne in die NetworkStream Daten.
public:
override void Write(ReadOnlySpan<System::Byte> buffer);public override void Write(ReadOnlySpan<byte> buffer);override this.Write : ReadOnlySpan<byte> -> unitPublic Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))Parameter
- buffer
- ReadOnlySpan<Byte>
Die zu schreibenden Daten in die NetworkStream.
Ausnahmen
Das NetworkStream Schreiben wird nicht unterstützt.
Das NetworkStream ist geschlossen.
Hinweise
Diese Methode sendet alle Bytes an buffer das Netzwerk. Die Write Methode blockiert, bis die angeforderte Anzahl von Bytes gesendet wird oder ein SocketException Fehler ausgelöst wird.
Note
Überprüfen Sie, ob die NetworkStream Eigenschaft schreibbar CanWrite ist. Wenn Sie versuchen, in ein nicht beschreibbares NetworkStream Schreiben zu schreiben, erhalten Sie eine InvalidOperationException.
Note
Wenn Sie eine IOExceptionEigenschaft erhalten, überprüfen Sie die InnerException Eigenschaft, um zu ermitteln, ob sie durch eine SocketException. Wenn ja, verwenden Sie die ErrorCode-Eigenschaft, um den spezifischen Fehlercode abzurufen, und verweisen Sie auf die Windows Sockets Version 2-API-Fehlercodedokumentation, um eine detaillierte Beschreibung des Fehlers zu erhalten.
Gilt für:
Write(Byte[], Int32, Int32)
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
- Quelle:
- NetworkStream.cs
Schreibt Daten aus einem angegebenen Bereich eines Bytearrays in den NetworkStream angegebenen Bereich.
public:
override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);public:
override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);public override void Write(byte[] buffer, int offset, int count);public override void Write(byte[] buffer, int offset, int size);override this.Write : byte[] * int * int -> unitoverride this.Write : byte[] * int * int -> unitPublic Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)Public Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)Parameter
- buffer
- Byte[]
Ein Array vom Typ Byte , das die zu schreibenden NetworkStreamDaten enthält.
- offset
- Int32
Der Speicherort buffer , von dem aus mit dem Schreiben von Daten begonnen werden soll.
- countsize
- Int32
Die Anzahl der Bytes, die in das NetworkStreamGeschrieben 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 minus buffer des Werts des offset Parameters.
Das NetworkStream Schreiben wird nicht unterstützt.
Das NetworkStream ist geschlossen.
Beispiele
Im folgenden Codebeispiel wird überprüft, ob die NetworkStream Schreibfunktion möglich ist. Wenn dies der Vorgang ist, Write wird zum Schreiben einer kleinen Nachricht verwendet.
// 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 der angegebenen offset Methode und sendet count Bytes aus dem Inhalt des buffer Netzwerks. Die Write Methode blockiert, bis die angeforderte Anzahl von Bytes gesendet wird oder ein SocketException Fehler ausgelöst wird.
Note
Überprüfen Sie, ob die NetworkStream Eigenschaft schreibbar CanWrite ist. Wenn Sie versuchen, in ein nicht beschreibbares NetworkStream Schreiben zu schreiben, erhalten Sie eine InvalidOperationException.
Note
Wenn Sie eine IOExceptionEigenschaft erhalten, überprüfen Sie die InnerException Eigenschaft, um zu ermitteln, ob sie durch eine SocketException. Wenn ja, verwenden Sie die ErrorCode-Eigenschaft, um den spezifischen Fehlercode abzurufen, und verweisen Sie auf die Windows Sockets Version 2-API-Fehlercodedokumentation, um eine detaillierte Beschreibung des Fehlers zu erhalten.
