TcpClient.ConnectAsync Метод

Определение

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

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

Подключает клиент к удаленному узлу TCP, используя указанное имя узла и номер порта в качестве асинхронной операции.

Перегрузки

Имя	Описание
ConnectAsync(String, Int32, CancellationToken)	Подключает клиент к указанному TCP-порту на указанном узле как асинхронная операция.
ConnectAsync(IPAddress[], Int32, CancellationToken)	Подключает клиент к удаленному узлу TCP, используя указанные IP-адреса и номер порта в качестве асинхронной операции.
ConnectAsync(IPAddress, Int32, CancellationToken)	Подключает клиент к удаленному узлу TCP, используя указанный IP-адрес и номер порта в качестве асинхронной операции.
ConnectAsync(String, Int32)	Подключает клиент к указанному TCP-порту на указанном узле как асинхронная операция.
ConnectAsync(IPEndPoint, CancellationToken)	Подключает клиент к удаленному узлу TCP, используя указанную конечную точку в качестве асинхронной операции.
ConnectAsync(IPAddress[], Int32)	Подключает клиент к удаленному узлу TCP, используя указанные IP-адреса и номер порта в качестве асинхронной операции.
ConnectAsync(IPAddress, Int32)	Подключает клиент к удаленному узлу TCP, используя указанный IP-адрес и номер порта в качестве асинхронной операции.
ConnectAsync(IPEndPoint)	Подключает клиент к удаленному узлу TCP, используя указанную конечную точку в качестве асинхронной операции.

ConnectAsync(String, Int32, CancellationToken)

Исходный код:

TCPClient.cs

Подключает клиент к указанному TCP-порту на указанном узле как асинхронная операция.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(string host, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

Параметры

host

String

DNS-имя удаленного узла.

port

Int32

Номер порта удаленного узла.

cancellationToken

CancellationToken

Маркер отмены, который можно использовать для сигнала об асинхронной операции, следует отменить.

Возвращаемое значение

ValueTask

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

Исключения

ArgumentNullException

Параметр host имеет значение null.

ArgumentOutOfRangeException

Параметр port не находится между MinPort и MaxPort.

SocketException

При доступе к сокету произошла ошибка.

ObjectDisposedException

TcpClient закрыт.

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенная задача завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Вызовите этот метод, чтобы установить синхронное подключение удаленного узла к указанному имени узла и номеру порта в качестве асинхронной операции. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Если протокол IPv6 включен, и ConnectAsync(String, Int32) метод вызывается для подключения к узлу, разрешающего как IPv6, так и IPv4-адреса, подключение к IPv6-адресу будет выполнено сначала до IPv4-адреса. Это может повлиять на задержку времени установки подключения, если узел не прослушивает IPv6-адрес.

Note

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(String, Int32).

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

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPAddress[], Int32, CancellationToken)

Исходный код:

TCPClient.cs

Подключает клиент к удаленному узлу TCP, используя указанные IP-адреса и номер порта в качестве асинхронной операции.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

Параметры

addresses

IPAddress[]

Массив IP-адресов удаленного узла.

port

Int32

Номер порта удаленного узла.

cancellationToken

CancellationToken

Маркер отмены, который можно использовать для сигнала об асинхронной операции, следует отменить.

Возвращаемое значение

ValueTask

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

Исключения

ArgumentNullException

Параметр addresses имеет значение null.

ArgumentOutOfRangeException

Недопустимый номер порта.

SocketException

Произошла ошибка при попытке доступа к сокету.

ObjectDisposedException

Он Socket был закрыт.

SecurityException

Вызывающий объект выше в стеке вызовов не имеет разрешения на запрошенную операцию.

NotSupportedException

Этот метод действителен для сокетов, использующих InterNetwork флаг или InterNetworkV6 флаг.

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенная задача завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Этот метод обычно используется сразу после вызова BeginGetHostAddresses метода, который может возвращать несколько IP-адресов для одного узла. Вызовите этот метод, чтобы установить синхронное подключение удаленного узла к узлу, указанному массивом IP-адресов и номером порта в качестве асинхронной операции. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Note

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Note

