Socket.ConnectAsync Метод

Определение

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

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

Начинает асинхронный запрос подключения к удаленному узлу.

Перегрузки

Имя	Описание
ConnectAsync(String, Int32, CancellationToken)	Устанавливает подключение к удаленному узлу.
ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs)	Начинает асинхронный запрос подключения к удаленному узлу.
ConnectAsync(IPAddress[], Int32, CancellationToken)	Устанавливает подключение к удаленному узлу.
ConnectAsync(IPAddress, Int32, CancellationToken)	Устанавливает подключение к удаленному узлу.
ConnectAsync(String, Int32)	Устанавливает подключение к удаленному узлу.
ConnectAsync(IPAddress[], Int32)	Устанавливает подключение к удаленному узлу.
ConnectAsync(IPAddress, Int32)	Устанавливает подключение к удаленному узлу.
ConnectAsync(EndPoint, CancellationToken)	Устанавливает подключение к удаленному узлу.
ConnectAsync(SocketAsyncEventArgs)	Начинает асинхронный запрос подключения к удаленному узлу.
ConnectAsync(EndPoint)	Устанавливает подключение к удаленному узлу.

ConnectAsync(String, Int32, CancellationToken)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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

Имя узла удаленного узла для подключения.

port

Int32

Порт на удаленном узле для подключения.

cancellationToken

CancellationToken

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

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

ValueTask

Асинхронная задача, которая завершается при установке подключения.

Исключения

ArgumentNullException

Параметр host не может иметь значение NULL.

ArgumentOutOfRangeException

port меньше MinPort.

–или–

port больше MaxPort.

InvalidOperationException

Прослушивает Socket .

NotSupportedException

Сокет не находится в семействеInterNetwork.InterNetworkV6

SocketException

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

ObjectDisposedException

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

SecurityException

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

OperationCanceledException

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

Комментарии

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

ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs)

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

Socket.cs

Начинает асинхронный запрос подключения к удаленному узлу.

public:
 static bool ConnectAsync(System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType, System::Net::Sockets::SocketAsyncEventArgs ^ e);

public static bool ConnectAsync(System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType, System.Net.Sockets.SocketAsyncEventArgs e);

static member ConnectAsync : System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType * System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Shared Function ConnectAsync (socketType As SocketType, protocolType As ProtocolType, e As SocketAsyncEventArgs) As Boolean

Параметры

socketType

SocketType

Одно из значений SocketType .

protocolType

ProtocolType

Одно из значений ProtocolType .

e

SocketAsyncEventArgs

Объект SocketAsyncEventArgs , используемый для этой асинхронной операции сокета.

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

Boolean

Значение , если операция ввода-вывода ожидается. Событие Completed параметра e будет возникать после завершения операции.

false Если операция ввода-вывода завершилась синхронно. В этом случае событие параметра e не будет вызываться, и e объект, переданный в качестве параметра, Completed может быть рассмотрен сразу после вызова метода, чтобы получить результат операции.

Исключения

ArgumentException

Недопустимый аргумент. Это исключение возникает, если задано несколько буферов, BufferList свойство не равно NULL.

ArgumentNullException

Параметр e не может иметь значение NULL и RemoteEndPoint не может иметь значение NULL.

InvalidOperationException

Операция Socket прослушивания или сокета уже выполнялась с помощью объекта, указанного SocketAsyncEventArgs в параметре e .

SocketException

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

NotSupportedException

Локальная конечная точка и не одно и RemoteEndPoint то же семейство адресов.

ObjectDisposedException

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

SecurityException

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

Комментарии

Если используется протокол, ориентированный на подключение, метод M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs) запускает асинхронный запрос на подключение к удаленному узлу. Если используется протокол без подключения, устанавливается удаленный узел по умолчанию, ConnectAsync указанный socketType в параметрах и protocolType параметрах.

Чтобы получить уведомление о завершении, необходимо создать метод обратного вызова, который реализует делегат EventHandler<SocketAsyncEventArgs> и присоединить обратный вызов к событию SocketAsyncEventArgs.Completed .

Вызывающий объект должен задать SocketAsyncEventArgs.RemoteEndPoint свойство IPEndPoint удаленному узлу для подключения.

Вызывающий SocketAsyncEventArgs.UserToken объект может задать свойство любому объекту пользовательского ConnectAsync состояния, требуемому перед вызовом метода, чтобы информация была извлечена в методе обратного вызова. Если обратный вызов требует больше информации, чем один объект, можно создать небольшой класс для хранения других необходимых сведений о состоянии в качестве членов.

Если вы используете протокол без подключения, например UDP, перед отправкой и получением данных не нужно вызывать ConnectAsync . Вы можете использовать SendToAsync и ReceiveFromAsync взаимодействовать с удаленным узлом. При вызове ConnectAsyncвсе граммы данных, поступающие из адреса, отличного от указанного по умолчанию, будут удалены. Если вы хотите изменить удаленный узел по умолчанию, вызовите ConnectAsync метод снова с требуемой конечной точкой.

