TcpClient.ReceiveBufferSize Properti

Referensi

Definisi

Ruang nama:: System.Net.Sockets

Rakitan:: System.Net.Sockets.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: TCPClient.cs

Sumber:: TCPClient.cs

Sumber:: TCPClient.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur ukuran buffer penerima.

public:
 property int ReceiveBufferSize { int get(); void set(int value); };

public int ReceiveBufferSize { get; set; }

member this.ReceiveBufferSize : int with get, set

Public Property ReceiveBufferSize As Integer

Nilai Properti

Int32

Ukuran buffer penerima, dalam byte. Nilai defaultnya adalah 8192 byte.

Pengecualian

SocketException

Terjadi kesalahan saat menyetel ukuran buffer.

-atau-

Dalam aplikasi .NET Compact Framework, Anda tidak dapat mengatur properti ini. Untuk solusinya, lihat Catatan Platform di Keterangan.

Contoh

Contoh kode berikut mengatur dan mendapatkan ukuran buffer penerima.

// sets the receive buffer size using the ReceiveBufferSize public property.
tcpClient->ReceiveBufferSize = 1024;

// gets the receive buffer size using the ReceiveBufferSize public property.
if ( tcpClient->ReceiveBufferSize == 1024 )
      Console::WriteLine( "The receive buffer was successfully set to {0}", tcpClient->ReceiveBufferSize );

// Sets the receive buffer size using the ReceiveBufferSize public property.
tcpClient.ReceiveBufferSize = 1024;

// Gets the receive buffer size using the ReceiveBufferSize public property.
if (tcpClient.ReceiveBufferSize == 1024)
    Console.WriteLine ("The receive buffer was successfully set to " + tcpClient.ReceiveBufferSize.ToString ());

' Sets the receive buffer size using the ReceiveBufferSize public property.
tcpClient.ReceiveBufferSize = 1024

' Gets the receive buffer size using the ReceiveBufferSize public property.
If tcpClient.ReceiveBufferSize = 1024 Then
   Console.WriteLine(("The receive buffer was successfully set to " + tcpClient.ReceiveBufferSize.ToString()))
End If

Keterangan

Properti ReceiveBufferSize mendapatkan atau mengatur jumlah byte yang Anda harapkan untuk disimpan di buffer penerima untuk setiap operasi baca. Properti ini benar-benar memanipulasi ruang buffer jaringan yang dialokasikan untuk menerima data masuk.

Buffer jaringan Anda harus setidaknya sebesar buffer aplikasi Anda untuk memastikan bahwa data yang diinginkan akan tersedia saat Anda memanggil NetworkStream.Read metode . ReceiveBufferSize Gunakan properti untuk mengatur ukuran ini. Jika aplikasi Anda akan menerima data massal, Anda harus meneruskan Read metode buffer aplikasi yang sangat besar.

Jika buffer jaringan lebih kecil dari jumlah data yang Anda minta dalam metode , Read Anda tidak akan dapat mengambil jumlah data yang diinginkan dalam satu operasi baca. Ini menimbulkan overhead panggilan tambahan ke Read metode .

Berlaku untuk

Bagikan melalui