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.
Démarre une demande asynchrone pour une connexion d'hôte distant.
Surcharges
| BeginConnect(IPAddress, Int32, AsyncCallback, Object) |
Démarre une demande asynchrone pour une connexion d'hôte distant. L'hôte distant est spécifié par un élément IPAddress et un numéro de port (Int32). |
| BeginConnect(IPAddress[], Int32, AsyncCallback, Object) |
Démarre une demande asynchrone pour une connexion d'hôte distant. L'hôte distant est spécifié par un tableau IPAddress et un numéro de port (Int32). |
| BeginConnect(String, Int32, AsyncCallback, Object) |
Démarre une demande asynchrone pour une connexion d'hôte distant. 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)
- Source:
- TCPClient.cs
- Source:
- TCPClient.cs
- Source:
- 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 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 quand l'opération est terminée.
- state
- Object
Objet défini par l'utilisateur qui contient des informations sur l'opération de connexion. Cet objet est passé au délégué requestCallback quand l'opération est terminée.
Retours
Objet IAsyncResult qui fait référence à la connexion asynchrone.
Exceptions
Le paramètre address a la valeur null.
Une erreur s’est produite pendant la tentative d’accès au socket.
Socket a été fermé.
Un appelant situé 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 se 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.
Notes
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)
- Source:
- TCPClient.cs
- Source:
- TCPClient.cs
- Source:
- 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 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 quand l'opération est terminée.
- state
- Object
Objet défini par l'utilisateur qui contient des informations sur l'opération de connexion. Cet objet est passé au délégué requestCallback quand l'opération est terminée.
Retours
Objet IAsyncResult qui fait référence à la connexion asynchrone.
Exceptions
Le paramètre addresses a la valeur null.
Une erreur s’est produite pendant la tentative d’accès au socket.
Socket a été fermé.
Un appelant situé 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 se 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.
Notes
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)
- Source:
- TCPClient.cs
- Source:
- TCPClient.cs
- Source:
- 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 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 quand l'opération est terminée.
- state
- Object
Objet défini par l'utilisateur qui contient des informations sur l'opération de connexion. Cet objet est passé au délégué requestCallback quand l'opération est terminée.
Retours
Objet IAsyncResult qui fait référence à la connexion asynchrone.
Exceptions
Le paramètre host a la valeur null.
Une erreur s’est produite pendant la tentative d’accès au socket.
Socket a été fermé.
Un appelant situé 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 se 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.
