UdpClient Constructores

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Inicializa una nueva instancia de la clase UdpClient.

Sobrecargas

UdpClient()	Inicializa una nueva instancia de la clase UdpClient.
UdpClient(Int32)	Inicializa una nueva instancia de la clase UdpClient y la enlaza con el número de puerto local especificado.
UdpClient(IPEndPoint)	Inicializa una nueva instancia de la clase UdpClient y la enlaza con el punto de conexión local especificado.
UdpClient(AddressFamily)	Inicializa una nueva instancia de la clase UdpClient.
UdpClient(Int32, AddressFamily)	Inicializa una nueva instancia de la clase UdpClient y la enlaza con el número de puerto local especificado.
UdpClient(String, Int32)	Inicializa una nueva instancia de la clase UdpClient y establece un host remoto predeterminado.

UdpClient()

Source:

UDPClient.cs

Inicializa una nueva instancia de la clase UdpClient.

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Excepciones

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el constructor sin parámetros para crear una instancia de la UdpClient clase .

//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()

Comentarios

Este constructor crea un nuevo UdpClient y permite al proveedor de servicios subyacente asignar la dirección IPv4 local y el número de puerto más apropiados. Si se usa este constructor, la UdpClient instancia se establece con una familia de direcciones de IPv4 que no se puede cambiar ni sobrescribir mediante una llamada al método connect con un destino IPv6.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Este constructor no es adecuado para unir un grupo de multidifusión porque no realiza el enlace de sockets. Además, solo funciona con tipos de direcciones IPv4.

UdpClient(Int32)

Source:

UDPClient.cs

Inicializa una nueva instancia de la clase UdpClient y la enlaza con el número de puerto local especificado.

public:
 UdpClient(int port);

public UdpClient (int port);

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

Public Sub New (port As Integer)

Parámetros

port

Int32

Número de puerto local desde el que se desea establecer comunicación.

Excepciones

ArgumentOutOfRangeException

El parámetro port es mayor que MaxPort o menor que MinPort.

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el ejemplo siguiente se muestra el uso de un número de puerto local para crear una instancia de la UdpClient clase .

//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

Comentarios

Este constructor crea un subyacente Socket y lo enlaza al número de puerto desde el que se va a comunicar. Use este constructor si solo está interesado en establecer el número de puerto local. El proveedor de servicios subyacente asignará la dirección IP local. Si pasa 0 al constructor, el proveedor de servicios subyacente asignará un número de puerto. Si se usa este constructor, la UdpClient instancia se establece con una familia de direcciones de IPv4 que no se puede cambiar ni sobrescribir mediante una llamada al método connect con un destino IPv6.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Este constructor solo funciona con tipos de direcciones IPv4.

UdpClient(IPEndPoint)

Source:

UDPClient.cs

Inicializa una nueva instancia de la clase UdpClient y la enlaza con el punto de conexión local especificado.

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)

Parámetros

localEP

IPEndPoint

IPEndPoint que representa el punto de conexión local al que se enlaza la conexión UDP.

Excepciones

ArgumentNullException

localEP es null.

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una instancia de la UdpClient clase mediante un punto de conexión 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

Comentarios

Este constructor crea un nuevo UdpClient y lo enlaza al IPEndPoint especificado por el localEP parámetro . Antes de llamar a este constructor, debe crear un IPEndPoint mediante la dirección IP y el número de puerto desde el que desea enviar y recibir datos. No es necesario especificar una dirección IP local y un número de puerto para enviar y recibir datos. Si no lo hace, el proveedor de servicios subyacente asignará la dirección IP local y el número de puerto más adecuados.

Si se usa este constructor, la UdpClient instancia se establece con la familia de direcciones especificada por el localEP parámetro que no se puede cambiar ni sobrescribir mediante una llamada al método connect con una familia de direcciones diferente.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Consulte también

• IPEndPoint

UdpClient(AddressFamily)

Source:

UDPClient.cs

Inicializa una nueva instancia de la clase 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)

Parámetros

family

AddressFamily

Uno de los valores AddressFamily que especifica el esquema de direccionamiento del socket.

Excepciones

ArgumentException

family no es InterNetwork ni InterNetworkV6.

SocketException

Se produjo un error al acceder al socket.

Comentarios

El family parámetro determina si el agente de escucha usa una dirección IP versión 4 (IPv4) o una dirección IP versión 6 (IPv6). Para usar una dirección IPv4, pase el InterNetwork valor . Para usar una dirección IPv6, pase el InterNetworkV6 valor . Si se pasa cualquier otro valor, el método producirá una ArgumentExceptionexcepción .

Si se usa este constructor, la UdpClient instancia se establece con la familia de direcciones especificada por el family parámetro que no se puede cambiar ni sobrescribir mediante una llamada al método connect con una familia de direcciones diferente.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

No UdpClient.UdpClient(AddressFamily) es adecuado para unirse a un grupo de multidifusión porque no realiza el enlace de sockets.

UdpClient(Int32, AddressFamily)

Source:

UDPClient.cs

Inicializa una nueva instancia de la clase UdpClient y la enlaza con el número de puerto local especificado.

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)

Parámetros

port

Int32

Puerto en el cual se escucharán los intentos de conexión entrantes.

family

AddressFamily

Uno de los valores AddressFamily que especifica el esquema de direccionamiento del socket.

Excepciones

ArgumentException

family no es InterNetwork ni InterNetworkV6.

ArgumentOutOfRangeException

port es mayor que MaxPort o menor que MinPort.

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un cliente UDP para usarlo en un grupo de multidifusión.

// 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)

Comentarios

Este constructor crea un subyacente Socket y lo enlaza al número de puerto desde el que se va a comunicar.

El family parámetro determina si el agente de escucha usa una dirección IP versión 4 (IPv4) o una dirección IP versión 6 (IPv6). Para usar una dirección IPv4, pase el InterNetwork valor . Para usar una dirección IPv6, pase el InterNetworkV6 valor . Si se pasa cualquier otro valor, el método producirá una ArgumentExceptionexcepción .

Si se usa este constructor, la UdpClient instancia se establece con la familia de direcciones especificada por el family parámetro que no se puede cambiar ni sobrescribir mediante una llamada al método connect con una familia de direcciones diferente.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, consulte la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

UdpClient(String, Int32)

Source:

UDPClient.cs

Inicializa una nueva instancia de la clase UdpClient y establece un host remoto predeterminado.

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)

Parámetros

hostname

String

Nombre del host DNS (Sistema de nombres de dominio) remoto al que se desea conectar.

port

Int32

Número de puerto remoto al que se desea conectar.

Excepciones

ArgumentNullException

hostname es null.

ArgumentOutOfRangeException

port no se encuentra en el intervalo definido por MinPort y MaxPort.

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una instancia de la UdpClient clase mediante un nombre de host y un número de puerto.

//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

Comentarios

Este constructor inicializa un nuevo UdpClient y establece un host remoto mediante los hostname parámetros y port . Establecer un host remoto predeterminado es opcional. Si usa este constructor, no tiene que especificar un host remoto en cada llamada al Send método . Al especificar un host remoto predeterminado, solo se limita a ese host. Puede cambiar el host remoto predeterminado en cualquier momento llamando al Connect método . Si desea especificar un host remoto en la Send llamada al método , no use este constructor.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Consulte también

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