TcpClient.Available 屬性

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Sockets.dll

來源:

TCPClient.cs

取得已從網路接收且可供讀取的資料量。

public:
 property int Available { int get(); };

public int Available { get; }

member this.Available : int

Public ReadOnly Property Available As Integer

屬性值

Int32

從網路收到的和可供讀取的資料位元組數。

例外狀況

SocketException

嘗試存取通訊端時發生錯誤。

ObjectDisposedException

Socket 已關閉。

範例

下列程式代碼範例示範 如何使用 Available 屬性。

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

備註

屬性 Available 是判斷數據是否排入佇列以供讀取的方法。 如果有數據可用，請呼叫 Read 以取得數據。 可用的數據是網路緩衝區中排入佇列以供讀取的數據總數。 如果網路緩衝區中沒有任何數據排入佇列，則 Available 傳回 0。

如果遠端主機關閉或關閉連線， Available 可能會擲回 SocketException。 如果您收到 SocketException，請使用 SocketException.ErrorCode 來取得特定的錯誤碼。 取得此程式代碼之後，您可以參閱 Windows Sockets 第 2 版 API 錯誤碼 檔，以取得錯誤的詳細描述。