Freigeben über


Socket.Poll Methode

Definition

Überlädt

Poll(TimeSpan, SelectMode)

Bestimmt den Status des Socket.

Poll(Int32, SelectMode)

Bestimmt den Status des Socket.

Poll(TimeSpan, SelectMode)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Bestimmt den Status des 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

Parameter

timeout
TimeSpan

Die Zeit zum Warten auf eine Antwort.

mode
SelectMode

Einer der SelectMode-Werte.

Gibt zurück

Der Status des Socket basierend auf dem im mode-Parameter übergebenen Abfragemoduswert. Gibt zurück true , wenn eine der folgenden Bedingungen vor ablaufen timeout , andernfalls false.

  • Für SelectReadgibt es zurück true , wenn Listen() aufgerufen wurde und eine Verbindung aussteht, wenn Daten zum Lesen verfügbar sind oder wenn die Verbindung geschlossen, zurückgesetzt oder beendet wurde.
  • Für SelectWritewird zurückgegeben true , wenn die Verarbeitung eines Connect und der Verbindung erfolgreich war oder Wenn Daten gesendet werden können.
  • Für SelectErrorwird zurückgegeben true , wenn die Verarbeitung eines Connect nicht blockiert und die Verbindung fehlgeschlagen ist, oder wenn OutOfBandInline nicht festgelegt ist und Out-of-Band-Daten verfügbar sind.
  • Andernfalls wird falsezurückgegeben.

Ausnahmen

timeout ist kleiner als -1 Millisekunden oder größer als MaxValue Millisekunden.

Fehler beim Versuch, auf den Socket zuzugreifen.

Der Socket wurde geschlossen.

Gilt für:

Poll(Int32, SelectMode)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Bestimmt den Status des 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

Parameter

microSeconds
Int32

Die Zeit in Mikrosekunden, die auf eine Antwort gewartet werden soll.

mode
SelectMode

Einer der SelectMode-Werte.

Gibt zurück

Der Status des Socket basierend auf dem im mode-Parameter übergebenen Abfragemoduswert.

  • Für SelectReadgibt es zurück true , wenn Listen() aufgerufen wurde und eine Verbindung aussteht, wenn Daten zum Lesen verfügbar sind oder wenn die Verbindung geschlossen, zurückgesetzt oder beendet wurde.
  • Für SelectWritewird zurückgegeben true , wenn die Verarbeitung eines Connect und der Verbindung erfolgreich war oder Wenn Daten gesendet werden können.
  • Für SelectErrorwird zurückgegeben true , wenn die Verarbeitung eines Connect nicht blockiert und die Verbindung fehlgeschlagen ist, oder wenn OutOfBandInline nicht festgelegt ist und Out-of-Band-Daten verfügbar sind.
  • Andernfalls wird falsezurückgegeben.

Ausnahmen

Der mode-Parameter ist keiner der SelectMode-Werte.

Fehler beim Versuch, auf den Socket zuzugreifen. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".

Der Socket wurde geschlossen.

Beispiele

Im folgenden Codebeispiel wird ein Socket erstellt, eine Verbindung mit einem Server hergestellt und verwendetPoll, um die status des Sockets zu überprüfen.

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

Hinweise

Die Poll -Methode überprüft den Zustand von Socket. Geben Sie SelectMode.SelectRead für den selectMode Parameter an, um zu bestimmen, ob der Socket lesbar ist. Geben Sie an SelectMode.SelectWrite , um zu bestimmen, ob der Socket beschreibbar ist. Verwenden Sie SelectMode.SelectError , um eine Fehlerbedingung zu erkennen. Poll blockiert die Ausführung, bis der angegebene Zeitraum , gemessen in microseconds, verstrichen oder Daten verfügbar sind. Legen Sie den microSeconds Parameter auf eine negative ganze Zahl fest, wenn Sie unbegrenzt auf eine Antwort warten möchten. Wenn Sie die status mehrerer Sockets überprüfen möchten, verwenden Sie möglicherweise die Select -Methode.

Hinweis

Wenn Sie erhalten eine SocketException, verwenden die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 .

Hinweis

Diese Methode kann bestimmte Arten von Verbindungsprobleme nicht erkennen, z. B. ein unterbrochenes Netzwerkkabel oder dass der Remotehost nicht ordnungsgemäß heruntergefahren wurde. Sie müssen versuchen, Daten zu senden oder zu empfangen, um diese Art von Fehlern zu erkennen.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Weitere Informationen

Gilt für: