UdpClient.Connect Méthode

public:
 void Connect(System::Net::IPEndPoint ^ endPoint);

public void Connect(System.Net.IPEndPoint endPoint);

member this.Connect : System.Net.IPEndPoint -> unit

Public Sub Connect (endPoint As IPEndPoint)

Paramètres

Exceptions

Exemples

L’exemple suivant utilise un IPEndPoint pour établir un hôte distant par défaut.

//Uses a remote endpoint to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);
try{
 udpClient.Connect(ipEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a remote endpoint to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
Try
   udpClient.Connect(ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Remarques

La Connect méthode établit un hôte distant par défaut à l’aide de la valeur spécifiée dans le endPoint paramètre. Une fois établi, vous n’avez pas besoin de spécifier un hôte distant dans chaque appel à la Send méthode.

L’établissement d’un hôte distant par défaut est facultatif. La spécification d’un hôte distant par défaut vous limite à cet hôte uniquement. Si vous souhaitez envoyer des datagrammes à un autre hôte distant, vous devez effectuer un autre appel à la Connect méthode ou en créer un autre UdpClient sans hôte distant par défaut. Si vous avez établi un hôte distant par défaut et que vous fournissez également un hôte distant dans votre appel à la Send méthode, Send lève un SocketException. Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Si vous appelez la Connect méthode, les datagrammes qui arrivent d’une adresse autre que la valeur par défaut spécifiée sont ignorés. Vous ne pouvez pas définir l’hôte distant par défaut sur une adresse de diffusion à l’aide de UdpClientcette méthode, sauf si vous héritez de , utilisez la méthode cliente pour obtenir le sous-jacent Socketet définissez l’option de socket sur SocketOptionName.Broadcast.

Toutefois, vous pouvez diffuser des données à l’adresse de diffusion par défaut, 255.255.255.255, si vous spécifiez IPAddress.Broadcast dans votre appel à la Send méthode. Si votre application nécessite un contrôle accru sur les adresses de diffusion, vous pouvez également revenir à l’utilisation de la Socket classe.

Voir aussi

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)

public:
 void Connect(System::Net::IPAddress ^ addr, int port);

public void Connect(System.Net.IPAddress addr, int port);

member this.Connect : System.Net.IPAddress * int -> unit

Public Sub Connect (addr As IPAddress, port As Integer)

Paramètres

Exceptions

Exemples

L’exemple suivant utilise une adresse IP et un numéro de port pour se connecter à un hôte distant.

//Uses the IP address and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
try{
    udpClient.Connect(ipAddress, 11003);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Uses the IP address and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Try
   udpClient.Connect(ipAddress, 11003)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Remarques

La Connect méthode établit un hôte distant par défaut à l’aide des valeurs spécifiées dans les paramètres et port les addr paramètres. Une fois établi, vous n’avez pas besoin de spécifier un hôte distant dans chaque appel à la Send méthode.

L’établissement d’un hôte distant par défaut est facultatif. La spécification d’un hôte distant par défaut vous limite à cet hôte uniquement. Si vous souhaitez envoyer des datagrammes à un autre hôte distant, vous devez effectuer un autre appel à la Connect méthode ou en créer un autre UdpClient sans hôte distant par défaut. Si vous avez établi un hôte distant par défaut et que vous fournissez également un hôte distant dans votre appel à la Send méthode, Send lève un SocketException. Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Si vous appelez la Connect méthode, les datagrammes qui arrivent d’une adresse autre que la valeur par défaut spécifiée sont ignorés. Vous ne pouvez pas définir l’hôte distant par défaut sur une adresse de diffusion à l’aide de UdpClientcette méthode, sauf si vous héritez de , utilisez la méthode cliente pour obtenir le sous-jacent Socketet définissez l’option de socket sur SocketOptionName.Broadcast.

Toutefois, vous pouvez diffuser des données à l’adresse de diffusion par défaut, 255.255.255.255, si vous spécifiez IPAddress.Broadcast dans votre appel à la Send méthode. Si votre application nécessite un contrôle accru sur les adresses de diffusion, vous pouvez également revenir à l’utilisation de la Socket classe.

Voir aussi

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)

public:
 void Connect(System::String ^ hostname, int port);

public void Connect(string hostname, int port);

member this.Connect : string * int -> unit

Public Sub Connect (hostname As String, port As Integer)

Paramètres

Exceptions

Exemples

L’exemple suivant utilise le nom d’hôte et le numéro de port pour se connecter à un hôte distant.

 //Uses a host name and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
try{
    udpClient.Connect("www.contoso.com", 11002);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a host name and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Try
   udpClient.Connect("www.contoso.com", 11002)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Remarques

La Connect méthode établit un hôte distant par défaut à l’aide des valeurs spécifiées dans les paramètres et hostname les port paramètres. Une fois établi, vous n’avez pas besoin de spécifier un hôte distant dans chaque appel à la Send méthode.

L’établissement d’un hôte distant par défaut est facultatif. La spécification d’un hôte distant par défaut vous limite à cet hôte uniquement. Si vous souhaitez envoyer des datagrammes à un autre hôte distant, vous devez effectuer un autre appel à la Connect méthode ou en créer un autre UdpClient sans hôte distant par défaut.

Si vous avez établi un hôte distant par défaut et que vous fournissez également un hôte distant dans votre appel à la Send méthode, Send lève un SocketException. Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Si vous appelez la Connect méthode, les datagrammes qui arrivent d’une adresse autre que la valeur par défaut spécifiée sont ignorés. Vous ne pouvez pas définir l’hôte distant par défaut sur une adresse de diffusion à l’aide de UdpClientcette méthode, sauf si vous héritez de , utilisez la méthode cliente pour obtenir le sous-jacent Socketet définissez l’option de socket sur SocketOptionName.Broadcast.

Toutefois, vous pouvez diffuser des données à l’adresse de diffusion par défaut, 255.255.255.255, si vous spécifiez IPAddress.Broadcast dans votre appel à la Send méthode. Si votre application nécessite un contrôle accru sur les adresses de diffusion, vous pouvez également revenir à l’utilisation de la Socket classe.

Voir aussi

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)