TcpClient.ReceiveBufferSize Propriété

Définition

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, set
Public Property ReceiveBufferSize As Integer

Valeur 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 .

S’applique à

Voir aussi