Если вы хотите задать удаленный узел по умолчанию для широковещательного адреса, необходимо сначала вызвать SetSocketOption и задать значение true"Широковещательный". Если это не сделано, ConnectAsync метод вызовет SocketExceptionисключение.

Требуются следующие свойства и события объекта System.Net.Sockets.SocketAsyncEventArgs :

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

При необходимости буфер может быть предоставлен, который будет атомарно отправлен на сокет после успешного ConnectAsync выполнения метода. В этом случае SocketAsyncEventArgs.Buffer свойству необходимо задать буфер, содержащий данные для отправки, а SocketAsyncEventArgs.Count свойство должно быть задано в байтах данных для отправки из буфера. После установки подключения этот буфер данных отправляется.

Если вы используете протокол, ориентированный на подключение, и не вызывайте перед вызовом BindConnectAsync, базовый поставщик услуг назначит наиболее подходящий адрес локальной сети и номер порта.

Если вы используете протокол без подключения, поставщик услуг не назначит IP-адрес и номер порта локальной сети, пока не вызовете SendAsync методы или ReceiveAsync методы.

Метод ConnectAsync создает исключениеNotSupportedException, если семейство адресов и SocketAsyncEventArgs.RemoteEndPoint не одно и Socket то же семейство адресов.

Замечание

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

ConnectAsync(IPAddress[], Int32, CancellationToken)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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[]

Список IPAddresses для удаленного узла, который будет использоваться для попытки подключения к удаленному узлу.

port

Int32

Порт на удаленном узле для подключения.

cancellationToken

CancellationToken

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

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

ValueTask

Асинхронная задача, которая завершается при установке подключения.

Исключения

ArgumentNullException

Параметр addresses не может иметь значение NULL.

ArgumentException

Параметр addresses не может быть пустым массивом.

ArgumentOutOfRangeException

port меньше MinPort.

–или–

port больше MaxPort.

InvalidOperationException

Прослушивает Socket .

NotSupportedException

Сокет не находится в семействеInterNetwork.InterNetworkV6

SocketException

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

ObjectDisposedException

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

SecurityException

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

OperationCanceledException

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

Комментарии

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

ConnectAsync(IPAddress, Int32, CancellationToken)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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

IPAddress удаленного узла для подключения.

port

Int32

Порт на удаленном узле для подключения.

cancellationToken

CancellationToken

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

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

ValueTask

Асинхронная задача, которая завершается при установке подключения.

Исключения

ArgumentNullException

Параметр address не может иметь значение NULL.

ArgumentOutOfRangeException

port меньше MinPort.

–или–

port больше MaxPort.

InvalidOperationException

Прослушивает Socket .

SocketException

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

ObjectDisposedException

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

SecurityException

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

OperationCanceledException

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

Комментарии

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

ConnectAsync(String, Int32)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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

Имя узла удаленного узла для подключения.

port

Int32

Порт на удаленном узле для подключения.

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

Task

Асинхронная задача, которая завершается при установке подключения.

Исключения

ArgumentNullException

Параметр host не может иметь значение NULL.

ArgumentOutOfRangeException

port меньше MinPort.

–или–

port больше MaxPort.

InvalidOperationException

Прослушивает Socket .

NotSupportedException

Сокет не находится в семействеInterNetwork.InterNetworkV6

SocketException

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

ObjectDisposedException

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

SecurityException

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

Комментарии

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

ConnectAsync(IPAddress[], Int32)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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[]

Список IPAddresses для удаленного узла, который будет использоваться для попытки подключения к удаленному узлу.

port

Int32

Порт на удаленном узле для подключения.

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

Task

Асинхронная задача, которая завершается при установке подключения.

Исключения

ArgumentNullException

Параметр addresses не может иметь значение NULL.

ArgumentException

Параметр addresses не может быть пустым массивом.

ArgumentOutOfRangeException

port меньше MinPort.

–или–

port больше MaxPort.

InvalidOperationException

Прослушивает Socket .

NotSupportedException

Сокет не находится в семействеInterNetwork.InterNetworkV6

SocketException

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

ObjectDisposedException

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

SecurityException

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

Комментарии

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

ConnectAsync(IPAddress, Int32)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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.

–или–

port больше MaxPort.

InvalidOperationException

Прослушивает Socket .

NotSupportedException

Сокет не находится в семействеInterNetwork.InterNetworkV6

SocketException

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

ObjectDisposedException

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

SecurityException

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

Комментарии

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

ConnectAsync(EndPoint, CancellationToken)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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

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

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

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

Параметры

remoteEP

EndPoint

Конечная точка для подключения.

cancellationToken

CancellationToken

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

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

ValueTask

Асинхронная задача, которая завершается при установке подключения.

Исключения

ArgumentNullException

Параметр remoteEP не может иметь значение NULL.

InvalidOperationException

Прослушивает Socket .

SocketException

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

NotSupportedException

Локальная конечная точка и remoteEP параметр не совпадают с семейством адресов.

ObjectDisposedException

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

