Socket.Poll Método

Origem:

Socket.cs

Origem:

Socket.cs

Origem:

Socket.cs

public:
 bool Poll(TimeSpan timeout, System::Net::Sockets::SelectMode mode);

public bool Poll (TimeSpan timeout, System.Net.Sockets.SelectMode mode);

member this.Poll : TimeSpan * System.Net.Sockets.SelectMode -> bool

Public Function Poll (timeout As TimeSpan, mode As SelectMode) As Boolean

Parâmetros

Retornos

O status do Socket com base no valor de modo de sondagem passado no parâmetro mode. Retornará true se qualquer uma das condições a seguir ocorrer antes da timeout expiração, caso contrário, false.

• Para SelectRead, ele retornará true se Listen() tiver sido chamado e uma conexão estiver pendente, se os dados estiverem disponíveis para leitura ou se a conexão tiver sido fechada, redefinida ou encerrada.
• Para SelectWrite, ele retornará true se o processamento de um Connect e a conexão tiverem sido bem-sucedidos ou se os dados puderem ser enviados.
• Para SelectError, ele retornará true se o processamento de um Connect que não bloquear e a conexão falhar ou se OutOfBandInline não estiver definido e os dados fora de banda estiverem disponíveis.
• Caso contrário, ele retornará false.

Exceções

Origem:

Socket.cs

Origem:

Socket.cs

Origem:

Socket.cs

public:
 bool Poll(int microSeconds, System::Net::Sockets::SelectMode mode);

public bool Poll (int microSeconds, System.Net.Sockets.SelectMode mode);

member this.Poll : int * System.Net.Sockets.SelectMode -> bool

Public Function Poll (microSeconds As Integer, mode As SelectMode) As Boolean

Parâmetros

Retornos

O status do Socket com base no valor de modo de sondagem passado no parâmetro mode.

• Para SelectRead, ele retornará true se Listen() tiver sido chamado e uma conexão estiver pendente, se os dados estiverem disponíveis para leitura ou se a conexão tiver sido fechada, redefinida ou encerrada.
• Para SelectWrite, ele retornará true se o processamento de um Connect e a conexão tiverem sido bem-sucedidos ou se os dados puderem ser enviados.
• Para SelectError, ele retornará true se o processamento de um Connect que não bloquear e a conexão falhar ou se OutOfBandInline não estiver definido e os dados fora de banda estiverem disponíveis.
• Caso contrário, ele retornará false.

Exceções

Exemplos

O exemplo de código a seguir cria um soquete, conecta-se a um servidor e usa Poll para marcar o status do soquete.

//Creates the Socket for sending data over TCP.
Socket^ s = gcnew Socket( AddressFamily::InterNetwork, SocketType::Stream,
   ProtocolType::Tcp );

// Connects to host using IPEndPoint.
s->Connect( EPhost );
if ( !s->Connected )
{
   strRetPage = "Unable to connect to host";
}
// Use the SelectWrite enumeration to obtain Socket status.
if ( s->Poll( -1, SelectMode::SelectWrite ) )
{
   Console::WriteLine( "This Socket is writable." );
}
else if ( s->Poll(  -1, SelectMode::SelectRead ) )
{
   Console::WriteLine( "This Socket is readable." );
}
else if ( s->Poll(  -1, SelectMode::SelectError ) )
{
   Console::WriteLine( "This Socket has an error." );
}

//Creates the Socket for sending data over TCP.
Socket s = new Socket(AddressFamily.InterNetwork, SocketType.Stream,
   ProtocolType.Tcp );

// Connects to host using IPEndPoint.
s.Connect(EPhost);
if (!s.Connected)
{
   strRetPage = "Unable to connect to host";
}
// Use the SelectWrite enumeration to obtain Socket status.
 if(s.Poll(-1, SelectMode.SelectWrite)){
      Console.WriteLine("This Socket is writable.");
 }
 else if (s.Poll(-1, SelectMode.SelectRead)){
       Console.WriteLine("This Socket is readable." );
 }
 else if (s.Poll(-1, SelectMode.SelectError)){
      Console.WriteLine("This Socket has an error.");
 }

'Creates the Socket for sending data over TCP.
Dim s As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)

' Connects to host using IPEndPoint.
s.Connect(EPhost)
If Not s.Connected Then
   strRetPage = "Unable to connect to host"
End If
' Use the SelectWrite enumeration to obtain Socket status.
If s.Poll(- 1, SelectMode.SelectWrite) Then
   Console.WriteLine("This Socket is writable.")
Else
   If s.Poll(- 1, SelectMode.SelectRead) Then
      Console.WriteLine(("This Socket is readable. "))
   Else
      If s.Poll(- 1, SelectMode.SelectError) Then
         Console.WriteLine("This Socket has an error.")
      End If
   End If 
End If

Comentários

O Poll método verifica o estado do Socket. Especifique SelectMode.SelectRead para o selectMode parâmetro para determinar se o Socket é legível. Especifique SelectMode.SelectWrite para determinar se o Socket é gravável. Use SelectMode.SelectError para detectar uma condição de erro. Poll bloqueará a execução até que o período de tempo especificado, medido em microseconds, decorridos ou dados se torne disponível. Defina o microSeconds parâmetro como um inteiro negativo se você quiser esperar indefinidamente por uma resposta. Se você quiser marcar o status de vários soquetes, talvez prefira usar o Select método .

Confira também

• SelectMode
• Poll(Int32, SelectMode)