TcpClient.Available Propriété

Définition

Espace de noms:
System.Net.Sockets
Assembly:
System.dll
Assembly:
System.Net.Sockets.dll
Assembly:
netstandard.dll

Obtient la quantité de données qui ont été reçues du réseau et qui sont disponibles pour être lues.

public:
 property int Available { int get(); };
public int Available { get; }
member this.Available : int
Public ReadOnly Property Available As Integer

Valeur de propriété

Int32

Nombre d’octets de données reçues du réseau et disponibles pour être lues.

Exceptions

SocketException

Une erreur s’est produite lors de la tentative d’accès au socket.

ObjectDisposedException

Il Socket a été fermé.

Exemples

L’exemple de code suivant montre l’utilisation de la Available propriété.

static void GetAvailable()
{
    // Find out how many bytes are ready to be read.
    Console.WriteLine("Available value is {0}", t.Available);
}

Remarques

La Available propriété est un moyen de déterminer si les données sont mises en file d’attente pour la lecture. Si des données sont disponibles, appelez Read pour obtenir les données. Les données disponibles sont la quantité totale de données mises en file d’attente dans la mémoire tampon réseau pour la lecture. Si aucune donnée n’est mise en file d’attente dans la mémoire tampon réseau, Available retourne 0.

Si l’hôte distant arrête ou ferme la connexion, Available peut lever un SocketException. Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

S’applique à