TcpClient.BeginConnect Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beginnt eine asynchrone Anforderung einer Remotehostverbindung.
Überlädt
| BeginConnect(IPAddress, Int32, AsyncCallback, Object) |
Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch eine IPAddress und eine Anschlussnummer (Int32) angegeben. |
| BeginConnect(IPAddress[], Int32, AsyncCallback, Object) |
Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch ein IPAddress-Array und eine Portnummer (Int32) angegeben. |
| BeginConnect(String, Int32, AsyncCallback, Object) |
Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch einen Hostnamen (String) und eine Anschlussnummer (Int32) angegeben. |
BeginConnect(IPAddress, Int32, AsyncCallback, Object)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
public:
IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);public IAsyncResult BeginConnect (System.Net.IPAddress address, int port, AsyncCallback? requestCallback, object? state);public IAsyncResult BeginConnect (System.Net.IPAddress address, int port, AsyncCallback requestCallback, object state);member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResultParameter
- port
- Int32
Die Portnummer des Remotehosts.
- requestCallback
- AsyncCallback
Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.
- state
- Object
Ein benutzerdefiniertes Objekt, das Informationen über den Verbindungsvorgang enthält. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.
Gibt zurück
Ein IAsyncResult-Objekt, das auf die asynchrone Verbindung verweist.
Ausnahmen
Der address-Parameter ist null.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Die Portnummer ist ungültig.
Hinweise
Der asynchrone BeginConnect Vorgang muss durch Aufrufen der EndConnect -Methode abgeschlossen werden. In der Regel wird die -Methode vom asyncCallback Delegaten aufgerufen.
Diese Methode wird erst blockiert, wenn der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der Connect Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen synchroner Methoden.
Hinweis
Wenn Sie notSupportedException mit der Meldung This protocol version is not supported erhalten, während Sie die IPv6-Adresse verwenden, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.
Gilt für:
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
public:
IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);public IAsyncResult BeginConnect (System.Net.IPAddress[] addresses, int port, AsyncCallback? requestCallback, object? state);public IAsyncResult BeginConnect (System.Net.IPAddress[] addresses, int port, AsyncCallback requestCallback, object state);member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResultParameter
- port
- Int32
Die Portnummer des Remotehosts.
- requestCallback
- AsyncCallback
Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.
- state
- Object
Ein benutzerdefiniertes Objekt, das Informationen über den Verbindungsvorgang enthält. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.
Gibt zurück
Ein IAsyncResult-Objekt, das auf die asynchrone Verbindung verweist.
Ausnahmen
Der addresses-Parameter ist null.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Die Portnummer ist ungültig.
Hinweise
Der asynchrone BeginConnect Vorgang muss durch Aufrufen der EndConnect -Methode abgeschlossen werden. In der Regel wird die -Methode vom asyncCallback Delegaten aufgerufen.
Diese Methode wird erst blockiert, wenn der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der Connect Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen synchroner Methoden.
Diese Methode wird in der Regel unmittelbar nach einem Aufruf der BeginGetHostAddresses -Methode verwendet, die mehrere IP-Adressen für einen einzelnen Host zurückgeben kann.
Hinweis
Wenn Sie notSupportedException mit der Meldung This protocol version is not supported erhalten, während Sie die IPv6-Adresse verwenden, stellen Sie sicher, dass Sie IPv6 im Konstruktor aktiviert haben, indem Sie übergeben InterNetworkV6.
Gilt für:
BeginConnect(String, Int32, AsyncCallback, Object)
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
- Quelle:
- TCPClient.cs
public:
IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);public IAsyncResult BeginConnect (string host, int port, AsyncCallback? requestCallback, object? state);public IAsyncResult BeginConnect (string host, int port, AsyncCallback requestCallback, object state);member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResultParameter
- host
- String
Der Name des Remotehosts.
- port
- Int32
Die Portnummer des Remotehosts.
- requestCallback
- AsyncCallback
Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.
- state
- Object
Ein benutzerdefiniertes Objekt, das Informationen über den Verbindungsvorgang enthält. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.
Gibt zurück
Ein IAsyncResult-Objekt, das auf die asynchrone Verbindung verweist.
Ausnahmen
Der host-Parameter ist null.
Fehler beim Versuch, auf den Socket zuzugreifen.
Der Socket wurde geschlossen.
Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.
Die Portnummer ist ungültig.
Hinweise
Der asynchrone BeginConnect Vorgang muss durch Aufrufen der EndConnect -Methode abgeschlossen werden. In der Regel wird die -Methode vom asyncCallback Delegaten aufgerufen.
Diese Methode wird erst blockiert, wenn der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie eine der Connect Methodenüberladungen.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen synchroner Methoden.
