TcpListener.Start メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

受信接続要求のリッスンを開始します。

オーバーロード

Start()	受信接続要求のリッスンを開始します。
Start(Int32)	最大数の保留中の接続がある状態で、受信接続要求のリッスンを開始します。

Start()

ソース:

TCPListener.cs

受信接続要求のリッスンを開始します。

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

例外

SocketException

ErrorCode プロパティを使用して特定のエラー コードを取得します。 このコードを取得したら、Windows Sockets Version 2 API エラー コードのマニュアルからエラーの詳細情報を確認できます。

例

次のコード例では、 を使用して受信クライアント接続の試行をリッスンする方法 Start を示します。

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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スローされます。

受信接続キューから接続を削除するには、 メソッドまたは メソッドをAcceptTcpClientAcceptSocket使用します。 メソッドは AcceptTcpClient キューから接続を削除し、データの送受信に使用できる を返 TcpClient します。 メソッドは AcceptSocket 、同じ操作を行うために使用できる を返 Socket します。 アプリケーションで同期 I/O のみが必要な場合は、 を使用します AcceptTcpClient。 より詳細な動作制御を行う場合は、 を使用します AcceptSocket。 どちらの方法も、キューで接続要求が使用可能になるまでブロックします。

メソッドを Stop 使用して を TcpListener 閉じ、リッスンを停止します。 受け入れられた接続を個別に閉じる必要があります。

Note

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

こちらもご覧ください

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• Stop()

Start(Int32)

ソース:

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

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

例外

SocketException

ソケットへのアクセス中にエラーが発生しました。

ArgumentOutOfRangeException

backlog パラメーターが 0 未満か、または使用できる接続の最大数を超えています。

InvalidOperationException

基になる Socket が null です。

例

次のコード例では、 を使用して受信クライアント接続の試行をリッスンする方法 Start を示します。

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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 する接続の最大数。

受信接続キューから接続を削除するには、 メソッドまたは メソッドをAcceptTcpClientAcceptSocket使用します。 メソッドは AcceptTcpClient キューから接続を削除し、データの送受信に使用できる を返 TcpClient します。 メソッドは AcceptSocket 、同じ操作を行うために使用できる を返 Socket します。 アプリケーションで同期 I/O のみが必要な場合は、 を使用します AcceptTcpClient。 より詳細な動作制御を行う場合は、 メソッドを使用 AcceptSocket します。 どちらの方法も、キューで接続要求が使用可能になるまでブロックします。

メソッドを Stop 使用して を TcpListener 閉じ、リッスンを停止します。 受け入れられた接続を個別に閉じる必要があります。

注意

SocketException.ErrorCode プロパティを使用して特定のエラー コードを取得してください。エラーの詳細については、Windows Socket Version 2 API のエラー コードに関するドキュメントを参照してください。

Note

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

こちらもご覧ください

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• AcceptSocket()
• Stop()