UdpClient.Connect Método

  • Referencia

Definición

Espacio de nombres:
System.Net.Sockets
Ensamblado:
System.Net.Sockets.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Establece un host remoto predeterminado.

Sobrecargas

Connect(IPEndPoint)

Establece un host remoto predeterminado mediante el extremo 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)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Establece un host remoto predeterminado mediante el extremo 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

IPEndPoint que especifica el extremo de red al que desea enviar datos.

Excepciones

SocketException

Se produjo un error al acceder al socket.

ArgumentNullException

endPoint es null.

ObjectDisposedException

La clase UdpClient está cerrada.

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

Comentarios

El Connect método establece un host remoto predeterminado con 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. Al especificar un host remoto predeterminado, solo se limita a ese host. Si desea enviar datagramas a un host remoto diferente, debe realizar otra llamada al Connect método o crear otro 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 producirá 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 .

Nota

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)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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 desea enviar datos.

Excepciones

ObjectDisposedException

UdpClient está cerrado.

ArgumentNullException

addr es null.

ArgumentOutOfRangeException

port no se encuentra en el intervalo definido por MinPort y MaxPort.

SocketException

Se produjo un 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 = 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

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 .

Establecer un host remoto predeterminado es opcional. Al especificar un host remoto predeterminado, solo se limita a ese host. Si desea enviar datagramas a un host remoto diferente, debe realizar otra llamada al Connect método o crear otro 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 producirá 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 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 .

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 .

Nota

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)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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 desea enviar datos.

port
Int32

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

Excepciones

ObjectDisposedException

La clase UdpClient está cerrada.

ArgumentOutOfRangeException

port no se encuentra en el intervalo definido por MinPort y MaxPort.

SocketException

Se produjo un 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 = 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

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 .

Establecer un host remoto predeterminado es opcional. Al especificar un host remoto predeterminado, solo se limita a ese host. Si desea enviar datagramas a un host remoto diferente, debe realizar otra llamada al Connect método o crear otro 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 producirá 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 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 .

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 .

Nota

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