TcpClient.ReceiveBufferSize Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net.Sockets
Zestaw:
System.Net.Sockets.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Źródło:
TCPClient.cs

Pobiera lub ustawia rozmiar buforu odbierania.

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

Wartość właściwości

Int32

Rozmiar buforu odbierania w bajtach. Wartość domyślna to 8192 bajty.

Wyjątki

SocketException

Wystąpił błąd podczas ustawiania rozmiaru buforu.

-lub-

W aplikacjach programu .NET Compact Framework nie można ustawić tej właściwości. Aby obejść ten problem, zobacz Uwagi dotyczące platformy w temacie Uwagi.

Przykłady

Poniższy przykładowy kod ustawia i pobiera rozmiar buforu odbierania.

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

Uwagi

Właściwość ReceiveBufferSize pobiera lub ustawia liczbę bajtów, które mają być przechowywane w buforze odbierania dla każdej operacji odczytu. Ta właściwość rzeczywiście manipuluje przestrzenią buforu sieciowego przydzieloną do odbierania danych przychodzących.

Bufor sieciowy powinien być co najmniej tak duży, jak bufor aplikacji, aby upewnić się, że żądane dane będą dostępne podczas wywoływania NetworkStream.Read metody. Użyj właściwości , ReceiveBufferSize aby ustawić ten rozmiar. Jeśli aplikacja będzie odbierać dane zbiorcze, należy przekazać Read metodę bardzo duży bufor aplikacji.

Jeśli bufor sieciowy jest mniejszy niż ilość żądanych danych w Read metodzie, nie będzie można pobrać żądanej ilości danych w jednej operacji odczytu. Wiąże się to z obciążeniem dodatkowych wywołań Read metody .

Dotyczy

Zobacz też