Socket.Listen メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
Listen() |
Socket をリッスン状態にします。 |
Listen(Int32) |
Socket をリッスン状態にします。 |
Listen()
Listen(Int32)
- ソース:
- Socket.cs
- ソース:
- Socket.cs
- ソース:
- Socket.cs
Socket をリッスン状態にします。
public:
void Listen(int backlog);
public void Listen (int backlog);
member this.Listen : int -> unit
Public Sub Listen (backlog As Integer)
パラメーター
- backlog
- Int32
保留中の接続のキューの最大長。
例外
ソケットへのアクセスを試行しているときにエラーが発生しました。
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 ソケット バージョン 2 API エラー コード のドキュメントを参照してください。 または BeginAccept を使用してAccept、キューからの接続を受け入れます。
注意
を呼び出す前に メソッドを Bind 呼び出す Listen必要があります。または Listen 、 SocketExceptionをスローします。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
注意
バックログ パラメーターは、オペレーティング システムによって異なる値に制限されます。 より大きな値を指定できますが、バックログはオペレーティング システムに基づいて制限されます。
こちらもご覧ください
適用対象
.NET