Если вы получаете NotSupportedException с сообщением This protocol version is not supported при использовании IPv6-адреса, убедитесь, что в конструкторе InterNetworkV6включен IPv6.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(IPAddress[], Int32).

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

• TcpListener

ConnectAsync(IPAddress, Int32, CancellationToken)

Исходный код:

TCPClient.cs

Подключает клиент к удаленному узлу TCP, используя указанный IP-адрес и номер порта в качестве асинхронной операции.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

Параметры

address

IPAddress

IP-адрес удаленного узла.

port

Int32

Номер порта удаленного узла.

cancellationToken

CancellationToken

Маркер отмены, который можно использовать для сигнала об асинхронной операции, следует отменить.

Возвращаемое значение

ValueTask

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

Исключения

ArgumentNullException

Параметр address имеет значение null.

ArgumentOutOfRangeException

Не port между MinPort и MaxPort.

SocketException

При доступе к сокету произошла ошибка.

ObjectDisposedException

TcpClient закрыт.

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенная задача завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Вызовите этот метод, чтобы установить синхронное подключение удаленного узла к указанному IP-адресу и номеру порта в качестве асинхронной операции. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Note

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Note

Если вы получаете NotSupportedException с сообщением This protocol version is not supported при использовании IPv6-адреса, убедитесь, что в конструкторе InterNetworkV6включен IPv6.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(IPAddress, Int32).

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

• GetStream()

ConnectAsync(String, Int32)

Исходный код:

TCPClient.cs

Подключает клиент к указанному TCP-порту на указанном узле как асинхронная операция.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);

public System.Threading.Tasks.Task ConnectAsync(string host, int port);

member this.ConnectAsync : string * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

Параметры

host

String

DNS-имя удаленного узла, к которому планируется подключиться.

port

Int32

Номер порта удаленного узла, к которому планируется подключиться.

Возвращаемое значение

Task

Объект задачи, представляющий асинхронную операцию.

Исключения

ArgumentNullException

Параметр host имеет значение null.

ArgumentOutOfRangeException

Параметр port не находится между MinPort и MaxPort.

SocketException

При доступе к сокету произошла ошибка.

ObjectDisposedException

TcpClient закрыт.

Комментарии

Эта операция не блокируется. Возвращенный объект Return Task завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Вызовите этот метод, чтобы установить синхронное подключение удаленного узла к указанному имени узла и номеру порта в качестве асинхронной операции. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Если протокол IPv6 включен, и ConnectAsync(String, Int32) метод вызывается для подключения к узлу, разрешающего как IPv6, так и IPv4-адреса, подключение к IPv6-адресу будет выполнено сначала до IPv4-адреса. Это может повлиять на задержку времени установки подключения, если узел не прослушивает IPv6-адрес.

Note

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(String, Int32).

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

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPEndPoint, CancellationToken)

Исходный код:

TCPClient.cs

Подключает клиент к удаленному узлу TCP, используя указанную конечную точку в качестве асинхронной операции.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask

Параметры

remoteEP

IPEndPoint

Объект IPEndPoint , к которому вы собираетесь подключиться.

cancellationToken

CancellationToken

Маркер отмены, используемый для распространения уведомлений о том, что эта операция должна быть отменена.

Возвращаемое значение

ValueTask

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

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный объект Return Task завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Вызовите этот метод, чтобы установить синхронное подключение к указанному IPEndPointузлу. Перед вызовом Connectнеобходимо создать экземпляр IPEndPoint класса с помощью IP-адреса и номера порта. Используйте это IPEndPoint в качестве remoteEP параметра. Метод Connect блокируется до тех пор, пока он не подключается или завершается сбоем. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Note

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Note

Если вы получаете NotSupportedException с сообщением This protocol version is not supported при использовании IPv6-адреса, убедитесь, что в конструкторе InterNetworkV6включен IPv6.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(IPEndPoint).

ConnectAsync(IPAddress[], Int32)

Исходный код:

TCPClient.cs

Подключает клиент к удаленному узлу TCP, используя указанные IP-адреса и номер порта в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress[] addresses, int port);

member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

Параметры

addresses

