TcpClient.Available プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ネットワークから受信され、読み取ることができるデータの量を取得します。
public:
property int Available { int get(); };
public int Available { get; }
member this.Available : int
Public ReadOnly Property Available As Integer
プロパティ値
ネットワークから受信し、読み取ることができるデータのバイト数。
例外
ソケットにアクセスしようとしたときにエラーが発生しました。
Socketが閉じられました。
例
次のコード例は、 Available プロパティの使用方法を示しています。
static void GetAvailable()
{
// Find out how many bytes are ready to be read.
Console.WriteLine("Available value is {0}", t.Available);
}
注釈
Available プロパティは、データが読み取り用にキューに登録されているかどうかを判断する方法です。 データが使用可能な場合は、 Read を呼び出してデータを取得します。 使用可能なデータは、読み取り用にネットワーク バッファーにキューに格納されているデータの合計量です。 ネットワーク バッファーにデータがキューに入っていない場合、 Available は 0 を返します。
リモート ホストが接続をシャットダウンまたは閉じると、 Available は SocketExceptionをスローする可能性があります。
SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得した後、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。