UdpClient.Connect Método

Definición

Espacio de nombres:: System.Net.Sockets

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Establece un host remoto predeterminado.

Sobrecargas

Nombre	Description
Connect(IPEndPoint)	Establece un host remoto predeterminado mediante el punto de conexión de red especificado.
Connect(IPAddress, Int32)	Establece un host remoto predeterminado mediante la dirección IP y el número de puerto especificados.
Connect(String, Int32)	Establece un host remoto predeterminado mediante el nombre de host y el número de puerto especificados.

Connect(IPEndPoint)

Establece un host remoto predeterminado mediante el punto de conexión de red 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

que IPEndPoint especifica el punto de conexión de red al que quiere enviar datos.

Excepciones

SocketException

Error al acceder al socket.

ArgumentNullException

endPoint es null.

ObjectDisposedException

UdpClient Está cerrado.

Ejemplos

En el ejemplo siguiente se usa un IPEndPoint para establecer un host remoto predeterminado.

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

Comentarios

El Connect método establece un host remoto predeterminado mediante el valor especificado en el endPoint parámetro . Una vez establecido, no es necesario especificar un host remoto en cada llamada al Send método .

Establecer un host remoto predeterminado es opcional. Especificar un host remoto predeterminado solo le limita a ese host. Si desea enviar datagramas a un host remoto diferente, debe realizar otra llamada al Connect método o crear otra UdpClient sin un host remoto predeterminado. Si ha establecido un host remoto predeterminado y también proporciona un host remoto en la Send llamada al método , Send iniciará una SocketExceptionexcepción . Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Si llama al Connect método , se descartarán los datagramas que lleguen desde una dirección distinta del valor predeterminado especificado. No se puede establecer el host remoto predeterminado en una dirección de difusión mediante este método a menos que herede de UdpClient, use el método Client para obtener el subyacente Sockety establezca la opción SocketOptionName.Broadcastde socket en .

Sin embargo, puede difundir datos a la dirección de difusión predeterminada, 255.255.255.255, si especifica IPAddress.Broadcast en la llamada al Send método . Si la aplicación requiere un mayor control sobre las direcciones de difusión, también puede revertir al uso de la Socket clase .

Note

Dado que el protocolo UDP no tiene conexión, el Connect método no se bloquea. No llame al Connect método si piensa recibir datagramas multidifusión.

Consulte también

Se aplica a

Connect(IPAddress, Int32)

Establece un host remoto predeterminado mediante la dirección IP y el número de puerto 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

IPAddress del host remoto al que desea enviar datos.

port: Int32

Número de puerto al que quiere enviar datos.

Excepciones

ObjectDisposedException

UdpClient está cerrado.

ArgumentNullException

addr es null.

ArgumentOutOfRangeException

port no está entre MinPort y MaxPort.

SocketException

Error al acceder al socket.

Ejemplos

En el ejemplo siguiente se usa una dirección IP y un número de puerto para conectarse con un 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

Comentarios

El Connect método establece un host remoto predeterminado mediante los valores especificados en los addr parámetros y port . Una vez establecido, no es necesario especificar un host remoto en cada llamada al Send método .

Si llama al Connect método , se descartarán los datagramas que lleguen desde una dirección distinta del valor predeterminado especificado. No se puede establecer el host remoto predeterminado en una dirección de difusión mediante este método a menos que herede de UdpClient, use el método cliente para obtener el subyacente Sockety establezca la opción SocketOptionName.Broadcastde socket en .

Note

Dado que el protocolo UDP no tiene conexión, el Connect método no se bloquea. No llame al Connect método si piensa recibir datagramas multidifusión.

Consulte también

Se aplica a

Connect(String, Int32)

Establece un host remoto predeterminado mediante el nombre de host y el número de puerto 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

Nombre DNS del host remoto al que quiere enviar datos.

port: Int32

Número de puerto en el host remoto al que desea enviar datos.

Excepciones

ObjectDisposedException

UdpClient Está cerrado.

ArgumentOutOfRangeException

port no está entre MinPort y MaxPort.

SocketException

Error al acceder al socket.

Ejemplos

En el ejemplo siguiente se usa el nombre de host y el número de puerto para conectarse a un 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

Comentarios

El Connect método establece un host remoto predeterminado mediante los valores especificados en los port parámetros y hostname . Una vez establecido, no es necesario especificar un host remoto en cada llamada al Send método .

Si ha establecido un host remoto predeterminado y también proporciona un host remoto en la Send llamada al método , Send iniciará una SocketExceptionexcepción . Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Si llama al Connect método , se descartarán los datagramas que lleguen desde una dirección distinta del valor predeterminado especificado. No se puede establecer el host remoto predeterminado en una dirección de difusión mediante este método a menos que herede de UdpClient, use el método cliente para obtener el subyacente Sockety establezca la opción SocketOptionName.Broadcastde socket en .

Note

Dado que el protocolo UDP no tiene conexión, el Connect método no se bloquea. No llame al Connect método si piensa recibir datagramas multidifusión.

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?