TcpClient.Available Propriedade

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Origem:

TCPClient.cs

Obtém a quantidade de dados recebidos da rede e disponíveis para leitura.

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

public int Available { get; }

member this.Available : int

Public ReadOnly Property Available As Integer

Valor da propriedade

Int32

O número de bytes de dados recebidos da rede e disponíveis para serem lidos.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

Exemplos

O exemplo de código a seguir mostra o uso da Available propriedade .

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

Comentários

A Available propriedade é uma maneira de determinar se os dados estão na fila para leitura. Se os dados estiverem disponíveis, chame Read para obter os dados. Os dados disponíveis são a quantidade total de dados enfileirados no buffer de rede para leitura. Se nenhum dado estiver na fila no buffer de rede, Available retornará 0.

Se o host remoto desligar ou fechar a conexão, Available poderá gerar um SocketException. Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.