Поделиться через

TcpClient.BeginConnect Метод

  • Ссылка

Определение

Пространство имен:
System.Net.Sockets
Сборка:
System.Net.Sockets.dll
Сборка:
System.dll
Сборка:
netstandard.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
Исходный код:
TCPClient.cs
Исходный код:
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);
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 перегрузок метода.

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

Примечание

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

Применяется к

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

Исходный код:
TCPClient.cs
Исходный код:
TCPClient.cs
Исходный код:
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);
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-адресов для одного узла.

Примечание

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

Применяется к

BeginConnect(String, Int32, AsyncCallback, Object)

Исходный код:
TCPClient.cs
Исходный код:
TCPClient.cs
Исходный код:
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);
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 перегрузок метода.

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

Применяется к