Associates a Socket with a local endpoint.
Assembly: System (in System.dll)
localEP is null.
An error occurred when attempting to access the socket. See the Remarks section for more information.
The Socket has been closed.
A caller higher in the call stack does not have permission for the requested operation.
Use the method if you need to use a specific local endpoint. You must call before you can call the Listen method. You do not need to call before using the Connect method unless you need to use a specific local endpoint. You can use the method on both connectionless and connection-oriented protocols.
Before calling , you must first create the local IPEndPoint from which you intend to communicate data. 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. This might help simplify your application if you have multiple network interfaces. If you do not care which local port is used, you can create an IPEndPoint using 0 for the port number. In this case, the service provider will assign an available port number between 1024 and 5000.
If you use the above approach, you can discover what local network address and port number has been assigned by calling the LocalEndPoint. 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. If you are using a connectionless protocol, you will not have access to this information until you have completed a send or receive.
If you intend to receive multicast datagrams, you must call the method with a multicast port number.
You must call the method if you intend to receive connectionless datagrams using the ReceiveFrom method.
If you receive a SocketException when calling the method, use the SocketException.ErrorCode property to obtain the specific error code. After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation in the MSDN library for a detailed description of the error.
This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.
The following code example binds a Socket using the specified local endpoint.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.