TcpClient.ReceiveBufferSize Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property ReceiveBufferSize As IntegerValore 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 .
