TcpClient.BeginConnect Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Commence une demande asynchrone pour une connexion hôte distante.
Surcharges
| Nom | Description |
|---|---|
| BeginConnect(IPAddress, Int32, AsyncCallback, Object) |
Commence une demande asynchrone pour une connexion hôte distante. L’hôte distant est spécifié par un IPAddress numéro de port (Int32). |
| BeginConnect(IPAddress[], Int32, AsyncCallback, Object) |
Commence une demande asynchrone pour une connexion hôte distante. L’hôte distant est spécifié par un IPAddress tableau et un numéro de port (Int32). |
| BeginConnect(String, Int32, AsyncCallback, Object) |
Commence une demande asynchrone pour une connexion hôte distante. L’hôte distant est spécifié par un nom d’hôte (String) et un numéro de port (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 IAsyncResultParamètres
- port
- Int32
Numéro de port de l’hôte distant.
- requestCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler une fois l’opération terminée.
- state
- Object
Objet défini par l’utilisateur qui contient des informations sur l’opération de connexion. Cet objet est transmis au requestCallback délégué une fois l’opération terminée.
Retours
Objet IAsyncResult qui fait référence à la connexion asynchrone.
Exceptions
Le address paramètre est null.
Une erreur s’est produite lors de la tentative d’accès au socket.
Il Socket a été fermé.
Un appelant plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.
Le numéro de port n’est pas valide.
Remarques
L’opération asynchrone BeginConnect doit être effectuée en appelant la EndConnect méthode. En règle générale, la méthode est appelée par le asyncCallback délégué.
Cette méthode ne bloque pas tant que l’opération n’est pas terminée. Pour bloquer jusqu’à la fin de l’opération, utilisez l’une Connect des surcharges de méthode.
Pour plus d’informations sur l’utilisation du modèle de programmation asynchrone, consultez Appel asynchrone de méthodes synchrones.
Note
Si vous recevez NotSupportedException avec un message This protocol version is not supported lors de l’utilisation de l’adresse IPv6, vérifiez que vous avez activé IPv6 dans le constructeur en passant InterNetworkV6.
S’applique à
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 IAsyncResultParamètres
- port
- Int32
Numéro de port des hôtes distants.
- requestCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler une fois l’opération terminée.
- state
- Object
Objet défini par l’utilisateur qui contient des informations sur l’opération de connexion. Cet objet est transmis au requestCallback délégué une fois l’opération terminée.
Retours
Objet IAsyncResult qui fait référence à la connexion asynchrone.
Exceptions
Le addresses paramètre est null.
Une erreur s’est produite lors de la tentative d’accès au socket.
Il Socket a été fermé.
Un appelant plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.
Le numéro de port n’est pas valide.
Remarques
L’opération asynchrone BeginConnect doit être effectuée en appelant la EndConnect méthode. En règle générale, la méthode est appelée par le asyncCallback délégué.
Cette méthode ne bloque pas tant que l’opération n’est pas terminée. Pour bloquer jusqu’à la fin de l’opération, utilisez l’une Connect des surcharges de méthode.
Pour plus d’informations sur l’utilisation du modèle de programmation asynchrone, consultez Appel asynchrone de méthodes synchrones.
Cette méthode est généralement utilisée immédiatement après un appel à la BeginGetHostAddresses méthode, qui peut retourner plusieurs adresses IP pour un seul hôte.
Note
Si vous recevez NotSupportedException avec un message This protocol version is not supported lors de l’utilisation de l’adresse IPv6, vérifiez que vous avez activé IPv6 dans le constructeur en passant InterNetworkV6.
S’applique à
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 IAsyncResultParamètres
- host
- String
Nom de l’hôte distant.
- port
- Int32
Numéro de port de l’hôte distant.
- requestCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler une fois l’opération terminée.
- state
- Object
Objet défini par l’utilisateur qui contient des informations sur l’opération de connexion. Cet objet est transmis au requestCallback délégué une fois l’opération terminée.
Retours
Objet IAsyncResult qui fait référence à la connexion asynchrone.
Exceptions
Le host paramètre est null.
Une erreur s’est produite lors de la tentative d’accès au socket.
Il Socket a été fermé.
Un appelant plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.
Le numéro de port n’est pas valide.
Remarques
L’opération asynchrone BeginConnect doit être effectuée en appelant la EndConnect méthode. En règle générale, la méthode est appelée par le asyncCallback délégué.
Cette méthode ne bloque pas tant que l’opération n’est pas terminée. Pour bloquer jusqu’à la fin de l’opération, utilisez l’une Connect des surcharges de méthode.
Pour plus d’informations sur l’utilisation du modèle de programmation asynchrone, consultez Appel asynchrone de méthodes synchrones.