Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

UdpClient.Connect, méthode (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.

Espace de noms :  System.Net.Sockets
Assembly :  System (dans System.dll)

public void Connect(
	string hostname,
	int port
)

Paramètres

hostname
Type : System.String
Nom DNS de l'hôte distant auquel vous souhaitez envoyer des données.
port
Type : System.Int32
Numéro de port de l'hôte distant auquel vous souhaitez envoyer des données.

ExceptionCondition
ObjectDisposedException

UdpClient est fermé.

ArgumentOutOfRangeException

port n'est pas entre MinPort et MaxPort.

SocketException

Une erreur s'est produite lors de l'accès au socket. Pour plus d'informations, consultez la section Notes.

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

L'établissement d'un hôte distant par défaut est facultatif. Le fait de spécifier un hôte distant par défaut vous limite exclusivement à cet hôte. Si vous voulez envoyer des datagrammes à un hôte distant différent, vous devez passer un autre appel à la méthode Connect ou créer un autre UdpClient sans hôte distant par défaut.

Si vous avez établi un hôte distant par défaut et si vous fournissez en outre un hôte distant dans votre appel à la méthode Send, Send lève SocketException. Si vous recevez une exception SocketException, utilisez la propriété SocketException.ErrorCode pour obtenir le code d'erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation sur les codes d'erreur de l'API de Windows Sockets version 2 dans MSDN pour obtenir une description détaillée de l'erreur.

Si vous appelez la méthode Connect, tous les datagrammes qui arrivent d'une adresse autre que celle spécifiée par défaut sont ignorés. Vous ne pouvez pas affecter d'adresse de diffusion à l'hôte distant par défaut à l'aide de cette méthode, à moins d'hériter de UdpClient, d'utiliser la méthode cliente pour obtenir le Socket sous-jacent et d'assigner le champ SocketOptionName.Broadcast à l'option de socket.

Vous pouvez toutefois 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 méthode Send. Si votre application requiert un plus grand contrôle sur les adresses de diffusion, vous pouvez également rétablir les valeurs initiales à l'aide de la classe Socket.

RemarqueRemarque

Compte tenu que le protocole UDP est sans connexion, la méthode Connect ne se bloque pas. N'appelez pas la méthode Connect si vous souhaitez recevoir des datagrammes multicast.

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());
       }


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft