TcpClient.BeginConnect Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Begint een asynchrone aanvraag voor een externe hostverbinding.
Overloads
| Name | Description |
|---|---|
| BeginConnect(IPAddress, Int32, AsyncCallback, Object) |
Begint een asynchrone aanvraag voor een externe hostverbinding. De externe host wordt opgegeven door een IPAddress en een poortnummer (Int32). |
| BeginConnect(IPAddress[], Int32, AsyncCallback, Object) |
Begint een asynchrone aanvraag voor een externe hostverbinding. De externe host wordt opgegeven door een IPAddress matrix en een poortnummer (Int32). |
| BeginConnect(String, Int32, AsyncCallback, Object) |
Begint een asynchrone aanvraag voor een externe hostverbinding. De externe host wordt opgegeven door een hostnaam (String) en een poortnummer (Int32). |
BeginConnect(IPAddress, Int32, AsyncCallback, Object)
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);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 IAsyncResultParameters
- port
- Int32
Het poortnummer van de externe host.
- requestCallback
- AsyncCallback
Een AsyncCallback gemachtigde die verwijst naar de methode die moet worden aangeroepen wanneer de bewerking is voltooid.
- state
- Object
Een door de gebruiker gedefinieerd object met informatie over de verbindingsbewerking. Dit object wordt doorgegeven aan de requestCallback gemachtigde wanneer de bewerking is voltooid.
Retouren
Een IAsyncResult object dat verwijst naar de asynchrone verbinding.
Uitzonderingen
De address parameter is null.
Er is een fout opgetreden bij het openen van de socket.
De Socket is gesloten.
Een aanroeper hoger in de aanroepstack heeft geen machtiging voor de aangevraagde bewerking.
Het poortnummer is ongeldig.
Opmerkingen
De asynchrone BeginConnect bewerking moet worden voltooid door de EndConnect methode aan te roepen. Normaal gesproken wordt de methode aangeroepen door de asyncCallback gemachtigde.
Deze methode wordt pas geblokkeerd als de bewerking is voltooid. Als u wilt blokkeren totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de Connect methode.
Zie Synchrone methoden asynchroon aanroepen voor gedetailleerde informatie over het gebruik van het asynchrone programmeermodel.
Note
Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.
Van toepassing op
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)
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);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 IAsyncResultParameters
- port
- Int32
Het poortnummer van de externe hosts.
- requestCallback
- AsyncCallback
Een AsyncCallback gemachtigde die verwijst naar de methode die moet worden aangeroepen wanneer de bewerking is voltooid.
- state
- Object
Een door de gebruiker gedefinieerd object met informatie over de verbindingsbewerking. Dit object wordt doorgegeven aan de requestCallback gemachtigde wanneer de bewerking is voltooid.
Retouren
Een IAsyncResult object dat verwijst naar de asynchrone verbinding.
Uitzonderingen
De addresses parameter is null.
Er is een fout opgetreden bij het openen van de socket.
De Socket is gesloten.
Een aanroeper hoger in de aanroepstack heeft geen machtiging voor de aangevraagde bewerking.
Het poortnummer is ongeldig.
Opmerkingen
De asynchrone BeginConnect bewerking moet worden voltooid door de EndConnect methode aan te roepen. Normaal gesproken wordt de methode aangeroepen door de asyncCallback gemachtigde.
Deze methode wordt pas geblokkeerd als de bewerking is voltooid. Als u wilt blokkeren totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de Connect methode.
Zie Synchrone methoden asynchroon aanroepen voor gedetailleerde informatie over het gebruik van het asynchrone programmeermodel.
Deze methode wordt doorgaans onmiddellijk na een aanroep naar de BeginGetHostAddresses methode gebruikt, waardoor meerdere IP-adressen voor één host kunnen worden geretourneerd.
Note
Als u NotSupportedException ontvangt met een bericht This protocol version is not supported tijdens het gebruik van het IPv6-adres, controleert u of u IPv6 hebt ingeschakeld in de constructor door deze door te geven InterNetworkV6.
Van toepassing op
BeginConnect(String, Int32, AsyncCallback, Object)
public:
IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::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 IAsyncResultParameters
- host
- String
De naam van de externe host.
- port
- Int32
Het poortnummer van de externe host.
- requestCallback
- AsyncCallback
Een AsyncCallback gemachtigde die verwijst naar de methode die moet worden aangeroepen wanneer de bewerking is voltooid.
- state
- Object
Een door de gebruiker gedefinieerd object met informatie over de verbindingsbewerking. Dit object wordt doorgegeven aan de requestCallback gemachtigde wanneer de bewerking is voltooid.
Retouren
Een IAsyncResult object dat verwijst naar de asynchrone verbinding.
Uitzonderingen
De host parameter is null.
Er is een fout opgetreden bij het openen van de socket.
De Socket is gesloten.
Een aanroeper hoger in de aanroepstack heeft geen machtiging voor de aangevraagde bewerking.
Het poortnummer is ongeldig.
Opmerkingen
De asynchrone BeginConnect bewerking moet worden voltooid door de EndConnect methode aan te roepen. Normaal gesproken wordt de methode aangeroepen door de asyncCallback gemachtigde.
Deze methode wordt pas geblokkeerd als de bewerking is voltooid. Als u wilt blokkeren totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de Connect methode.
Zie Synchrone methoden asynchroon aanroepen voor gedetailleerde informatie over het gebruik van het asynchrone programmeermodel.