NetworkStream.Write-Methode

Artikel
08/20/2007

Schreibt Daten in den NetworkStream.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overrides Sub Write ( _
    buffer As Byte(), _
    offset As Integer, _
    size As Integer _
)
'Usage
Dim instance As NetworkStream
Dim buffer As Byte()
Dim offset As Integer
Dim size As Integer

instance.Write(buffer, offset, size)

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

public:
virtual void Write (
    array<unsigned char>^ buffer, 
    int offset, 
    int size
) override

public void Write (
    byte[] buffer, 
    int offset, 
    int size
)

public override function Write (
    buffer : byte[], 
    offset : int, 
    size : int
)

Parameter

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

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

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

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	buffer ist NULL (Nothing in Visual Basic).
ArgumentOutOfRangeException	offset ist kleiner als 0. - oder - offset ist größer als die Länge von buffer. - oder - size ist kleiner als 0. - oder - size ist größer als die Länge von buffer minus dem Wert des offset-Parameters.
IOException	Beim Schreiben in das Netzwerk ist ein Fehler aufgetreten. – oder – Fehler beim Zugriff auf den Socket. Weitere Informationen finden Sie im Abschnitt Hinweise.
ObjectDisposedException	Der NetworkStream ist geschlossen. - oder - Beim Lesen aus dem Netzwerk ist ein Fehler aufgetreten.

Hinweise

Die Write-Methode beginnt beim angegebenen offset und sendet size Bytes des Inhalts von buffer an das Netzwerk. Die Write-Methode wird blockiert, bis die angeforderte Anzahl von Bytes gesendet wurde oder eine SocketException ausgelöst wird. Wenn Sie eine SocketException erhalten, verwenden Sie die SocketException.ErrorCode-Eigenschaft, um den spezifischen Fehlercode abzurufen. In MSDN finden Sie in der Dokumentation zu API-Fehlercodes unter Windows Sockets, Version 2, eine ausführliche Beschreibung des Fehlers.

Hinweis

Überprüfen Sie über einen Zugriff auf die CanWrite-Eigenschaft, ob in den NetworkStream geschrieben werden kann. Wenn Sie versuchen, Daten in einen schreibgeschützten NetworkStream zu schreiben, wird eine IOException ausgelöst. Wenn Sie eine IOException erhalten, überprüfen Sie die InnerException-Eigenschaft, um zu bestimmen, ob die Ausnahme von einer SocketException verursacht wurde.

Beispiel

Im folgenden Codebeispiel wird überprüft, ob in den NetworkStream geschrieben werden kann. In diesem Fall wird mit Write eine kurze Meldung geschrieben.

' 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

           
// 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.");  
}

// Check to see if this NetworkStream is writable.
if (myNetworkStream.get_CanWrite()) {
    ubyte myWriteBuffer[] = Encoding.get_ASCII().
        GetBytes("Are you receiving this message?");
    myNetworkStream.Write(myWriteBuffer, 0, 
        myWriteBuffer.get_Length());
}
else {
    Console.WriteLine("Sorry.  You cannot write to this "
        + "NetworkStream.");
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

NetworkStream-Klasse
NetworkStream-Member
System.Net.Sockets-Namespace
CanWrite
Writeable

Freigeben über