Socket.Listen(Int32) Socket.Listen(Int32) Socket.Listen(Int32) Socket.Listen(Int32) Method

定義

Socket をリッスン状態にします。Places a Socket in a listening state.

public:
 void Listen(int backlog);
public void Listen (int backlog);
member this.Listen : int -> unit
Public Sub Listen (backlog As Integer)

パラメーター

backlog
Int32 Int32 Int32 Int32

保留中の接続のキューの最大長。The maximum length of the pending connections queue.

例外

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

次のコード例ではSocket着信接続をリッスンするようにします。The following code example uses Socket to listen for incoming connections.

// create the socket
Socket^ listenSocket = gcnew Socket( AddressFamily::InterNetwork,
   SocketType::Stream,
   ProtocolType::Tcp );

// bind the listening socket to the port
IPAddress^ hostIP = ( Dns::Resolve( IPAddress::Any->ToString() ) )->AddressList[ 0 ];
IPEndPoint^ ep = gcnew IPEndPoint( hostIP,port );
listenSocket->Bind( ep );

// start listening
listenSocket->Listen( backlog );
       // create the socket
       Socket listenSocket = new Socket(AddressFamily.InterNetwork, 
                                        SocketType.Stream,
                                        ProtocolType.Tcp);

       // bind the listening socket to the port
IPAddress hostIP = (Dns.Resolve(IPAddress.Any.ToString())).AddressList[0];
       IPEndPoint ep = new IPEndPoint(hostIP, port);
       listenSocket.Bind(ep); 

       // start listening
       listenSocket.Listen(backlog);
   ' create the socket
   Dim listenSocket As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
   
   ' bind the listening socket to the port
   Dim hostIP As IPAddress = Dns.Resolve(IPAddress.Any.ToString()).AddressList(0)
   Dim ep As New IPEndPoint(hostIP, port)
   listenSocket.Bind(ep)
   
   ' start listening
   listenSocket.Listen(backlog)
End Sub 'CreateAndListen

注釈

Listen 接続指向によりSocket受信接続の試行をリッスンするようにします。Listen causes a connection-oriented Socket to listen for incoming connection attempts. backlogパラメーターが承認キューに置かれることが着信接続の数を指定します。The backlog parameter specifies the number of incoming connections that can be queued for acceptance. 指定できる接続の最大数を確認するのには、取得、MaxConnections値。To determine the maximum number of connections you can specify, retrieve the MaxConnections value. Listen ブロックされません。Listen does not block.

表示された場合、SocketExceptionを使用して、ErrorCode特定のエラー コードを取得するプロパティ。If you receive a SocketException, use the 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. 使用AcceptまたはBeginAcceptキューからの接続を受け入れます。Use Accept or BeginAccept to accept a connection from the queue.

注意

呼び出す必要があります、Bindメソッドを呼び出す前にListen、またはListenがスローされます、SocketExceptionします。You must call the Bind method before calling Listen, or Listen will throw a SocketException.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。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.

注意

バックログのパラメーターは、オペレーティング システムに応じて異なる値に制限されます。The backlog parameter is limited to different values depending on the Operating System. 高い値を指定することがありますが、バックログが制限されます、オペレーティング システムに基づきます。You may specify a higher value, but the backlog will be limited based on the Operating System.

適用対象

こちらもご覧ください