Freigeben über


TcpClient.Available Eigenschaft

Definition

Ruft die Datenmenge ab, die über das Netzwerk empfangen wurde und gelesen werden kann.

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

Eigenschaftswert

Die Anzahl der Datenbytes, die vom Netzwerk empfangen wurden und zum Lesen zur Verfügung stehen.

Ausnahmen

Fehler beim Versuch, auf den Socket zuzugreifen.

Der Socket wurde geschlossen.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der Available -Eigenschaft.

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);
}

Hinweise

Die Available -Eigenschaft ist eine Möglichkeit, zu bestimmen, ob Daten zum Lesen in eine Warteschlange gestellt werden. Wenn Daten verfügbar sind, rufen Sie auf Read , um die Daten abzurufen. Die verfügbaren Daten sind die Gesamtmenge der Daten, die zum Lesen im Netzwerkpuffer in die Warteschlange gestellt werden. Wenn keine Daten im Netzwerkpuffer in die Warteschlange eingereiht sind, Available wird 0 zurückgegeben.

Wenn der Remotehost die Verbindung herunterfährt oder schließt, Available wird möglicherweise ein SocketExceptionausgelöst. Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 .

Gilt für: