NetworkStream.Write Metódus

Definíció

Névtér:

System.Net.Sockets

Szerelvények:

netstandard.dll, System.Net.Sockets.dll

Túlterhelések

Name	Description
Write(ReadOnlySpan<Byte>)	Írási adatok írása írásvédett NetworkStream bájttartományból.
Write(Byte[], Int32, Int32)	Adatokat ír egy NetworkStream bájttömb megadott tartományából.

Write(ReadOnlySpan<Byte>)

Forrás:

NetworkStream.cs

Írási adatok írása írásvédett NetworkStream bájttartományból.

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

Paraméterek

buffer

ReadOnlySpan<Byte>

A .NetworkStream

Kivételek

InvalidOperationException

Ez NetworkStream nem támogatja az írást.

IOException

Hiba történt a szoftvercsatorna elérésekor.

-vagy-

Hiba történt a hálózatba való írás közben.

ObjectDisposedException

A NetworkStream lezárva.

Megjegyzések

Ez a metódus az összes bájtot elküldi buffer a hálózatnak. A Write metódus letiltja a kért bájtok küldését vagy SocketException eldobását.

Note

Ellenőrizze, hogy a NetworkStream tulajdonság meghívásával írható-e.CanWrite Ha olyanba próbál írni NetworkStream , amely nem írható, kap egy InvalidOperationException.

Note

Ha kap egy tulajdonságot IOException, ellenőrizze a InnerException tulajdonságot annak megállapításához, hogy a tulajdonságot egy SocketException. Ha igen, a ErrorCode tulajdonsággal szerezze be az adott hibakódot, és a hiba részletes leírásához tekintse meg a Windows Sockets 2-es verziójának API hibakóddokumentációját.

Write(Byte[], Int32, Int32)

Forrás:

NetworkStream.cs

Adatokat ír egy NetworkStream bájttömb megadott tartományából.

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)

Paraméterek

buffer

Byte[]

Olyan típusú Byte tömb, amely tartalmazza a beírandó NetworkStreamadatokat.

offset

Int32

Az a hely buffer , ahonnan az adatok írása elkezdhető.

count

Int32

A beírandó NetworkStreambájtok száma.

Kivételek

ArgumentNullException

A buffer paraméter a következő null: .

ArgumentOutOfRangeException

A offset paraméter kisebb, mint 0.

-vagy-

A offset paraméter nagyobb, mint a hossza buffer.

-vagy-

A size paraméter kisebb, mint 0.

-vagy-

A size paraméter nagyobb, mint a paraméter értékének bufferoffset mínusz hossza.

InvalidOperationException

Ez NetworkStream nem támogatja az írást.

IOException

Hiba történt a szoftvercsatorna elérésekor.

-vagy-

Hiba történt a hálózatba való írás közben.

ObjectDisposedException

A NetworkStream lezárva.

Példák

Az alábbi példakód ellenőrzi, hogy a NetworkStream kód írható-e. Ha igen, akkor Write egy kis üzenet írására szolgál.

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

Megjegyzések

Ez a metódus a megadott offset időponttól indul, és bájtokat küld count a hálózat tartalmából buffer . A Write metódus letiltja a kért bájtok küldését vagy SocketException eldobását.

Note

Ellenőrizze, hogy a NetworkStream tulajdonság meghívásával írható-e.CanWrite Ha olyanba próbál írni NetworkStream , amely nem írható, kap egy InvalidOperationException.

Note

Ha kap egy tulajdonságot IOException, ellenőrizze a InnerException tulajdonságot annak megállapításához, hogy a tulajdonságot egy SocketException. Ha igen, a ErrorCode tulajdonsággal szerezze be az adott hibakódot, és a hiba részletes leírásához tekintse meg a Windows Sockets 2-es verziójának API hibakóddokumentációját.

Lásd még

• CanWrite
• Writeable