Socket.Bind(EndPoint) Socket.Bind(EndPoint) Socket.Bind(EndPoint) Socket.Bind(EndPoint) Method

Definición

Asocia un objeto Socket a un extremo local.Associates a Socket with a local endpoint.

public:
 void Bind(System::Net::EndPoint ^ localEP);
public void Bind (System.Net.EndPoint localEP);
member this.Bind : System.Net.EndPoint -> unit
Public Sub Bind (localEP As EndPoint)

Parámetros

localEP
EndPoint EndPoint EndPoint EndPoint

EndPoint local que se va a asociar a Socket.The local EndPoint to associate with the Socket.

Excepciones

Error al intentar acceder al socket.An error occurred when attempting to access the socket.

Un llamador de la pila de llamadas no tiene permiso para la operación solicitada.A caller higher in the call stack does not have permission for the requested operation.

Ejemplos

En el siguiente ejemplo de código se Socket enlaza con el extremo local especificado.The following code example binds a Socket using the specified local endpoint.

try
{
   aSocket->Bind( anEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Winsock error: {0}", e );
}
try {
    aSocket.Bind(anEndPoint);
}
catch (Exception e) {
    Console.WriteLine("Winsock error: " + e.ToString());
}

Try
    aSocket.Bind(anEndPoint)
Catch e As Exception
    Console.WriteLine("Winsock error: " & e.ToString())
End Try

Comentarios

Use el Bind método si necesita usar un punto de conexión local específico.Use the Bind method if you need to use a specific local endpoint. Debe llamar a Bind para poder llamar al Listen método.You must call Bind before you can call the Listen method. No es necesario llamar Bind a antes de usar el Connect método a menos que necesite usar un punto de conexión local específico.You do not need to call Bind before using the Connect method unless you need to use a specific local endpoint. Puede usar el Bind método en los protocolos sin conexión y orientados a la conexión.You can use the Bind method on both connectionless and connection-oriented protocols.

Antes de Bindllamar a, primero debe crear la IPEndPoint local desde la que va a comunicar los datos.Before calling Bind, you must first create the local IPEndPoint from which you intend to communicate data. Si no le importa qué dirección local está asignada, puede crear una IPEndPoint mediante IPAddress.Any como parámetro de dirección, y el proveedor de servicios subyacente asignará la dirección de red más adecuada.If you do not care which local address is assigned, you can create an IPEndPoint using IPAddress.Any as the address parameter, and the underlying service provider will assign the most appropriate network address. Esto puede ayudar a simplificar la aplicación si tiene varias interfaces de red.This might help simplify your application if you have multiple network interfaces. Si no le importa qué puerto local se usa, puede crear un IPEndPoint con el valor 0 para el número de puerto.If you do not care which local port is used, you can create an IPEndPoint using 0 for the port number. En este caso, el proveedor de servicios asignará un número de puerto disponible entre 1024 y 5000.In this case, the service provider will assign an available port number between 1024 and 5000.

Si utiliza el enfoque anterior, puede detectar qué dirección de red local y número de puerto se han asignado mediante una llamada LocalEndPointa.If you use the above approach, you can discover what local network address and port number has been assigned by calling the LocalEndPoint. Si utiliza un protocolo orientado a la conexión, LocalEndPoint no devolverá la dirección de red asignada localmente hasta que haya realizado una llamada Connect al EndConnect método o.If you are using a connection-oriented protocol, LocalEndPoint will not return the locally assigned network address until after you have made a call to the Connect or EndConnect method. Si utiliza un protocolo sin conexión, no tendrá acceso a esta información hasta que haya completado un envío o una recepción.If you are using a connectionless protocol, you will not have access to this information until you have completed a send or receive.

Si un socket UDP desea recibir información de la interfaz de los paquetes recibidos, SetSocketOption se debe llamar explícitamente al método con la opción de PacketInformation socket establecida en inmediatamente Bind después de llamar al método.If a UDP socket wants to receive interface information on received packets, the SetSocketOption method should be explicitly called with the socket option set to PacketInformation immediately after calling the Bind method.

Nota

Si piensa recibir datagramas de multidifusión, debe llamar al Bind método con un número de puerto de multidifusión.If you intend to receive multicast datagrams, you must call the Bind method with a multicast port number.

Nota

Debe llamar al Bind método si piensa recibir datagramas sin conexión mediante el ReceiveFrom método.You must call the Bind method if you intend to receive connectionless datagrams using the ReceiveFrom method.

Nota

Si recibe una SocketException al llamar al Bind método, use la SocketException.ErrorCode propiedad para obtener el código de error específico.If you receive a SocketException when calling the Bind method, use the SocketException.ErrorCode property to obtain the specific error code. Después de obtener este código, consulte 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.After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación.This member outputs trace information when you enable network tracing in your application. Para obtener más información, consulte seguimiento de red en el .NET Framework.For more information, see Network Tracing in the .NET Framework.

Seguridad

SocketPermission
para aceptar conexiones del host definido por localEP.for accepting connections from the host defined by localEP. Enumeración asociada:AcceptAssociated enumeration: Accept

Se aplica a

Consulte también: