TcpClient.BeginConnect Метод

Определение

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

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

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

Перегрузки

Имя	Описание
BeginConnect(IPAddress, Int32, AsyncCallback, Object)	Начинает асинхронный запрос подключения к удаленному узлу. Удаленный узел указывается номером IPAddress порта (Int32).
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)	Начинает асинхронный запрос подключения к удаленному узлу. Удаленный узел указывается массивом IPAddress и номером порта (Int32).
BeginConnect(String, Int32, AsyncCallback, Object)	Начинает асинхронный запрос подключения к удаленному узлу. Удаленный узел указывается именем узла (String) и номером порта (Int32).

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

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

TCPClient.cs

Начинает асинхронный запрос подключения к удаленному узлу. Удаленный узел указывается номером IPAddress порта (Int32).

public:
 IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.IPAddress address, int port, AsyncCallback? requestCallback, object? state);

member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Параметры

address

IPAddress

Удаленный IPAddress узел.

port

Int32

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

requestCallback

AsyncCallback

Делегат AsyncCallback , ссылающийся на метод для вызова при завершении операции.

state

Object

Определяемый пользователем объект, содержащий сведения об операции подключения. Этот объект передается делегату requestCallback после завершения операции.

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

IAsyncResult

Объект IAsyncResult , ссылающийся на асинхронное соединение.

Исключения

ArgumentNullException

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

SocketException

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

ObjectDisposedException

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

SecurityException

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

ArgumentOutOfRangeException

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

Комментарии

Асинхронная BeginConnect операция должна выполняться путем вызова EndConnect метода. Как правило, метод вызывается делегатом asyncCallback .

Этот метод не блокируется до завершения операции. Чтобы заблокировать до завершения операции, используйте одну из Connect перегрузок метода.

Подробные сведения об использовании асинхронной модели программирования см. в статье "Вызов синхронных методов асинхронно".

Note

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

BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

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

TCPClient.cs

Начинает асинхронный запрос подключения к удаленному узлу. Удаленный узел указывается массивом IPAddress и номером порта (Int32).

public:
 IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.IPAddress[] addresses, int port, AsyncCallback? requestCallback, object? state);

member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Параметры

addresses

IPAddress[]

По крайней мере один IPAddress , указывающий удаленные узлы.

port

Int32

Номер порта удаленных узлов.

requestCallback

AsyncCallback

Делегат AsyncCallback , ссылающийся на метод для вызова при завершении операции.

state

Object

Определяемый пользователем объект, содержащий сведения об операции подключения. Этот объект передается делегату requestCallback после завершения операции.

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

IAsyncResult

Объект IAsyncResult , ссылающийся на асинхронное соединение.

Исключения

ArgumentNullException

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

SocketException

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

ObjectDisposedException

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

SecurityException

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

ArgumentOutOfRangeException

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

Комментарии

Асинхронная BeginConnect операция должна выполняться путем вызова EndConnect метода. Как правило, метод вызывается делегатом asyncCallback .

Этот метод не блокируется до завершения операции. Чтобы заблокировать до завершения операции, используйте одну из Connect перегрузок метода.

Подробные сведения об использовании асинхронной модели программирования см. в статье "Вызов синхронных методов асинхронно".

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

Note

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

BeginConnect(String, Int32, AsyncCallback, Object)

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

TCPClient.cs

Начинает асинхронный запрос подключения к удаленному узлу. Удаленный узел указывается именем узла (String) и номером порта (Int32).

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(string host, int port, AsyncCallback? requestCallback, object? state);

member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Параметры

host

String

Имя удаленного узла.

port

Int32

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

requestCallback

AsyncCallback

Делегат AsyncCallback , ссылающийся на метод для вызова при завершении операции.

state

Object

Определяемый пользователем объект, содержащий сведения об операции подключения. Этот объект передается делегату requestCallback после завершения операции.

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

IAsyncResult

Объект IAsyncResult , ссылающийся на асинхронное соединение.

Исключения

ArgumentNullException

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

SocketException

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

ObjectDisposedException

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

SecurityException

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

ArgumentOutOfRangeException

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

Комментарии

Асинхронная BeginConnect операция должна выполняться путем вызова EndConnect метода. Как правило, метод вызывается делегатом asyncCallback .

Этот метод не блокируется до завершения операции. Чтобы заблокировать до завершения операции, используйте одну из Connect перегрузок метода.

Подробные сведения об использовании асинхронной модели программирования см. в статье "Вызов синхронных методов асинхронно".