UdpClient.Connect Método

public:
 void Connect(System::Net::IPEndPoint ^ endPoint);

public void Connect(System.Net.IPEndPoint endPoint);

member this.Connect : System.Net.IPEndPoint -> unit

Public Sub Connect (endPoint As IPEndPoint)

Parâmetros

Exceções

Exemplos

O exemplo a seguir usa um IPEndPoint para estabelecer um host remoto padrão.

//Uses a remote endpoint to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);
try{
 udpClient.Connect(ipEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a remote endpoint to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
Try
   udpClient.Connect(ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Comentários

O Connect método estabelece um host remoto padrão usando o valor especificado no endPoint parâmetro. Depois de estabelecido, você não precisa especificar um host remoto em cada chamada para o Send método.

Estabelecer um host remoto padrão é opcional. Especificar um host remoto padrão limita você somente a esse host. Se você quiser enviar datagramas para um host remoto diferente, deverá fazer outra chamada para o Connect método ou criar outra UdpClient sem um host remoto padrão. Se você estabeleceu um host remoto padrão e também fornece um host remoto em sua chamada para o Send método, Send gerará um SocketException. Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode 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.

Se você chamar o método, todos os Connect datagrams que chegarem de um endereço diferente do padrão especificado serão descartados. Você não pode definir o host remoto padrão para um endereço de UdpClientdifusão usando esse método, a menos que você herde, use o método Client para obter o subjacente Sockete defina a opção de soquete como SocketOptionName.Broadcast.

No entanto, você pode transmitir dados para o endereço de transmissão padrão, 255.255.255.255, se você especificar IPAddress.Broadcast em sua chamada para o Send método. Se seu aplicativo exigir maior controle sobre endereços de transmissão, você também poderá reverter para usar a Socket classe.

Confira também

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)

public:
 void Connect(System::Net::IPAddress ^ addr, int port);

public void Connect(System.Net.IPAddress addr, int port);

member this.Connect : System.Net.IPAddress * int -> unit

Public Sub Connect (addr As IPAddress, port As Integer)

Parâmetros

Exceções

Exemplos

O exemplo a seguir usa um endereço IP e um número de porta para se conectar com um host remoto.

//Uses the IP address and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
try{
    udpClient.Connect(ipAddress, 11003);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Uses the IP address and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Try
   udpClient.Connect(ipAddress, 11003)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Comentários

O Connect método estabelece um host remoto padrão usando os valores especificados nos parâmetros eport.addr Depois de estabelecido, você não precisa especificar um host remoto em cada chamada para o Send método.

Estabelecer um host remoto padrão é opcional. Especificar um host remoto padrão limita você somente a esse host. Se você quiser enviar datagramas para um host remoto diferente, deverá fazer outra chamada para o Connect método ou criar outra UdpClient sem um host remoto padrão. Se você estabeleceu um host remoto padrão e também fornece um host remoto em sua chamada para o Send método, Send gerará um SocketException. Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode 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.

Se você chamar o método, todos os Connect datagrams que chegarem de um endereço diferente do padrão especificado serão descartados. Não é possível definir o host remoto padrão para um endereço de UdpClientdifusão usando esse método, a menos que você herde, use o método cliente para obter o subjacente Sockete defina a opção de soquete como SocketOptionName.Broadcast.

No entanto, você pode transmitir dados para o endereço de transmissão padrão, 255.255.255.255, se você especificar IPAddress.Broadcast em sua chamada para o Send método. Se seu aplicativo exigir maior controle sobre endereços de transmissão, você também poderá reverter para usar a Socket classe.

Confira também

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)

public:
 void Connect(System::String ^ hostname, int port);

public void Connect(string hostname, int port);

member this.Connect : string * int -> unit

Public Sub Connect (hostname As String, port As Integer)

Parâmetros

Exceções

Exemplos

O exemplo a seguir usa o nome do host e o número da porta para se conectar a um host remoto.

 //Uses a host name and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
try{
    udpClient.Connect("www.contoso.com", 11002);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a host name and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Try
   udpClient.Connect("www.contoso.com", 11002)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Comentários

O Connect método estabelece um host remoto padrão usando os valores especificados nos parâmetros ehostname.port Depois de estabelecido, você não precisa especificar um host remoto em cada chamada para o Send método.

Estabelecer um host remoto padrão é opcional. Especificar um host remoto padrão limita você somente a esse host. Se você quiser enviar datagramas para um host remoto diferente, deverá fazer outra chamada para o Connect método ou criar outra UdpClient sem um host remoto padrão.

Se você estabeleceu um host remoto padrão e também fornece um host remoto em sua chamada para o Send método, Send gerará um SocketException. Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode 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.

Se você chamar o método, todos os Connect datagrams que chegarem de um endereço diferente do padrão especificado serão descartados. Não é possível definir o host remoto padrão para um endereço de UdpClientdifusão usando esse método, a menos que você herde, use o método cliente para obter o subjacente Sockete defina a opção de soquete como SocketOptionName.Broadcast.

No entanto, você pode transmitir dados para o endereço de transmissão padrão, 255.255.255.255, se você especificar IPAddress.Broadcast em sua chamada para o Send método. Se seu aplicativo exigir maior controle sobre endereços de transmissão, você também poderá reverter para usar a Socket classe.

Confira também

• Socket
• Send(Byte[], Int32, IPEndPoint)
• Receive(IPEndPoint)