TcpListener.Start 메서드

정의

네임스페이스:

System.Net.Sockets

어셈블리:

System.Net.Sockets.dll

들어오는 연결 요청의 수신을 시작합니다.

오버로드

Start()	들어오는 연결 요청의 수신을 시작합니다.
Start(Int32)	최대 보류 연결 수로 들어오는 연결 요청에 대한 수신을 시작합니다.

Start()

Source:

TCPListener.cs

들어오는 연결 요청의 수신을 시작합니다.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

예외

SocketException

ErrorCode 속성을 사용하여 특정 오류 코드를 가져오십시오. 이 코드를 가져온 다음, Windows 소켓 버전 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 throw됩니다.

들어오는 연결 큐에서 연결을 제거하려면 메서드 또는 메서드를 AcceptSocket 사용합니다AcceptTcpClient. 메서드는 AcceptTcpClient 큐에서 연결을 제거하고 데이터를 보내고 받는 데 사용할 수 있는 을 반환 TcpClient 합니다. 메서드는 AcceptSocket 동일한 작업을 수행하는 데 사용할 수 있는 을 반환 Socket 합니다. 애플리케이션에 동기 I/O 필요한 경우 사용 하 여 AcceptTcpClient입니다. 자세한 동작 제어는 를 사용합니다 AcceptSocket. 이러한 두 메서드는 큐에서 연결 요청을 사용할 수 있게 될 때까지 차단됩니다.

메서드를 사용하여 를 Stop 닫 TcpListener 고 수신 대기를 중지합니다. 수락된 연결을 별도로 닫을 책임이 있습니다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의 네트워크 추적을 참조하세요.

추가 정보

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

Start(Int32)

Source:

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 throw합니다.

들어오는 연결 큐에서 연결을 제거하려면 메서드 또는 메서드를 AcceptSocket 사용합니다AcceptTcpClient. 메서드는 AcceptTcpClient 큐에서 연결을 제거하고 데이터를 보내고 받는 데 사용할 수 있는 을 반환 TcpClient 합니다. 메서드는 AcceptSocket 동일한 작업을 수행하는 데 사용할 수 있는 을 반환 Socket 합니다. 애플리케이션에 동기 I/O 필요한 경우 사용 된 AcceptTcpClient합니다. 자세한 동작 제어는 메서드를 사용합니다 AcceptSocket . 이러한 두 메서드는 큐에서 연결 요청을 사용할 수 있게 될 때까지 차단됩니다.

메서드를 사용하여 를 Stop 닫 TcpListener 고 수신 대기를 중지합니다. 수락된 연결을 별도로 닫을 책임이 있습니다.

참고

SocketException.ErrorCode 속성을 사용하여 특정 오류 코드를 가져온 다음, Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조하세요.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의 네트워크 추적을 참조하세요.

추가 정보

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