NetworkStream.Write Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestawy:

netstandard.dll, System.Net.Sockets.dll

Przeciążenia

Nazwa	Opis
Write(ReadOnlySpan<Byte>)	Zapisuje dane z zakresu bajtów tylko do NetworkStream odczytu.
Write(Byte[], Int32, Int32)	Zapisuje dane z NetworkStream określonego zakresu tablicy bajtów.

Write(ReadOnlySpan<Byte>)

Źródło:

NetworkStream.cs

Zapisuje dane z zakresu bajtów tylko do NetworkStream odczytu.

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

Parametry

buffer

ReadOnlySpan<Byte>

Dane do zapisu w obiekcie NetworkStream.

Wyjątki

InvalidOperationException

Element NetworkStream nie obsługuje pisania.

IOException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

— lub —

Wystąpił błąd podczas zapisywania w sieci.

ObjectDisposedException

Element NetworkStream jest zamknięty.

Uwagi

Ta metoda wysyła wszystkie bajty do buffer sieci. Metoda Write blokuje żądaną liczbę bajtów lub SocketException jest zgłaszana.

Note

Sprawdź, czy NetworkStream właściwość jest zapisywalna, wywołując CanWrite właściwość . Jeśli spróbujesz zapisać w obiekcie NetworkStream , który nie jest zapisywalny, otrzymasz wartość InvalidOperationException.

Note

Jeśli otrzymasz element IOException, sprawdź InnerException właściwość , aby ustalić, czy przyczyną SocketExceptionjest . Jeśli tak, użyj właściwości ErrorCode, aby uzyskać konkretny kod błędu i zapoznaj się z dokumentacją kodu błędu interfejsu API Windows Sockets w wersji 2, aby uzyskać szczegółowy opis błędu.

Write(Byte[], Int32, Int32)

Źródło:

NetworkStream.cs

Zapisuje dane z NetworkStream określonego zakresu tablicy bajtów.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

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

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametry

buffer

Byte[]

Tablica typu Byte zawierająca dane do zapisu w obiekcie NetworkStream.

offset

Int32

Lokalizacja, w buffer której należy rozpocząć zapisywanie danych.

count

Int32

Liczba bajtów do zapisu w obiekcie NetworkStream.

Wyjątki

ArgumentNullException

Parametr buffer jest null.

ArgumentOutOfRangeException

Parametr offset jest mniejszy niż 0.

— lub —

Parametr offset jest większy niż długość parametru buffer.

— lub —

Parametr size jest mniejszy niż 0.

— lub —

Parametr size jest większy niż długość buffer minus wartość parametru offset .

InvalidOperationException

Element NetworkStream nie obsługuje pisania.

IOException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

— lub —

Wystąpił błąd podczas zapisywania w sieci.

ObjectDisposedException

Element NetworkStream jest zamknięty.

Przykłady

Poniższy przykład kodu sprawdza, czy NetworkStream element jest zapisywalny. Jeśli tak jest, jest Write używany do pisania małej wiadomości.

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

Uwagi

Ta metoda rozpoczyna się od określonej offset metody i wysyła bajty count z zawartości buffer do sieci. Metoda Write blokuje żądaną liczbę bajtów lub SocketException jest zgłaszana.

Note

Sprawdź, czy NetworkStream właściwość jest zapisywalna, wywołując CanWrite właściwość . Jeśli spróbujesz zapisać w obiekcie NetworkStream , który nie jest zapisywalny, otrzymasz wartość InvalidOperationException.

Note

Jeśli otrzymasz element IOException, sprawdź InnerException właściwość , aby ustalić, czy przyczyną SocketExceptionjest . Jeśli tak, użyj właściwości ErrorCode, aby uzyskać konkretny kod błędu i zapoznaj się z dokumentacją kodu błędu interfejsu API Windows Sockets w wersji 2, aby uzyskać szczegółowy opis błędu.

Zobacz też

• CanWrite
• Writeable