Socket.Listen メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

アセンブリ:

System.dll, System.Net.Sockets.dll

アセンブリ:

System.dll

アセンブリ:

netstandard.dll

オーバーロード

Listen()	Socket をリッスン状態にします。
Listen(Int32)	Socket をリッスン状態にします。

Listen()

Socket をリッスン状態にします。

public:
 void Listen();

public void Listen ();

member this.Listen : unit -> unit

Public Sub Listen ()

注釈

保留中の接続キューの最大長は、自動的に決定されます。

Listen(Int32)

Socket をリッスン状態にします。

public:
 void Listen(int backlog);

public void Listen (int backlog);

member this.Listen : int -> unit

Public Sub Listen (backlog As Integer)

パラメーター

backlog

Int32

保留中の接続のキューの最大長。

例外

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

例

次のコード例では、受信接続をリッスンするために使用 Socket します。

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

注釈

Listen は、接続指向 Socket で受信接続の試行をリッスンします。 このパラメーターは backlog 、受け入れのためにキューに入れることができる受信接続の数を指定します。 指定できる接続の最大数を確認するには、値を取得します MaxConnections 。 Listen はブロックしません。

受け取った場合は SocketException、プロパティを ErrorCode 使用して特定のエラー コードを取得します。 このコードを取得した後、エラーの詳細な説明については、Windows Sockets バージョン 2 API エラー コードのドキュメントを参照してください。 キューからの接続を使用 Accept または BeginAccept 受け入れます。

注意

呼び出す前にメソッドを Bind 呼び出す Listen必要があります。または Listen 、次のメソッドを SocketExceptionスローします。

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

注意

バックログ パラメーターは、オペレーティング システムによって異なる値に制限されます。 より大きな値を指定できますが、バックログはオペレーティング システムに基づいて制限されます。

こちらもご覧ください

• MaxConnections
• Accept()
• Bind(EndPoint)