TcpListener.Start Метод

Определение

Пространство имен:

System.Net.Sockets

Сборка:

System.Net.Sockets.dll

Сборка:

System.dll

Сборка:

netstandard.dll

Запускает ожидание входящих запросов на подключение.

Перегрузки

Start()	Запускает ожидание входящих запросов на подключение.
Start(Int32)	Запускает ожидание входящих запросов на подключение с максимальным числом ожидающих подключений.

Start()

Запускает ожидание входящих запросов на подключение.

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)

Запускает ожидание входящих запросов на подключение с максимальным числом ожидающих подключений.

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()