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 Sockets 版本 2 的 API 錯誤程式碼 文件,了解錯誤的詳細說明。