Socket.Bind(EndPoint) 메서드

정의

연결을 Socket 로컬 끝점을 사용 합니다.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)

매개 변수

localEP
EndPoint

로컬 EndPoint 연결할는 Socket합니다.The local EndPoint to associate with the Socket.

예외

localEPnull인 경우localEP is null.

소켓에 액세스하는 동안 오류가 발생했습니다.An error occurred when attempting to access the socket.

Socket이 닫혔습니다.The Socket has been closed.

호출 스택의 상위 호출자에게 요청된 작업을 수행할 권한이 없는 경우A caller higher in the call stack does not have permission for the requested operation.

예제

다음 코드 예에서는 바인드를 Socket 지정된 된 로컬 끝점을 사용 하 여 합니다.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

설명

사용 된 Bind 메서드 특정 로컬 끝점을 사용 하는 경우.Use the Bind method if you need to use a specific local endpoint. 호출 해야 합니다 Bind 호출 하기 전에 Listen 메서드.You must call Bind before you can call the Listen method. 호출할 필요가 없습니다 Bind 사용 하기 전에 Connect 메서드 특정 로컬 끝점을 사용 하는 제외 합니다.You do not need to call Bind before using the Connect method unless you need to use a specific local endpoint. 사용할 수는 Bind 프로토콜과 연결 지향 프로토콜 모두에서 메서드.You can use the Bind method on both connectionless and connection-oriented protocols.

호출 하기 전에 Bind, 로컬을 먼저 만들어야 IPEndPoint 에서 데이터를 전달 하려는입니다.Before calling Bind, you must first create the local IPEndPoint from which you intend to communicate data. 할당 되는 로컬 주소는 중요 하지 않은 경우 만들 수 있습니다는 IPEndPoint 를 사용 하 여 IPAddress.Any 주소 매개 변수 및 기본 서비스 공급자 가장 적합 한 네트워크 주소를 할당 합니다.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. 사용 되는 로컬 포트는 중요 하지 않은 경우 만들 수 있습니다는 IPEndPoint 포트 번호 0을 사용 합니다.If you do not care which local port is used, you can create an IPEndPoint using 0 for the port number. 이 경우 서비스 공급자에는 1024-5000 사이의 사용 가능한 포트 번호를 할당 합니다.In this case, the service provider will assign an available port number between 1024 and 5000.

호출 하 여 할당 된 로컬 네트워크 주소 및 포트 번호를 검색할 수 있습니다, 위의 접근 방식을 사용 하는 경우는 LocalEndPoint합니다.If you use the above approach, you can discover what local network address and port number has been assigned by calling the LocalEndPoint. 연결 지향 프로토콜을 사용 하는 경우 LocalEndPoint 에 대 한 호출을 수행한 후 될 때까지 할당 된 로컬 네트워크 주소를 반환 하지 것입니다 합니다 Connect 또는 EndConnect 메서드.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.

UDP 소켓을 받은 패킷에 대 한 인터페이스 정보를 수신 하려는 경우는 SetSocketOption 로 설정 하는 소켓 옵션을 사용 하 여 메서드를 명시적으로 호출 해야 PacketInformation 호출한 후 즉시는 Bind 메서드.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.

참고

호출 해야 멀티 캐스트 데이터 그램을 수신 하려는 경우는 Bind 멀티 캐스트 포트 번호를 사용 하 여 메서드.If you intend to receive multicast datagrams, you must call the Bind method with a multicast port number.

참고

호출 해야 합니다 Bind 메서드를 사용 하 여 연결 없는 데이터 그램을 수신 하려는 경우는 ReceiveFrom 메서드.You must call the Bind method if you intend to receive connectionless datagrams using the ReceiveFrom method.

참고

수신 되 면를 SocketException 호출할 때 합니다 Bind 메서드를 사용 하 여는 SocketException.ErrorCode 특정 오류 코드를 가져오는 속성입니다.If you receive a SocketException when calling the Bind method, use the SocketException.ErrorCode property to obtain the specific error code. 이 코드를 가져온 후에 참조를 Windows 소켓 버전 2 API 오류 코드 오류의 자세한 설명에 대 한 설명서입니다.After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

참고

응용 프로그램에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다.This member outputs trace information when you enable network tracing in your application. 자세한 내용은 .NET Framework의 네트워크 추적합니다.For more information, see Network Tracing in the .NET Framework.

보안

SocketPermission
정의한 호스트에서 연결을 수락 하기 위해 localEP합니다.for accepting connections from the host defined by localEP. 연결 된 열거형: AcceptAssociated enumeration: Accept

적용 대상

추가 정보