TcpListener.Start メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
着信接続要求のリッスンを開始します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Start() |
着信接続要求のリッスンを開始します。 |
| Start(Int32) |
保留中の接続の最大数で受信接続要求のリッスンを開始します。 |
Start()
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
着信接続要求のリッスンを開始します。
public:
void Start();
public void Start();
member this.Start : unit -> unit
Public Sub Start ()
例外
特定のエラー コードを取得するには、 ErrorCode プロパティを使用します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
例
次のコード例は、 Start を使用して着信クライアント接続の試行をリッスンする方法を示しています。
public static void DoStart(TcpListener t, int backlog)
{
// Start listening for client connections with the
// specified backlog.
t.Start(backlog);
Console.WriteLine("started listening");
}
Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
' Start listening for client connections with the
' specified backlog.
t.Start(backlog)
Console.WriteLine("started listening")
End Sub
注釈
Start メソッドは、基になるSocketを初期化し、ローカル エンドポイントにバインドして、受信接続の試行をリッスンします。 接続要求を受信した場合、 Start メソッドは要求をキューに入れ、 Stop メソッドを呼び出すまで追加の要求をリッスンし続けます。 接続の最大数を既にキューに入れた後に接続要求を受信した TcpListener は、クライアントに SocketException をスローします。
受信接続キューから接続を削除するには、 AcceptTcpClient メソッドまたは AcceptSocket メソッドを使用します。 AcceptTcpClientメソッドは、キューから接続を削除し、データの送受信に使用できるTcpClientを返します。 AcceptSocket メソッドは、同じ操作に使用できるSocketを返します。 アプリケーションで同期 I/O のみが必要な場合は、 AcceptTcpClientを使用します。 より詳細な動作制御を行うには、 AcceptSocketを使用します。 どちらの方法も、接続要求がキューで使用可能になるまでブロックされます。
TcpListenerを閉じてリッスンを停止するには、Stop メソッドを使用します。 受け入れられた接続を個別に閉じる必要があります。
注
このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「 .NET Framework のネットワーク トレース」を参照してください。
こちらもご覧ください
適用対象
Start(Int32)
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
- ソース:
- TCPListener.cs
保留中の接続の最大数で受信接続要求のリッスンを開始します。
public:
void Start(int backlog);
public void Start(int backlog);
member this.Start : int -> unit
Public Sub Start (backlog As Integer)
パラメーター
- backlog
- Int32
保留中の接続キューの最大長。
例外
ソケットへのアクセス中にエラーが発生しました。
backlog パラメーターが 0 未満であるか、許可されている接続の最大数を超えています。
基になる Socket が null です。
例
次のコード例は、 Start を使用して着信クライアント接続の試行をリッスンする方法を示しています。
public static void DoStart(TcpListener t, int backlog)
{
// Start listening for client connections with the
// specified backlog.
t.Start(backlog);
Console.WriteLine("started listening");
}
Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
' Start listening for client connections with the
' specified backlog.
t.Start(backlog)
Console.WriteLine("started listening")
End Sub
注釈
Start メソッドは、基になるSocketを初期化し、ローカル エンドポイントにバインドして、受信接続の試行をリッスンします。 接続要求を受信した場合、 Start は要求をキューに入れ、 Stop メソッドを呼び出すまで追加の要求をリッスンし続けます。 既にキューに入れた後 TcpListener 接続要求を受信すると、クライアントに SocketException がスローされます。
受信接続キューから接続を削除するには、 AcceptTcpClient メソッドまたは AcceptSocket メソッドを使用します。 AcceptTcpClientメソッドは、キューから接続を削除し、データの送受信に使用できるTcpClientを返します。 AcceptSocket メソッドは、同じ操作に使用できるSocketを返します。 アプリケーションで同期 I/O のみが必要な場合は、 AcceptTcpClientを使用します。 より詳細な動作制御を行うには、 AcceptSocket メソッドを使用します。 どちらの方法も、接続要求がキューで使用可能になるまでブロックされます。
TcpListenerを閉じてリッスンを停止するには、Stop メソッドを使用します。 受け入れられた接続を個別に閉じる必要があります。
注
SocketException.ErrorCodeプロパティを使用して特定のエラー コードを取得し、エラーの詳細な説明については Windows ソケット バージョン 2 API のエラー コードドキュメントを参照してください。
注
このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「 .NET Framework のネットワーク トレース」を参照してください。