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. Получив этот код, можно обратиться за подробным описанием ошибки к документации Коды ошибок API для сокетов Windows версии 2.

Примеры

В следующем примере кода показано, как 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 , он вызовет на клиенте.

Чтобы удалить подключение из очереди входящих подключений, используйте AcceptTcpClient метод или AcceptSocket метод . Метод AcceptTcpClient удалит подключение из очереди и вернет TcpClient объект , который можно использовать для отправки и получения данных. Метод AcceptSocket вернет объект , Socket который можно использовать для выполнения аналогичных действий. Если приложению требуется только синхронный ввод-вывод, используйте AcceptTcpClient. Для более подробного контроля поведения используйте .AcceptSocket Оба этих метода блокируются до тех пор, пока запрос на подключение не будет доступен в очереди.

Используйте метод , Stop чтобы закрыть TcpListener и прекратить прослушивание. Вы несете ответственность за закрытие принятых подключений отдельно.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе Трассировка сети в платформа .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 меньше нуля или превышает максимальное число разрешенных подключений.

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 на клиенте.

Чтобы удалить подключение из очереди входящих подключений, используйте AcceptTcpClient метод или AcceptSocket метод . Метод AcceptTcpClient удалит подключение из очереди и вернет TcpClient объект , который можно использовать для отправки и получения данных. Метод AcceptSocket вернет объект , Socket который можно использовать для выполнения аналогичных действий. Если приложению требуется только синхронный ввод-вывод, используйте AcceptTcpClient. Для более подробного контроля поведения используйте AcceptSocket метод . Оба этих метода блокируются до тех пор, пока запрос на подключение не будет доступен в очереди.

Используйте метод , Stop чтобы закрыть TcpListener и прекратить прослушивание. Вы несете ответственность за закрытие принятых подключений отдельно.

Примечание

Используйте свойство SocketException.ErrorCode для получения конкретного кода ошибки и обратитесь за подробным описанием ошибки к документации Коды ошибок API для сокетов Windows версии 2.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе Трассировка сети в платформа .NET Framework.

См. также раздел

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