UdpClient Construtores

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Inicializa uma nova instância da classe UdpClient.

Sobrecargas

UdpClient()	Inicializa uma nova instância da classe UdpClient.
UdpClient(Int32)	Inicializa uma nova instância da classe UdpClient e a associa ao número da porta local fornecido.
UdpClient(IPEndPoint)	Inicializa uma nova instância da classe UdpClient e a associa ao ponto de extremidade local especificado.
UdpClient(AddressFamily)	Inicializa uma nova instância da classe UdpClient.
UdpClient(Int32, AddressFamily)	Inicializa uma nova instância da classe UdpClient e a associa ao número da porta local fornecido.
UdpClient(String, Int32)	Inicializa uma nova instância da classe UdpClient e estabelece um host remoto padrão.

UdpClient()

Origem:

UDPClient.cs

Inicializa uma nova instância da classe UdpClient.

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Exceções

SocketException

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo a seguir 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 = 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()

Comentários

Esse construtor cria um novo UdpClient e permite que o provedor de serviços subjacente atribua o endereço IPv4 local mais apropriado e o número da porta. Se esse construtor for usado, a UdpClient instância será definida com uma família de endereços IPv4 que não pode ser alterada ou substituída por uma chamada de método connect com um destino IPv6.

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Esse construtor não é adequado para ingressar em um grupo multicast porque não executa a associação de soquete. Além disso, ele funciona apenas com tipos de endereço IPv4.

UdpClient(Int32)

Origem:

UDPClient.cs

Inicializa uma nova instância da classe UdpClient e a associa ao número da porta local fornecido.

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

O número da porta local do qual você pretende se comunicar.

Exceções

ArgumentOutOfRangeException

O parâmetro port é maior que MaxPort ou menor que MinPort.

SocketException

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo a seguir 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 = 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

Comentários

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

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Esse construtor funciona apenas com tipos de endereço IPv4.

UdpClient(IPEndPoint)

Origem:

UDPClient.cs

Inicializa uma nova instância da classe UdpClient e a associa ao ponto de extremidade 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

Um IPEndPoint que representa o ponto de extremidade local ao qual você associa a conexão UDP.

Exceções

ArgumentNullException

localEP é null.

SocketException

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo a seguir demonstra como criar uma instância da UdpClient classe usando um ponto de extremidade 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

Comentários

Esse construtor cria um novo UdpClient e o associa ao IPEndPoint especificado pelo localEP parâmetro . Antes de chamar esse construtor, você deve criar um IPEndPoint usando o endereço IP e o número da porta do qual pretende enviar e receber dados. Você não precisa especificar um endereço IP local e um número de porta para enviar e receber dados. Se você não fizer isso, o provedor de serviços subjacente atribuirá o endereço IP local e o número da porta mais apropriados.

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

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Confira também

• IPEndPoint

UdpClient(AddressFamily)

Origem:

UDPClient.cs

Inicializa uma nova instância da 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)

Parâmetros

family

AddressFamily

Um dos valores AddressFamily que especifica o esquema de endereçamento do soquete.

Exceções

ArgumentException

family não é InterNetwork ou InterNetworkV6.

SocketException

Ocorreu um erro ao acessar o soquete.

Comentários

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

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

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

O UdpClient.UdpClient(AddressFamily) não é adequado para ingressar em um grupo multicast porque não executa a associação de soquete.

UdpClient(Int32, AddressFamily)

Origem:

UDPClient.cs

Inicializa uma nova instância da classe UdpClient e a associa ao número da porta local fornecido.

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

A porta na qual escutar tentativas de conexão de entrada.

family

AddressFamily

Um dos valores AddressFamily que especifica o esquema de endereçamento do soquete.

Exceções

ArgumentException

family não é InterNetwork ou InterNetworkV6.

ArgumentOutOfRangeException

port é maior que MaxPort ou menor que MinPort.

SocketException

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo de código a seguir mostra como criar um cliente UDP para usar em um 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 = 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)

Comentários

Esse construtor cria um subjacente Socket e o associa ao número da porta do qual você pretende se comunicar.

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

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

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, consulte a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

UdpClient(String, Int32)

Origem:

UDPClient.cs

Inicializa uma nova instância da classe UdpClient e estabelece um host remoto padrão.

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

O nome host DNS remoto ao qual você pretende se conectar.

port

Int32

O número da porta remota à qual você pretende se conectar.

Exceções

ArgumentNullException

hostname é null.

ArgumentOutOfRangeException

port não está entre MinPort e MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

Exemplos

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

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

Comentários

Esse construtor inicializa um novo UdpClient e estabelece um host remoto usando os hostname parâmetros e port . Estabelecer um host remoto padrão é opcional. Se você usar esse construtor, não precisará especificar um host remoto em cada chamada para o Send método . Especificar um host remoto padrão limita você somente a esse host. Você pode alterar o host remoto padrão a qualquer momento chamando o Connect método . Se você quiser especificar um host remoto em sua chamada para o Send método , não use esse construtor.

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Confira também

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