UdpClient Constructeurs

public:
 UdpClient();

public UdpClient();

Public Sub New ()

Exceptions

Exemples

L’exemple suivant montre comment utiliser le constructeur sans paramètre pour créer une instance de la UdpClient classe.

//Creates an instance of the UdpClient class using the default constructor.
UdpClient udpClient = new UdpClient();

'Creates an instance of the UdpClient class using the default constructor.
Dim udpClient As New UdpClient()

Remarques

Ce constructeur crée un nouveau UdpClient fournisseur de services sous-jacent et permet au fournisseur de services sous-jacent d’affecter l’adresse IPv4 et le numéro de port locaux les plus appropriés. Si ce constructeur est utilisé, l’instance UdpClient est définie avec une famille d’adresses IPv4 qui ne peut pas être modifiée ou remplacée par un appel de méthode de connexion avec une cible IPv6.

Ce constructeur ne convient pas à la jonction d’un groupe de multidiffusion, car il n’effectue pas de liaison de socket. En outre, il fonctionne uniquement avec les types d’adresses IPv4.

public:
 UdpClient(int port);

public UdpClient(int port);

new System.Net.Sockets.UdpClient : int -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer)

Paramètres

Exceptions

Exemples

L’exemple suivant illustre l’utilisation d’un numéro de port local pour créer une instance de la UdpClient classe.

//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try{
         UdpClient udpClient = new UdpClient(11000);
}
catch (Exception e ) {
          Console.WriteLine(e.ToString());
  }

