NetworkStream.Write Methode

Definitie

Naamruimte:
System.Net.Sockets
Assembly:
netstandard.dll
Assembly:
System.dll
Assembly:
System.Net.Sockets.dll

Overloads

Name Description
Write(ReadOnlySpan<Byte>)

Hiermee schrijft u gegevens naar de NetworkStream gegevens van een bytespanne met het kenmerk Alleen-lezen.
Write(Byte[], Int32, Int32)

Hiermee schrijft u gegevens naar het NetworkStream opgegeven bereik van een bytematrix.

Write(ReadOnlySpan<Byte>)

Hiermee schrijft u gegevens naar de NetworkStream gegevens van een bytespanne met het kenmerk Alleen-lezen.

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

Parameters

buffer
ReadOnlySpan<Byte>

De gegevens die moeten worden geschreven naar de NetworkStream.

Uitzonderingen

InvalidOperationException

Het NetworkStream biedt geen ondersteuning voor schrijven.

IOException

Er is een fout opgetreden bij het openen van de socket.

– of –

Er is een fout opgetreden tijdens het schrijven naar het netwerk.

ObjectDisposedException

De NetworkStream is gesloten.

Opmerkingen

Met deze methode worden alle bytes naar buffer het netwerk verzonden. De Write methode blokkeert totdat het aangevraagde aantal bytes wordt verzonden of er een SocketException wordt gegenereerd.

Note

Controleer of het NetworkStream beschrijfbaar is door de eigenschap aan te CanWrite roepen. Als u probeert te schrijven naar een NetworkStream die niet beschrijfbaar is, krijgt u een InvalidOperationException.

Note

Als u een IOException, controleert u de InnerException eigenschap om te bepalen of deze is veroorzaakt door een SocketException. Als dit het probleem is, gebruikt u de eigenschap ErrorCode om de specifieke foutcode te verkrijgen en raadpleegt u de documentatie over de Windows Sockets versie 2 API-foutcode voor een gedetailleerde beschrijving van de fout.

Van toepassing op

Write(Byte[], Int32, Int32)

Hiermee schrijft u gegevens naar het NetworkStream opgegeven bereik van een bytematrix.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);
public override void Write(byte[] buffer, int offset, int size);
override this.Write : byte[] * int * int -> unit
abstract member 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)

Parameters

buffer
Byte[]

Een matrix van het type Byte dat de gegevens bevat die naar de NetworkStreamgegevens moeten worden geschreven.

offset
Int32

De locatie buffer waar u gegevens wilt gaan schrijven.

size
Int32

Het aantal bytes dat moet worden geschreven naar de NetworkStream.

Uitzonderingen

ArgumentNullException

De buffer parameter is null.

ArgumentOutOfRangeException

De offset parameter is kleiner dan 0.

– of –

De offset parameter is groter dan de lengte van buffer.

– of –

De size parameter is kleiner dan 0.

– of –

De size parameter is groter dan de lengte van buffer min de waarde van de offset parameter.

InvalidOperationException

Het NetworkStream biedt geen ondersteuning voor schrijven.

IOException

Er is een fout opgetreden bij het openen van de socket.

– of –

Er is een fout opgetreden tijdens het schrijven naar het netwerk.

ObjectDisposedException

De NetworkStream is gesloten.

Voorbeelden

In het volgende codevoorbeeld wordt gecontroleerd of het NetworkStream beschrijfbaar is. Als dat zo is, wordt dit Write gebruikt om een klein bericht te schrijven.

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

Opmerkingen

Deze methode begint bij de opgegeven offset en verzendt count bytes van de inhoud naar buffer het netwerk. De Write methode blokkeert totdat het aangevraagde aantal bytes wordt verzonden of er een SocketException wordt gegenereerd.

Note

Controleer of het NetworkStream beschrijfbaar is door de eigenschap aan te CanWrite roepen. Als u probeert te schrijven naar een NetworkStream die niet beschrijfbaar is, krijgt u een InvalidOperationException.

Note

Als u een IOException, controleert u de InnerException eigenschap om te bepalen of deze is veroorzaakt door een SocketException. Als dit het probleem is, gebruikt u de eigenschap ErrorCode om de specifieke foutcode te verkrijgen en raadpleegt u de documentatie over de Windows Sockets versie 2 API-foutcode voor een gedetailleerde beschrijving van de fout.

Zie ook

Van toepassing op