UdpClient Constructeurs

  • Référence

Définition

Espace de noms:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Initialise une nouvelle instance de la classe UdpClient.

Surcharges

UdpClient()

Initialise une nouvelle instance de la classe UdpClient.
UdpClient(Int32)

Initialise une nouvelle instance de la classe UdpClient et la lie au numéro de port local fourni.
UdpClient(IPEndPoint)

Initialise une nouvelle instance de la classe UdpClient et la lie au point de terminaison local spécifié.
UdpClient(AddressFamily)

Initialise une nouvelle instance de la classe UdpClient.
UdpClient(Int32, AddressFamily)

Initialise une nouvelle instance de la classe UdpClient et la lie au numéro de port local fourni.
UdpClient(String, Int32)

Initialise une nouvelle instance de la classe UdpClient et établit un hôte distant par défaut.

UdpClient()

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

Initialise une nouvelle instance de la classe UdpClient.

public:
 UdpClient();
public UdpClient ();
Public Sub New ()

Exceptions

SocketException

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

Exemples

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

//Creates an instance of the UdpClient class using the default constructor.
UdpClient^ udpClient = gcnew UdpClient;

//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 et permet au fournisseur de services sous-jacent d’attribuer l’adresse IPv4 locale et le numéro de port les plus appropriés. Si ce constructeur est utilisé, le UdpClient instance est défini avec une famille d’adresses IPv4 qui ne peut pas être modifiée ou remplacée par un appel de méthode connect avec une cible IPv6.

Notes

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.

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

S’applique à

UdpClient(Int32)

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

Initialise une nouvelle instance de la classe UdpClient et la lie au numéro de port local fourni.

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

port
Int32

Numéro de port local à partir duquel vous souhaitez communiquer.

Exceptions

ArgumentOutOfRangeException

Le paramètre port est supérieur au champ MaxPort ou inférieur au champ MinPort.

SocketException

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

Exemples

L’exemple suivant illustre l’utilisation d’un numéro de port local pour créer un 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 = gcnew 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{
         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 attribue l’adresse IP locale. Si vous passez 0 au constructeur, le fournisseur de services sous-jacent attribue un numéro de port. Si ce constructeur est utilisé, le UdpClient instance est défini avec une famille d’adresses IPv4 qui ne peut pas être modifiée ou remplacée par un appel de méthode connect avec une cible IPv6.

Notes

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.

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

S’applique à

UdpClient(IPEndPoint)

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

Initialise une nouvelle instance de la classe UdpClient et la lie au point de terminaison local spécifié.

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

localEP
IPEndPoint

IPEndPoint qui représente le point de terminaison local auquel lier la connexion UDP.

Exceptions

ArgumentNullException

localEP a la valeur null.

SocketException

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

Exemples

L’exemple suivant montre comment créer un 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 = gcnew IPEndPoint( ipAddress,11000 );

try
{
   UdpClient^ udpClient = gcnew UdpClient( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}


//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 et le lie au IPEndPoint spécifié par le localEP paramètre . Avant d’appeler ce constructeur, vous devez créer un à l’aide de IPEndPoint l’adresse IP et du numéro de port à partir desquels vous envisagez 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 attribue l’adresse IP locale et le numéro de port les plus appropriés.

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

Notes

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.

Voir aussi

S’applique à

UdpClient(AddressFamily)

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

Initialise une nouvelle instance de la classe UdpClient.

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

family
AddressFamily

Une des valeurs AddressFamily qui spécifie le schéma d'adressage du socket.

Exceptions

ArgumentException

family n'est pas InterNetwork, ni InterNetworkV6.

SocketException

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

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 . Si vous passez une autre valeur, la méthode lève un ArgumentException.

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

Notes

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.

Le UdpClient.UdpClient(AddressFamily) n’est pas approprié pour joindre un groupe de multidiffusion, car il n’effectue pas de liaison de socket.

S’applique à

UdpClient(Int32, AddressFamily)

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

Initialise une nouvelle instance de la classe UdpClient et la lie au numéro de port local fourni.

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

port
Int32

Port sur lequel écouter les tentatives de connexion entrante.

family
AddressFamily

Une des valeurs AddressFamily qui spécifie le schéma d'adressage du socket.

Exceptions

ArgumentException

family n'est pas InterNetwork, ni InterNetworkV6.

ArgumentOutOfRangeException

port est supérieur à MaxPort ou inférieur à MinPort.

SocketException

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

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 = gcnew 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: [ {0}]", m_GrpAddr );

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

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

// Store the IPAdress multicast options.
IPAddress^ group = ipv6MulticastOption->Group;
__int64 interfaceIndex = ipv6MulticastOption->InterfaceIndex;

// Display IPv6MulticastOption properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0}]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0}]", interfaceIndex );

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

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

// Display the IPv6MulticastOption2 properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0} ]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0} ]", 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 = gcnew 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.
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 . Si vous passez une autre valeur, la méthode lève un ArgumentException.

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

Notes

Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

S’applique à

UdpClient(String, Int32)

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

Initialise une nouvelle instance de la classe UdpClient et établit un hôte distant par défaut.

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

hostname
String

Nom de l'hôte DNS distant auquel vous souhaitez vous connecter.

port
Int32

Numéro de port distant auquel vous souhaitez vous connecter.

Exceptions

ArgumentNullException

hostname a la valeur null.

ArgumentOutOfRangeException

port n'est pas entre MinPort et MaxPort.

SocketException

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

Exemples

L’exemple suivant montre comment créer un 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 = gcnew 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{
     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 nouveau UdpClient et établit un hôte distant à l’aide des hostname paramètres et port . 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.

Notes

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.

Voir aussi

S’applique à