NetworkStream.Write Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

Overload

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 untuk menulis 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 sampai jumlah byte yang diminta dikirim atau SocketException dilemparkan.

Catatan

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

Catatan

Jika Anda menerima IOException, periksa InnerException properti untuk menentukan apakah itu disebabkan oleh SocketException. Jika demikian, gunakan ErrorCode properti untuk mendapatkan kode kesalahan tertentu dan lihat dokumentasi kode kesalahan WINDOWS Sockets versi 2 API 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 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 minus 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 )
{
   array<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)
{
    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 yang ditentukan offset dan mengirim size byte dari konten buffer ke jaringan. Metode Write memblokir sampai jumlah byte yang diminta dikirim atau SocketException dilemparkan.

Catatan

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

Catatan

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

Lihat juga

• CanWrite
• Writeable