NetworkStream.Write Metod

Definition

Namnområde:
System.Net.Sockets
Sammansättning:
netstandard.dll
Sammansättning:
System.dll
Sammansättning:
System.Net.Sockets.dll

Överlagringar

Name Description
Write(ReadOnlySpan<Byte>)

Skriver data till NetworkStream från ett skrivskyddat byteintervall.
Write(Byte[], Int32, Int32)

Skriver data till NetworkStream från ett angivet intervall för en bytematris.

Write(ReadOnlySpan<Byte>)

Skriver data till NetworkStream från ett skrivskyddat byteintervall.

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

Parametrar

buffer
ReadOnlySpan<Byte>

De data som ska skrivas NetworkStreamtill .

Undantag

InvalidOperationException

Stöder NetworkStream inte skrivning.

IOException

Ett fel uppstod vid åtkomst till socketen.

-eller-

Det uppstod ett fel när du skrev till nätverket.

ObjectDisposedException

Är NetworkStream stängd.

Kommentarer

Den här metoden skickar alla byte till buffer nätverket. Metoden Write blockeras tills det begärda antalet byte skickas eller en SocketException genereras.

Note

Kontrollera om NetworkStream är skrivbart genom att anropa egenskapen CanWrite . Om du försöker skriva till en NetworkStream som inte kan skrivas får du en InvalidOperationException.

Note

Om du får en IOExceptionkontrollerar du InnerException egenskapen för att avgöra om den orsakades av en SocketException. I så fall använder du egenskapen ErrorCode för att hämta den specifika felkoden och läser dokumentationen om api-felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

Gäller för

Write(Byte[], Int32, Int32)

Skriver data till NetworkStream från ett angivet intervall för en bytematris.

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)

Parametrar

buffer
Byte[]

En matris av typen Byte som innehåller de data som ska skrivas NetworkStreamtill .

offset
Int32

Den plats buffer där du vill börja skriva data.

size
Int32

Antalet byte som ska skrivas till NetworkStream.

Undantag

ArgumentNullException

Parametern buffer är null.

ArgumentOutOfRangeException

Parametern offset är mindre än 0.

-eller-

Parametern offset är större än längden på buffer.

-eller-

Parametern size är mindre än 0.

-eller-

Parametern size är större än längden buffer på minus värdet för parametern offset .

InvalidOperationException

Stöder NetworkStream inte skrivning.

IOException

Ett fel uppstod vid åtkomst till socketen.

-eller-

Det uppstod ett fel när du skrev till nätverket.

ObjectDisposedException

Är NetworkStream stängd.

Exempel

Följande kodexempel kontrollerar om är NetworkStream skrivbart. Om det är det används det Write för att skriva ett litet meddelande.

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

Kommentarer

Den här metoden börjar vid den angivna offset och skickar count byte från innehållet i buffer nätverket. Metoden Write blockeras tills det begärda antalet byte skickas eller en SocketException genereras.

Note

Kontrollera om NetworkStream är skrivbart genom att anropa egenskapen CanWrite . Om du försöker skriva till en NetworkStream som inte kan skrivas får du en InvalidOperationException.

Note

Om du får en IOExceptionkontrollerar du InnerException egenskapen för att avgöra om den orsakades av en SocketException. I så fall använder du egenskapen ErrorCode för att hämta den specifika felkoden och läser dokumentationen om api-felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

Se även

Gäller för