TcpClient.ReceiveBufferSize Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la taille de la mémoire tampon de réception.
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 IntegerValeur de propriété
Taille de la mémoire tampon de réception en octets. La valeur par défaut est 8 192 octets.
Exceptions
Une erreur s'est produite lors de la définition de la taille de la mémoire tampon.
- ou -
Dans les applications .NET Compact Framework, vous ne pouvez pas définir cette propriété. Pour obtenir une solution de contournement, consultez la partie Remarque sur la plateforme de la section Notes.
Exemples
L’exemple de code suivant définit et obtient la taille de la mémoire tampon de réception.
// 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
Remarques
La ReceiveBufferSize propriété obtient ou définit le nombre d’octets que vous prévoyez de stocker dans la mémoire tampon de réception pour chaque opération de lecture. Cette propriété manipule en fait l’espace tampon réseau alloué à la réception des données entrantes.
Votre mémoire tampon réseau doit être au moins aussi grande que la mémoire tampon de votre application pour vous assurer que les données souhaitées seront disponibles lorsque vous appelez la NetworkStream.Read méthode . Utilisez la ReceiveBufferSize propriété pour définir cette taille. Si votre application reçoit des données en bloc, vous devez passer la Read méthode à une mémoire tampon d’application très volumineuse.
Si la mémoire tampon réseau est inférieure à la quantité de données que vous demandez dans la Read méthode, vous ne pourrez pas récupérer la quantité de données souhaitée en une seule opération de lecture. Cela entraîne une surcharge liée aux appels supplémentaires à la Read méthode .
