TcpClient.BeginConnect Méthode

  • Référence

Définition

Espace de noms:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

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).

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 -> IAsyncResult
Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

address
IPAddress

Élément IPAddress 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

IAsyncResult

Objet IAsyncResult qui fait référence à la connexion asynchrone.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

SocketException

Une erreur s’est produite pendant la tentative d’accès au socket.

ObjectDisposedException

Socket a été fermé.

SecurityException

Un appelant situé plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.

ArgumentOutOfRangeException

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

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).

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 -> IAsyncResult
Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

addresses
IPAddress[]

Au moins un élément IPAddress qui désigne les hôtes distants.

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

IAsyncResult

Objet IAsyncResult qui fait référence à la connexion asynchrone.

Exceptions

ArgumentNullException

Le paramètre addresses a la valeur null.

SocketException

Une erreur s’est produite pendant la tentative d’accès au socket.

ObjectDisposedException

Socket a été fermé.

SecurityException

Un appelant situé plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.

ArgumentOutOfRangeException

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

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).

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 -> IAsyncResult
Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Paramè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

IAsyncResult

Objet IAsyncResult qui fait référence à la connexion asynchrone.

Exceptions

ArgumentNullException

Le paramètre host a la valeur null.

SocketException

Une erreur s’est produite pendant la tentative d’accès au socket.

ObjectDisposedException

Socket a été fermé.

SecurityException

Un appelant situé plus haut dans la pile des appels n’a pas l’autorisation pour l’opération demandée.

ArgumentOutOfRangeException

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.

S’applique à