NetworkStream.Write Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

netstandard.dll, System.Net.Sockets.dll

Přetížení

Name	Description
Write(ReadOnlySpan<Byte>)	Zapisuje data z bajtového rozsahu NetworkStream jen pro čtení.
Write(Byte[], Int32, Int32)	Zapisuje data do NetworkStream zadané oblasti bajtového pole.

Write(ReadOnlySpan<Byte>)

Zdroj:

NetworkStream.cs

Zapisuje data z bajtového rozsahu NetworkStream jen pro čtení.

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>

Data, která se mají zapisovat do souboru NetworkStream.

Výjimky

InvalidOperationException

Nepodporuje NetworkStream psaní.

IOException

Při přístupu k soketu došlo k chybě.

nebo

Při zápisu do sítě došlo k chybě.

ObjectDisposedException

To NetworkStream je uzavřeno.

Poznámky

Tato metoda odesílá do sítě všechny bajty buffer . Metoda Write blokuje, dokud se odešle požadovaný počet bajtů nebo se SocketException vyvolá.

Note

Zkontrolujte, jestli NetworkStream je zapisovatelná voláním CanWrite vlastnosti. Pokud se pokusíte napsat na NetworkStream to, který není zapisovatelný, dostanete .InvalidOperationException

Note

Pokud obdržíte , IOExceptionzkontrolujte InnerException vlastnost a zjistěte, zda byla způsobena SocketException. Pokud ano, použijte vlastnost ErrorCode k získání konkrétního kódu chyby a v dokumentaci k chybě rozhraní API Windows Sockets verze 2 vyhledejte podrobný popis chyby.

Write(Byte[], Int32, Int32)

Zdroj:

NetworkStream.cs

Zapisuje data do NetworkStream zadané oblasti bajtového pole.

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[]

Pole typu Byte obsahující data, která se mají zapisovat do objektu NetworkStream.

offset

Int32

Umístění, ze buffer kterého chcete začít zapisovat data.

count

Int32

Počet bajtů, které se mají zapisovat do NetworkStream.

Výjimky

ArgumentNullException

Parametr buffer je null.

ArgumentOutOfRangeException

Parametr offset je menší než 0.

nebo

Parametr offset je větší než délka buffer.

nebo

Parametr size je menší než 0.

nebo

Parametr size je větší než délka buffer mínus hodnoty parametru offset .

InvalidOperationException

Nepodporuje NetworkStream psaní.

IOException

Při přístupu k soketu došlo k chybě.

nebo

Při zápisu do sítě došlo k chybě.

ObjectDisposedException

To NetworkStream je uzavřeno.

Příklady

Následující příklad kódu zkontroluje, zda NetworkStream je zapisovatelný. Pokud ano, použije Write se k napsání malé zprávy.

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

Poznámky

Tato metoda začíná na zadaném offset a odesílá count bajty z obsahu buffer sítě. Metoda Write blokuje, dokud se odešle požadovaný počet bajtů nebo se SocketException vyvolá.

Note

Zkontrolujte, jestli NetworkStream je zapisovatelná voláním CanWrite vlastnosti. Pokud se pokusíte napsat na NetworkStream to, který není zapisovatelný, dostanete .InvalidOperationException

Note

Pokud obdržíte , IOExceptionzkontrolujte InnerException vlastnost a zjistěte, zda byla způsobena SocketException. Pokud ano, použijte vlastnost ErrorCode k získání konkrétního kódu chyby a v dokumentaci k chybě rozhraní API Windows Sockets verze 2 vyhledejte podrobný popis chyby.

Viz také

• CanWrite
• Writeable