Socket.Poll Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Überlädt

Poll(TimeSpan, SelectMode)	Bestimmt den Status des Socket.
Poll(Int32, SelectMode)	Bestimmt den Status des Socket.

Poll(TimeSpan, SelectMode)

Source:

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, in der auf eine Antwort gewartet werden soll.

mode

SelectMode

Einer der SelectMode-Werte.

Gibt zurück

Boolean

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 SelectReadwird zurückgegeben 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 Daten gesendet werden können.
• Für SelectErrorwird zurückgegeben true , wenn eine Connect verarbeitet wird, die 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

ArgumentOutOfRangeException

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

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

Poll(Int32, SelectMode)

Source:

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

Boolean

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

• Für SelectReadwird zurückgegeben 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 Daten gesendet werden können.
• Für SelectErrorwird zurückgegeben true , wenn eine Connect verarbeitet wird, die 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

NotSupportedException

Der mode-Parameter ist keiner der SelectMode-Werte.

SocketException

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

ObjectDisposedException

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 die Socket schreibbar 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, sollten Sie die Select -Methode verwenden.

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 in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode eine ausführliche Beschreibung des Fehlers.

Hinweis

Diese Methode kann bestimmte Arten von Verbindungsprobleme nicht erkennen, z. B. ein beschädigtes 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

• SelectMode
• Poll(Int32, SelectMode)