TcpClient.Available 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 la quantité de données reçues du réseau et disponibles pour la lecture.
public:
property int Available { int get(); };
public int Available { get; }
member this.Available : int
Public ReadOnly Property Available As Integer
Valeur de propriété
Nombre d'octets de données reçus du réseau et disponibles pour la lecture.
Exceptions
Une erreur s’est produite pendant la tentative d’accès au socket.
Socket a été fermé.
Exemples
L’exemple de code suivant montre l’utilisation de la Available
propriété .
static void GetAvailable( TcpClient^ t )
{
// Find out how many bytes are ready to be read.
Console::WriteLine( "Available value is {0}", t->Available.ToString() );
;
}
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é permet de déterminer si les données sont mises en file d’attente pour 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 s’arrête ou ferme la connexion, Available
peut lever un SocketException. Si vous recevez un SocketException
, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.