UdpClient Construtores

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Exceções

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.

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.

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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

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

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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

Confira também

• IPEndPoint

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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

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.

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

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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

Confira também

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