UdpClient.Connect 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.
É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
.
Le UdpClient est fermé.
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
- port
- Int32
Numéro de port auquel vous souhaitez envoyer des données.
Exceptions
UdpClient est fermé.
addr
a la valeur null
.
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
Le UdpClient est fermé.
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.