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

定義

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

Socket に関連付けるローカル EndPointThe local EndPoint to associate with the Socket.

例外

ソケットへのアクセスを試行しているときにエラーが発生しました。An error occurred when attempting to access the socket.

コール スタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。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 Sockets version 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

適用対象

こちらもご覧ください