UdpClient.Connect Método

Referência

Definição

Namespace:: System.Net.Sockets

Assembly:: System.Net.Sockets.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Estabelece um host remoto padrão.

Sobrecargas

Connect(IPEndPoint)	Estabelece um host remoto padrão usando o ponto de extremidade de rede especificado.
Connect(IPAddress, Int32)	Estabelece um host remoto padrão usando o endereço IP e o número da porta especificados.
Connect(String, Int32)	Estabelece um host remoto padrão usando o nome e o número da porta do host especificados.

Connect(IPEndPoint)

Origem:: UDPClient.cs

Origem:: UDPClient.cs

Origem:: UDPClient.cs

Estabelece um host remoto padrão usando o ponto de extremidade de rede especificado.

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

endPoint: IPEndPoint

Um IPEndPoint que especifica o ponto de extremidade de rede para o qual você pretende enviar os dados.

Exceções

SocketException

Ocorreu um erro ao acessar o soquete.

ArgumentNullException

endPoint é null.

ObjectDisposedException

O UdpClient está fechado.

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 = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
try
{
   udpClient->Connect( ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//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ê tiver estabelecido um host remoto padrão e também fornecer 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 datagramas que chegarem de um endereço diferente do padrão especificado serão descartados. Não é possível definir o host remoto padrão como um endereço de difusão usando esse método, a menos que você herde de UdpClient, 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 difusão padrão, 255.255.255.255, se você especificar IPAddress.Broadcast em sua chamada para o Send método . Se o aplicativo exigir maior controle sobre endereços de difusão, você também poderá reverter usar a Socket classe .

Observação

Como o protocolo UDP é sem conexão, o Connect método não é bloqueado. Não chame o Connect método se você pretende receber datagramas multicast.

Confira também

Aplica-se a

Connect(IPAddress, Int32)

Origem:: UDPClient.cs

Origem:: UDPClient.cs

Origem:: UDPClient.cs

Estabelece um host remoto padrão usando o endereço IP e o número da porta especificados.

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

addr: IPAddress

O IPAddress do host remoto ao qual você pretende enviar dados.

port: Int32

O número da porta à qual você pretende enviar dados.

Exceções

ObjectDisposedException

UdpClient está fechado.

ArgumentNullException

addr é null.

ArgumentOutOfRangeException

port não está entre MinPort e MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

Exemplos

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

//Uses the IP address and port number to establish a socket connection.
UdpClient^ udpClient = gcnew 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.
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 addr parâmetros e port . Depois de estabelecido, você não precisa especificar um host remoto em cada chamada para o Send método .

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

Observação

Como o protocolo UDP é sem conexão, o Connect método não é bloqueado. Não chame o Connect método se você pretende receber datagramas multicast.

Confira também

Aplica-se a

Connect(String, Int32)

Origem:: UDPClient.cs

Origem:: UDPClient.cs

Origem:: UDPClient.cs

Estabelece um host remoto padrão usando o nome e o número da porta do host especificados.

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

hostname: String

O nome DNS do host remoto ao qual você pretende enviar dados.

port: Int32

O número da porta no host remoto ao qual você pretende enviar dados.

Exceções

ObjectDisposedException

O UdpClient está fechado.

ArgumentOutOfRangeException

port não está entre MinPort e MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

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 = gcnew 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.
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 port parâmetros e hostname . Depois de estabelecido, você não precisa especificar um host remoto em cada chamada para o Send método .

Se você tiver estabelecido um host remoto padrão e também fornecer 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 datagramas que chegarem de um endereço diferente do padrão especificado serão descartados. Não é possível definir o host remoto padrão como um endereço de difusão usando esse método, a menos que você herde de UdpClient, use o método cliente para obter o subjacente Sockete defina a opção de soquete como SocketOptionName.Broadcast.

Observação

Como o protocolo UDP é sem conexão, o Connect método não é bloqueado. Não chame o Connect método se você pretende receber datagramas multicast.

Confira também

Aplica-se a

UdpClient.Connect Método

Definição

Sobrecargas

Connect(IPEndPoint)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Connect(IPAddress, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Connect(String, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Comentários

Recursos adicionais