UdpClient.Connect Método

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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 seguinte usa um IPEndPoint para estabelecer um host remoto predefinido.

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

Observações

O Connect método estabelece um host remoto predefinido usando o valor especificado no endPoint parâmetro. Uma vez estabelecido, não é necessário especificar um host remoto em cada chamada ao Send método.

Estabelecer um host remoto por defeito é opcional. Especificar um host remoto por defeito limita-te apenas a esse host. Se quiser enviar datagramas para um host remoto diferente, deve fazer outra chamada ao Connect método ou criar outra UdpClient sem um host remoto predefinido. Se estabeleceu um host remoto por defeito e também fornece um host remoto na sua chamada ao Send método, Send irá lançar um SocketExceptionarquivo . Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar a documentação do código de erro da API Windows Sockets versão 2<> para uma descrição detalhada do erro.

Se chamar o Connect método, quaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Não pode definir o host remoto predefinido para um endereço de broadcast usando este método, a menos que herde de UdpClient, use o método Client para obter o subjacente Socket, e defina a opção socket para SocketOptionName.Broadcast.

No entanto, pode transmitir dados para o endereço de transmissão predefinido, 255.255.255.255, se especificar IPAddress.Broadcast na sua chamada ao Send método. Se a sua aplicação exigir maior controlo sobre os endereços de broadcast, também pode voltar a usar a Socket classe.

Ver também

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

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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 seguinte utiliza um endereço IP e um número de porta para se ligar a 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

Observações

O Connect método estabelece um host remoto predefinido usando os valores especificados nos addr parâmetros e.port Uma vez estabelecido, não é necessário especificar um host remoto em cada chamada ao Send método.

Estabelecer um host remoto por defeito é opcional. Especificar um host remoto por defeito limita-te apenas a esse host. Se quiser enviar datagramas para um host remoto diferente, deve fazer outra chamada ao Connect método ou criar outra UdpClient sem um host remoto predefinido. Se estabeleceu um host remoto por defeito e também fornece um host remoto na sua chamada ao Send método, Send irá lançar um SocketExceptionarquivo . Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar a documentação do código de erro da API Windows Sockets versão 2<> para uma descrição detalhada do erro.

Se chamar o Connect método, quaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Não pode definir o host remoto predefinido para um endereço de broadcast usando este método, a menos que herde de UdpClient, use o método cliente para obter o subjacente Socket, e defina a opção socket para SocketOptionName.Broadcast.

No entanto, pode transmitir dados para o endereço de transmissão predefinido, 255.255.255.255, se especificar IPAddress.Broadcast na sua chamada ao Send método. Se a sua aplicação exigir maior controlo sobre os endereços de broadcast, também pode voltar a usar a Socket classe.

Ver também

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

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

Origem:

UDPClient.cs

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 seguinte utiliza o nome do host e o número de porta para se ligar 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

Observações

O Connect método estabelece um host remoto predefinido usando os valores especificados nos port parâmetros e.hostname Uma vez estabelecido, não é necessário especificar um host remoto em cada chamada ao Send método.

Estabelecer um host remoto por defeito é opcional. Especificar um host remoto por defeito limita-te apenas a esse host. Se quiser enviar datagramas para um host remoto diferente, deve fazer outra chamada ao Connect método ou criar outra UdpClient sem um host remoto predefinido.

Se estabeleceu um host remoto por defeito e também fornece um host remoto na sua chamada ao Send método, Send irá lançar um SocketExceptionarquivo . Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar a documentação do código de erro da API Windows Sockets versão 2<> para uma descrição detalhada do erro.

Se chamar o Connect método, quaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Não pode definir o host remoto predefinido para um endereço de broadcast usando este método, a menos que herde de UdpClient, use o método cliente para obter o subjacente Socket, e defina a opção socket para SocketOptionName.Broadcast.

No entanto, pode transmitir dados para o endereço de transmissão predefinido, 255.255.255.255, se especificar IPAddress.Broadcast na sua chamada ao Send método. Se a sua aplicação exigir maior controlo sobre os endereços de broadcast, também pode voltar a usar a Socket classe.

Ver também

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