Condividi tramite


TcpClient.ReceiveBufferSize Proprietà

Definizione

Ottiene o imposta la dimensione del buffer di ricezione.

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

Valore della proprietà

Dimensione del buffer di ricezione, espressa in byte. Il valore predefinito è 8192 byte.

Eccezioni

Si è verificato un errore durante l'impostazione delle dimensioni del buffer.

-oppure-

Nelle applicazioni di .NET Compact Framework non è possibile impostare questa proprietà. Per risolvere il problema, vedere la nota sulla piattaforma nella sezione Osservazioni.

Esempio

L'esempio di codice seguente imposta e ottiene le dimensioni del buffer di ricezione.

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

Commenti

La ReceiveBufferSize proprietà ottiene o imposta il numero di byte che si prevede di archiviare nel buffer di ricezione per ogni operazione di lettura. Questa proprietà modifica effettivamente lo spazio del buffer di rete allocato per la ricezione di dati in ingresso.

Il buffer di rete deve essere almeno grande quanto il buffer dell'applicazione per garantire che i dati desiderati siano disponibili quando si chiama il NetworkStream.Read metodo . Utilizzare la ReceiveBufferSize proprietà per impostare questa dimensione. Se l'applicazione riceverà dati in blocco, è necessario passare il Read metodo un buffer dell'applicazione molto grande.

Se il buffer di rete è inferiore alla quantità di dati richiesti nel Read metodo, non sarà possibile recuperare la quantità di dati desiderata in un'operazione di lettura. Ciò comporta il sovraccarico di chiamate aggiuntive al Read metodo .

Si applica a

Vedi anche