NetworkStream.Write Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

netstandard.dll, System.Net.Sockets.dll

Overload

Nama	Deskripsi
Write(ReadOnlySpan<Byte>)	Menulis data ke NetworkStream dari rentang byte baca-saja.
Write(Byte[], Int32, Int32)	Menulis data ke NetworkStream dari rentang array byte yang ditentukan.

Write(ReadOnlySpan<Byte>)

Sumber:

NetworkStream.cs

Menulis data ke NetworkStream dari rentang byte baca-saja.

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

Parameter

buffer

ReadOnlySpan<Byte>

Data yang akan ditulis ke NetworkStream.

Pengecualian

InvalidOperationException

NetworkStream Tidak mendukung penulisan.

IOException

Terjadi kesalahan saat mengakses soket.

-atau-

Terjadi kegagalan saat menulis ke jaringan.

ObjectDisposedException

Sudah NetworkStream ditutup.

Keterangan

Metode ini mengirimkan semua byte buffer ke jaringan. Metode Write memblokir hingga jumlah byte yang SocketException diminta dikirim atau dilemparkan.

Note

Periksa untuk melihat apakah NetworkStream dapat ditulis dengan memanggil CanWrite properti . Jika Anda mencoba menulis ke yang NetworkStream tidak dapat ditulis, Anda akan mendapatkan InvalidOperationException.

Note

Jika Anda menerima IOException, periksa InnerException properti untuk menentukan apakah itu disebabkan oleh SocketException. Jika demikian, gunakan properti ErrorCode untuk mendapatkan kode kesalahan tertentu dan lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Write(Byte[], Int32, Int32)

Sumber:

NetworkStream.cs

Menulis data ke NetworkStream dari rentang array byte yang ditentukan.

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)

Parameter

buffer

Byte[]

Array jenis Byte yang berisi data untuk ditulis ke NetworkStream.

offset

Int32

Lokasi tempat buffer untuk mulai menulis data.

count

Int32

Jumlah byte yang akan ditulis ke NetworkStream.

Pengecualian

ArgumentNullException

Parameternya buffer adalah null.

ArgumentOutOfRangeException

Parameternya offset kurang dari 0.

-atau-

Parameter offset lebih besar dari panjang buffer.

-atau-

Parameternya size kurang dari 0.

-atau-

Parameter size lebih besar dari panjang buffer dikurangi nilai offset parameter.

InvalidOperationException

NetworkStream Tidak mendukung penulisan.

IOException

Terjadi kesalahan saat mengakses soket.

-atau-

Terjadi kegagalan saat menulis ke jaringan.

ObjectDisposedException

Sudah NetworkStream ditutup.

Contoh

Contoh kode berikut memeriksa untuk melihat apakah NetworkStream dapat ditulis. Jika ya, maka Write digunakan untuk menulis pesan kecil.

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

Keterangan

Metode ini dimulai pada byte yang ditentukan offset dan mengirim count byte dari konten buffer ke jaringan. Metode Write memblokir hingga jumlah byte yang SocketException diminta dikirim atau dilemparkan.

Note

Periksa untuk melihat apakah NetworkStream dapat ditulis dengan memanggil CanWrite properti . Jika Anda mencoba menulis ke yang NetworkStream tidak dapat ditulis, Anda akan mendapatkan InvalidOperationException.

Note

Jika Anda menerima IOException, periksa InnerException properti untuk menentukan apakah itu disebabkan oleh SocketException. Jika demikian, gunakan properti ErrorCode untuk mendapatkan kode kesalahan tertentu dan lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Lihat juga

• CanWrite
• Writeable