Socket.Poll Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

netstandard.dll, System.Net.Sockets.dll

Overload

Nome	Descrizione
Poll(TimeSpan, SelectMode)	Determina lo stato dell'oggetto Socket.
Poll(Int32, SelectMode)	Determina lo stato dell'oggetto Socket.

Poll(TimeSpan, SelectMode)

Origine:

Socket.cs

Determina lo stato dell'oggetto Socket.

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

Parametri

timeout

TimeSpan

Tempo di attesa di una risposta.

mode

SelectMode

Uno dei SelectMode valori.

Restituisce

Boolean

Stato dell'oggetto Socket in base al valore della modalità di polling passato nel mode parametro . Restituisce true se prima della scadenza si verifica timeout una delle condizioni seguenti; in caso contrario, false.

• Per SelectRead, restituisce true se Listen() è stato chiamato e una connessione è in sospeso, se i dati sono disponibili per la lettura o se la connessione è stata chiusa, reimpostata o terminata.
• Per SelectWrite, restituisce true se l'elaborazione di e Connect la connessione ha avuto esito positivo o se i dati possono essere inviati.
• Per SelectError, restituisce true se l'elaborazione di un oggetto Connect che non blocca e la connessione non è riuscita oppure se OutOfBandInline non è impostato e i dati fuori banda sono disponibili.
• In caso contrario, restituisce false.

Eccezioni

ArgumentOutOfRangeException

timeout è minore di -1 millisecondi o maggiore di MaxValue millisecondi.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Poll(Int32, SelectMode)

Origine:

Socket.cs

Determina lo stato dell'oggetto Socket.

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

Parametri

microSeconds

Int32

Tempo di attesa di una risposta, espresso in microsecondi.

mode

SelectMode

Uno dei SelectMode valori.

Restituisce

Boolean

Stato dell'oggetto Socket in base al valore della modalità di polling passato nel mode parametro .

• Per SelectRead, restituisce true se Listen() è stato chiamato e una connessione è in sospeso, se i dati sono disponibili per la lettura o se la connessione è stata chiusa, reimpostata o terminata.
• Per SelectWrite, restituisce true se l'elaborazione di e Connect la connessione ha avuto esito positivo o se i dati possono essere inviati.
• Per SelectError, restituisce true se l'elaborazione di un oggetto Connect che non blocca e la connessione non è riuscita oppure se OutOfBandInline non è impostato e i dati fuori banda sono disponibili.
• In caso contrario, restituisce false.

Eccezioni

NotSupportedException

Il mode parametro non è uno dei SelectMode valori.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket. Vedere le osservazioni riportate di seguito.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Esempio

L'esempio di codice seguente crea un socket, si connette a un server e usa Poll per controllare lo stato del socket.

//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

Commenti

Il Poll metodo controlla lo stato dell'oggetto Socket. Specificare SelectMode.SelectRead per il selectMode parametro per determinare se è Socket leggibile. Specificare SelectMode.SelectWrite per determinare se è Socket scrivibile. Usare SelectMode.SelectError per rilevare una condizione di errore. Poll bloccherà l'esecuzione fino a quando il periodo di tempo specificato, misurato in microseconds, scade o diventano disponibili i dati. Impostare il microSeconds parametro su un numero intero negativo se si desidera attendere per un periodo illimitato per una risposta. Se vuoi controllare lo stato di più socket, potresti preferire l'uso del Select metodo .

Annotazioni

Se si riceve un oggetto SocketException, utilizzare la SocketException.ErrorCode proprietà per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Annotazioni

Questo metodo non è in grado di rilevare determinati tipi di problemi di connessione, ad esempio un cavo di rete interrotto o che l'host remoto è stato arrestato in modo anomalo. È necessario tentare di inviare o ricevere dati per rilevare questi tipi di errori.

Annotazioni

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Vedi anche

• SelectMode
• Poll(Int32, SelectMode)