SecurityException

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

OperationCanceledException

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

Комментарии

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

ConnectAsync(SocketAsyncEventArgs)

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

Socket.cs

Начинает асинхронный запрос подключения к удаленному узлу.

public:
 bool ConnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool ConnectAsync(System.Net.Sockets.SocketAsyncEventArgs e);

member this.ConnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function ConnectAsync (e As SocketAsyncEventArgs) As Boolean

Параметры

e

SocketAsyncEventArgs

Объект SocketAsyncEventArgs , используемый для этой асинхронной операции сокета.

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

Boolean

Значение , если операция ввода-вывода ожидается. Событие Completed параметра e будет возникать после завершения операции.

false Если операция ввода-вывода завершилась синхронно. В этом случае событие параметра e не будет вызываться, и e объект, переданный в качестве параметра, Completed может быть рассмотрен сразу после вызова метода, чтобы получить результат операции.

Исключения

ArgumentException

Недопустимый аргумент. Это исключение возникает, если задано несколько буферов, BufferList свойство не равно NULL.

ArgumentNullException

Параметр e не может иметь значение NULL и RemoteEndPoint не может иметь значение NULL.

InvalidOperationException

Операция Socket прослушивания или сокета уже выполнялась с помощью объекта, указанного SocketAsyncEventArgs в параметре e .

SocketException

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

NotSupportedException

Локальная конечная точка и не одно и RemoteEndPoint то же семейство адресов.

ObjectDisposedException

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

SecurityException

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

Комментарии

Если используется протокол, ориентированный на подключение, ConnectAsync метод запускает асинхронный запрос на подключение к удаленному узлу. Если вы используете протокол без подключения, ConnectAsync установите удаленный узел по умолчанию.

Чтобы получить уведомление о завершении, необходимо создать метод обратного вызова, который реализует делегат EventHandler<SocketAsyncEventArgs> и присоединить обратный вызов к событию SocketAsyncEventArgs.Completed .

Вызывающий объект должен задать SocketAsyncEventArgs.RemoteEndPoint свойство IPEndPoint удаленному узлу для подключения.

Вызывающий SocketAsyncEventArgs.UserToken объект может задать свойство любому объекту пользовательского ConnectAsync состояния, требуемому перед вызовом метода, чтобы информация была извлечена в методе обратного вызова. Если обратный вызов требует больше информации, чем один объект, можно создать небольшой класс для хранения других необходимых сведений о состоянии в качестве членов.

Если вы используете протокол без подключения, например UDP, перед отправкой и получением данных не нужно вызывать ConnectAsync . Вы можете использовать SendToAsync и ReceiveFromAsync взаимодействовать с удаленным узлом. При вызове ConnectAsyncвсе граммы данных, поступающие из адреса, отличного от указанного по умолчанию, будут удалены. Если вы хотите изменить удаленный узел по умолчанию, вызовите ConnectAsync метод снова с требуемой конечной точкой.

Если вы хотите задать удаленный узел по умолчанию для широковещательного адреса, необходимо сначала вызвать SetSocketOption и задать значение true"Широковещательный". Если это не сделано, ConnectAsync метод вызовет SocketExceptionисключение.

Требуются следующие свойства и события объекта System.Net.Sockets.SocketAsyncEventArgs :

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

При необходимости буфер может быть предоставлен, который будет атомарно отправлен на сокет после успешного ConnectAsync выполнения метода. В этом случае SocketAsyncEventArgs.Buffer свойству необходимо задать буфер, содержащий данные для отправки, а SocketAsyncEventArgs.Count свойство должно быть задано в байтах данных для отправки из буфера. После установки подключения этот буфер данных отправляется.

Если вы используете протокол, ориентированный на подключение, и не вызывайте перед вызовом BindConnectAsync, базовый поставщик услуг назначит наиболее подходящий адрес локальной сети и номер порта.

Если вы используете протокол без подключения, поставщик услуг не назначит IP-адрес и номер порта локальной сети, пока не вызовете SendAsync методы или ReceiveAsync методы.

Метод ConnectAsync создает исключениеNotSupportedException, если семейство адресов и SocketAsyncEventArgs.RemoteEndPoint не одно и Socket то же семейство адресов.

Замечание

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

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

• SocketAsyncEventArgs
• Buffer
• Completed
• Count
• RemoteEndPoint
• UserToken

ConnectAsync(EndPoint)

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

Socket.Tasks.cs

Устанавливает подключение к удаленному узлу.

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

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

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

Public Function ConnectAsync (remoteEP As EndPoint) As Task

Параметры

remoteEP

EndPoint

Конечная точка для подключения.

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

Task

Асинхронная задача, которая завершается при установке подключения.

Исключения

ArgumentNullException

Параметр remoteEP не может иметь значение NULL.

InvalidOperationException

Прослушивает Socket .

SocketException

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

NotSupportedException

Локальная конечная точка и remoteEP параметр не совпадают с семейством адресов.

ObjectDisposedException

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

SecurityException

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

Комментарии

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