IPAddress[]

Массив IPAddress узла, к которому планируется подключиться.

port

Int32

Номер порта, к которому планируется подключиться.

Возвращаемое значение

Task

Объект задачи, представляющий асинхронную операцию.

Исключения

ArgumentNullException

Параметр addresses имеет значение null.

ArgumentOutOfRangeException

Недопустимый номер порта.

SocketException

Произошла ошибка при попытке доступа к сокету.

ObjectDisposedException

Он Socket был закрыт.

SecurityException

Вызывающий объект выше в стеке вызовов не имеет разрешения на запрошенную операцию.

NotSupportedException

Этот метод действителен для сокетов, использующих InterNetwork флаг или InterNetworkV6 флаг.

Комментарии

Эта операция не блокируется. Возвращенный объект Return Task завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Этот метод обычно используется сразу после вызова BeginGetHostAddresses метода, который может возвращать несколько IP-адресов для одного узла. Вызовите этот метод, чтобы установить синхронное подключение удаленного IPAddress узла к узлу, указанному массивом элементов и номером порта в качестве асинхронной операции. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Note

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Note

Если вы получаете NotSupportedException с сообщением This protocol version is not supported при использовании IPv6-адреса, убедитесь, что в конструкторе InterNetworkV6включен IPv6.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(IPAddress[], Int32).

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

• TcpListener

ConnectAsync(IPAddress, Int32)

Исходный код:

TCPClient.cs

Подключает клиент к удаленному узлу TCP, используя указанный IP-адрес и номер порта в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);

public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress address, int port);

member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

Параметры

address

IPAddress

Узел IPAddress , к которому планируется подключиться.

port

Int32

Номер порта, к которому планируется подключиться.

Возвращаемое значение

Task

Объект задачи, представляющий асинхронную операцию.

Исключения

ArgumentNullException

Параметр address имеет значение null.

ArgumentOutOfRangeException

Не port между MinPort и MaxPort.

SocketException

При доступе к сокету произошла ошибка.

ObjectDisposedException

TcpClient закрыт.

Комментарии

Эта операция не блокируется. Возвращенный объект Return Task завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Вызовите этот метод, чтобы установить синхронное подключение удаленного узла к указанному IPAddress и номеру порта в качестве асинхронной операции. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Note

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Note

Если вы получаете NotSupportedException с сообщением This protocol version is not supported при использовании IPv6-адреса, убедитесь, что в конструкторе InterNetworkV6включен IPv6.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(IPAddress, Int32).

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

• GetStream()

ConnectAsync(IPEndPoint)

Исходный код:

TCPClient.cs

Подключает клиент к удаленному узлу TCP, используя указанную конечную точку в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);

public System.Threading.Tasks.Task ConnectAsync(System.Net.IPEndPoint remoteEP);

member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.Task

Public Function ConnectAsync (remoteEP As IPEndPoint) As Task

Параметры

remoteEP

IPEndPoint

Объект IPEndPoint , к которому вы собираетесь подключиться.

Возвращаемое значение

Task

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

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершится после установки TCP-подключения. Этот метод не блокирует вызывающий поток во время выполнения запроса на подключение.

Вызовите этот метод, чтобы установить синхронное подключение к указанному IPEndPointузлу. Перед вызовом Connectнеобходимо создать экземпляр IPEndPoint класса с помощью IP-адреса и номера порта. Используйте это IPEndPoint в качестве remoteEP параметра. Метод Connect блокируется до тех пор, пока он не подключается или завершается сбоем. После подключения к удаленному узлу используйте GetStream метод для получения базового NetworkStream. Используйте это NetworkStream для отправки и получения данных.

Note

Если вы получаете SocketExceptionкод ошибки, используйте SocketException.ErrorCode для получения определенного кода ошибки. Получив этот код, вы можете ознакомиться с кодом ошибки Windows Сокеты версии 2 подробным описанием ошибки.

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

Note

Если вы получаете NotSupportedException сообщение "Эта версия протокола не поддерживается" при использовании IPv6-адреса, убедитесь, что в конструкторе InterNetworkV6включен IPv6.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Connect(IPEndPoint).