UdpClient Construtores

public:
 UdpClient();

public UdpClient();

Public Sub New ()

Exceções

Exemplos

O exemplo seguinte demonstra como usar o construtor sem parâmetros para criar uma instância da 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()

Observações

Este construtor cria um novo UdpClient e permite ao fornecedor de serviços subjacente atribuir o endereço local IPv4 e o número de porta mais apropriados. Se este construtor for utilizado, a UdpClient instância é definida com uma família de endereços IPv4 que não pode ser alterada ou sobrescrevida por uma chamada de método connect com um destino IPv6.

Este construtor não é adequado para juntar um grupo multicast porque não realiza binding de sockets. Além disso, só funciona com tipos de endereço 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)

Parâmetros

Exceções

Exemplos

O exemplo seguinte demonstra o uso de um número de porta local para criar uma instância da 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

Observações

Este construtor cria um subjacente Socket e liga-o ao número de porta a partir do qual pretende comunicar. Use este construtor se estiver apenas interessado em definir o número da porta local. O fornecedor de serviços subjacente atribuirá o endereço IP local. Se passar 0 ao construtor, o fornecedor de serviço subjacente atribuirá um número de porta. Se este construtor for utilizado, a UdpClient instância é definida com uma família de endereços IPv4 que não pode ser alterada ou sobrescrevida por uma chamada de método connect com um destino IPv6.

Este construtor funciona apenas com tipos de endereço 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)

Parâmetros

Exceções

Exemplos

O exemplo seguinte demonstra como criar uma instância da UdpClient classe usando um endpoint 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

Observações

Este construtor cria um novo UdpClient e liga-o ao IPEndPoint especificado pelo localEP parâmetro. Antes de chamar este construtor, deve criar um IPEndPoint usando o endereço IP e o número de porta a partir dos quais pretende enviar e receber dados. Não precisa de especificar um endereço IP local nem um número de porta para enviar e receber dados. Se não o fizer, o fornecedor de serviços subjacente atribuirá o endereço IP local e o número de porta mais apropriados.

Se este construtor for usado, a UdpClient instância é definida com a família de endereços especificada pelo localEP parâmetro que não pode ser alterada ou sobrescrevida por uma chamada de método connect com uma família de endereços diferente.

Ver também

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

Parâmetros

Exceções

Observações

O family parâmetro determina se o ouvinte utiliza um endereço IP versão 4 (IPv4) ou um endereço IP versão 6 (IPv6). Para usar um endereço IPv4, passa o InterNetwork valor. Para usar um endereço IPv6, passa o InterNetworkV6 valor. Passar qualquer outro valor fará com que o método lance um ArgumentException.

Se este construtor for usado, a UdpClient instância é definida com a família de endereços especificada pelo family parâmetro que não pode ser alterada ou sobrescrevida por uma chamada de método connect com uma família de endereços diferente.

O UdpClient.UdpClient(AddressFamily) não é adequado para juntar um grupo multicast porque não realiza binding de soquete.

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

Exceções

Exemplos

O exemplo de código seguinte mostra como criar um cliente UDP para usar num grupo multicast.

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

Observações

Este construtor cria um subjacente Socket e liga-o ao número de porta a partir do qual pretende comunicar.

O family parâmetro determina se o ouvinte utiliza um endereço IP versão 4 (IPv4) ou um endereço IP versão 6 (IPv6). Para usar um endereço IPv4, passa o InterNetwork valor. Para usar um endereço IPv6, passa o InterNetworkV6 valor. Passar qualquer outro valor fará com que o método lance um ArgumentException.

Se este construtor for usado, a UdpClient instância é definida com a família de endereços especificada pelo family parâmetro que não pode ser alterada ou sobrescrevida por uma chamada de método connect com uma família de endereços diferente.

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

Exceções

Exemplos

O exemplo seguinte demonstra como criar uma instância da UdpClient classe usando um nome de host e número de porta.

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

Observações

Este construtor inicializa um novo UdpClient e estabelece um host remoto usando os hostname parâmetros e port . Estabelecer um host remoto por defeito é opcional. Se usar este construtor, não precisa de especificar um host remoto em cada chamada ao Send método. Especificar um host remoto por defeito limita-te apenas a esse host. Pode mudar o host remoto predefinido a qualquer momento, chamando o Connect método. Se quiser especificar um host remoto na sua chamada ao Send método, não use este construtor.

Ver também

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