Partager via


UdpClient.Connect Méthode

Définition

Établit un hôte distant par défaut.

Surcharges

Connect(IPEndPoint)

Établit un hôte distant par défaut en utilisant le point de terminaison du réseau spécifié.

Connect(IPAddress, Int32)

Établit un hôte distant par défaut en utilisant l'adresse IP et le numéro de port spécifiés.

Connect(String, Int32)

Établit un hôte distant par défaut en utilisant le nom d'hôte et le numéro de port spécifiés.

Connect(IPEndPoint)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Établit un hôte distant par défaut en utilisant le point de terminaison du réseau spécifié.

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

endPoint
IPEndPoint

IPEndPoint qui spécifie le point de terminaison du réseau auquel vous souhaitez envoyer les données.

Exceptions

Une erreur s’est produite pendant l’accès au socket.

endPoint a la valeur null.

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 = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
try
{
   udpClient->Connect( ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
//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 SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous reporter à 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 , tous 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 cette méthode, sauf si vous héritez de UdpClient, utilisez la méthode Client pour obtenir le sous-jacent Socketet définissez l’option de socket sur SocketOptionName.Broadcast.

Vous pouvez toutefois diffuser des données vers 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 .

Notes

Étant donné que le protocole UDP est sans connexion, la Connect méthode ne bloque pas. N’appelez pas la Connect méthode si vous envisagez de recevoir des datagrammes multidiffusion.

Voir aussi

S’applique à

Connect(IPAddress, Int32)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Établit un hôte distant par défaut en utilisant l'adresse IP et le numéro de port spécifiés.

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

addr
IPAddress

IPAddress de l'hôte distant auquel vous souhaitez envoyer des données.

port
Int32

Numéro de port auquel vous souhaitez envoyer des données.

Exceptions

addr a la valeur null.

port n'est pas entre MinPort et MaxPort.

Une erreur s’est produite pendant l’accès au socket.

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 = gcnew 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.
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 addr paramètres et port . 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 SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous reporter à 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 , tous 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 cette méthode, sauf si vous héritez de UdpClient, utilisez la méthode cliente pour obtenir le sous-jacent Socketet définissez l’option de socket sur SocketOptionName.Broadcast.

Vous pouvez toutefois diffuser des données vers 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 .

Notes

Étant donné que le protocole UDP est sans connexion, la Connect méthode ne bloque pas. N’appelez pas la Connect méthode si vous envisagez de recevoir des datagrammes multidiffusion.

Voir aussi

S’applique à

Connect(String, Int32)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Établit un hôte distant par défaut en utilisant le nom d'hôte et le numéro de port spécifiés.

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

hostname
String

Nom DNS de l'hôte distant auquel vous souhaitez envoyer des données.

port
Int32

Numéro de port de l'hôte distant auquel vous souhaitez envoyer des données.

Exceptions

port n'est pas entre MinPort et MaxPort.

Une erreur s’est produite pendant l’accès au socket.

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 = gcnew 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.
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 port paramètres et hostname . 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 SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous reporter à 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 , tous 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 cette méthode, sauf si vous héritez de UdpClient, utilisez la méthode cliente pour obtenir le sous-jacent Socketet définissez l’option de socket sur SocketOptionName.Broadcast.

Vous pouvez toutefois diffuser des données vers 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 .

Notes

Étant donné que le protocole UDP est sans connexion, la Connect méthode ne bloque pas. N’appelez pas la Connect méthode si vous envisagez de recevoir des datagrammes multidiffusion.

Voir aussi

S’applique à