'Creates an instance of the UdpClient class to listen on 
'the default interface using a particular port.
Try
   Dim udpClient As New UdpClient(11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Remarques

Ce constructeur crée un sous-jacent Socket et le lie au numéro de port à partir duquel vous avez l’intention de communiquer. Utilisez ce constructeur si vous souhaitez uniquement définir le numéro de port local. Le fournisseur de services sous-jacent affecte l’adresse IP locale. Si vous passez 0 au constructeur, le fournisseur de services sous-jacent affecte un numéro de port. Si ce constructeur est utilisé, l’instance UdpClient est définie avec une famille d’adresses IPv4 qui ne peut pas être modifiée ou remplacée par un appel de méthode de connexion avec une cible IPv6.

Ce constructeur fonctionne uniquement avec les types d’adresses IPv4.

public:
 UdpClient(System::Net::IPEndPoint ^ localEP);

public UdpClient(System.Net.IPEndPoint localEP);

new System.Net.Sockets.UdpClient : System.Net.IPEndPoint -> System.Net.Sockets.UdpClient

Public Sub New (localEP As IPEndPoint)

Paramètres

Exceptions

Exemples

L’exemple suivant montre comment créer une instance de la classe à l’aide UdpClient d’un point de terminaison local.

//Creates an instance of the UdpClient class using a local endpoint.
 IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
 IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
     UdpClient udpClient = new UdpClient(ipLocalEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class using a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim udpClient As New UdpClient(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Remarques

Ce constructeur crée un nouveau UdpClient constructeur et le lie au IPEndPoint paramètre spécifié localEP . Avant d’appeler ce constructeur, vous devez créer une IPEndPoint adresse IP et un numéro de port à partir desquels vous avez l’intention d’envoyer et de recevoir des données. Vous n’avez pas besoin de spécifier une adresse IP locale et un numéro de port pour l’envoi et la réception de données. Si ce n’est pas le cas, le fournisseur de services sous-jacent affecte l’adresse IP locale et le numéro de port les plus appropriés.

Si ce constructeur est utilisé, l’instance UdpClient est définie avec la famille d’adresses spécifiée par le localEP paramètre qui ne peut pas être modifié ou remplacé par un appel de méthode de connexion avec une autre famille d’adresses.

Voir aussi

• IPEndPoint

public:
 UdpClient(System::Net::Sockets::AddressFamily family);

public UdpClient(System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (family As AddressFamily)

Paramètres

Exceptions

Remarques

Le family paramètre détermine si l’écouteur utilise une adresse IP version 4 (IPv4) ou une adresse IP version 6 (IPv6). Pour utiliser une adresse IPv4, transmettez la InterNetwork valeur. Pour utiliser une adresse IPv6, transmettez la InterNetworkV6 valeur. La transmission d’une autre valeur entraîne la levée d’une ArgumentExceptionméthode .

Si ce constructeur est utilisé, l’instance UdpClient est définie avec la famille d’adresses spécifiée par le family paramètre qui ne peut pas être modifié ou remplacé par un appel de méthode de connexion avec une autre famille d’adresses.

Il UdpClient.UdpClient(AddressFamily) n’est pas adapté à la jonction d’un groupe de multidiffusion, car il n’effectue pas de liaison de socket.

public:
 UdpClient(int port, System::Net::Sockets::AddressFamily family);

public UdpClient(int port, System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : int * System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer, family As AddressFamily)

Paramètres

Exceptions

Exemples

L’exemple de code suivant montre comment créer un client UDP à utiliser dans un groupe de multidiffusion.

// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = new UdpClient(2000, AddressFamily.InterNetworkV6);

// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.

// Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1");

// Display the multicast address used.
Console.WriteLine("Multicast Address: [" + m_GrpAddr.ToString() + "]");

// Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)");

// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption ipv6MulticastOption = new IPv6MulticastOption(m_GrpAddr);

// Store the IPAdress multicast options.
IPAddress group =  ipv6MulticastOption.Group;
long interfaceIndex = ipv6MulticastOption.InterfaceIndex;

// Display IPv6MulticastOption properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");



// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption ipv6MulticastOption2 = new IPv6MulticastOption(group, interfaceIndex);

// Store the IPAdress multicast options.
group =  ipv6MulticastOption2.Group;
interfaceIndex = ipv6MulticastOption2.InterfaceIndex;

// Display the IPv6MulticastOption2 properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");

// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup((int)interfaceIndex, group);


// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = new IPEndPoint(m_GrpAddr, 1000);

' Bind and listen on port 2000. This constructor creates a socket 
' and binds it to the port on which to receive data. The family 
' parameter specifies that this connection uses an IPv6 address.
clientOriginator = New UdpClient(2000, AddressFamily.InterNetworkV6)

' Join or create a multicast group. The multicast address ranges 
' to use are specified in RFC#2375. You are free to use 
' different addresses.
' Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1")

' Display the multicast address used.
Console.WriteLine(("Multicast Address: [" + m_GrpAddr.ToString() + "]"))

' Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)")

' Instantiate IPv6MulticastOption using one of the 
' overloaded constructors.
Dim ipv6MulticastOption As New IPv6MulticastOption(m_GrpAddr)

' Store the IPAdress multicast options.
Dim group As IPAddress = ipv6MulticastOption.Group
Dim interfaceIndex As Long = ipv6MulticastOption.InterfaceIndex

' Display IPv6MulticastOption properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Instantiate IPv6MulticastOption using another 
' overloaded constructor.
Dim ipv6MulticastOption2 As New IPv6MulticastOption(group, interfaceIndex)

' Store the IPAdress multicast options.
group = ipv6MulticastOption2.Group
interfaceIndex = ipv6MulticastOption2.InterfaceIndex

' Display the IPv6MulticastOption2 properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Join the specified multicast group using one of the 
' JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup(Fix(interfaceIndex), group)

' Define the endpoint data port. Note that this port number
' must match the ClientTarget UDP port number which is the
' port on which the ClientTarget is receiving data.
m_ClientTargetdest = New IPEndPoint(m_GrpAddr, 1000)

Remarques

Ce constructeur crée un sous-jacent Socket et le lie au numéro de port à partir duquel vous avez l’intention de communiquer.

Le family paramètre détermine si l’écouteur utilise une adresse IP version 4 (IPv4) ou une adresse IP version 6 (IPv6). Pour utiliser une adresse IPv4, transmettez la InterNetwork valeur. Pour utiliser une adresse IPv6, transmettez la InterNetworkV6 valeur. La transmission d’une autre valeur entraîne la levée d’une ArgumentExceptionméthode .

Si ce constructeur est utilisé, l’instance UdpClient est définie avec la famille d’adresses spécifiée par le family paramètre qui ne peut pas être modifié ou remplacé par un appel de méthode de connexion avec une autre famille d’adresses.

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

public UdpClient(string hostname, int port);

new System.Net.Sockets.UdpClient : string * int -> System.Net.Sockets.UdpClient

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

Paramètres

Exceptions

Exemples

L’exemple suivant montre comment créer une instance de la classe à l’aide UdpClient d’un nom d’hôte et d’un numéro de port.

//Creates an instance of the UdpClient class with a remote host name and a port number.
try{
     UdpClient udpClient = new UdpClient("www.contoso.com",11000);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class with a remote host name and a port number.
Try
   Dim udpClient As New UdpClient("www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Remarques

Ce constructeur initialise un nouvel UdpClient hôte et établit un hôte distant à l’aide des paramètres et port des hostname paramètres. L’établissement d’un hôte distant par défaut est facultatif. Si vous utilisez ce constructeur, vous n’avez pas besoin de spécifier un hôte distant dans chaque appel à la Send méthode. La spécification d’un hôte distant par défaut vous limite à cet hôte uniquement. Vous pouvez modifier l’hôte distant par défaut à tout moment en appelant la Connect méthode. Si vous souhaitez spécifier un hôte distant dans votre appel à la Send méthode, n’utilisez pas ce constructeur.

Voir aussi

• Send(Byte[], Int32, IPEndPoint)
• Connect(String, Int32)