Udostępnij za pośrednictwem

TcpClient.BeginConnect Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net.Sockets
Zestaw:
System.Net.Sockets.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

Rozpoczyna asynchroniczne żądanie połączenia hosta zdalnego.

Przeciążenia

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Rozpoczyna asynchroniczne żądanie połączenia hosta zdalnego. Host zdalny jest określony przez IPAddress numer portu (Int32).
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

Rozpoczyna asynchroniczne żądanie połączenia hosta zdalnego. Host zdalny jest określany przez tablicę IPAddress i numer portu (Int32).
BeginConnect(String, Int32, AsyncCallback, Object)

Rozpoczyna asynchroniczne żądanie połączenia hosta zdalnego. Host zdalny jest określany przez nazwę hosta (String) i numer portu (Int32).

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Źródło:
TCPClient.cs

Rozpoczyna asynchroniczne żądanie połączenia hosta zdalnego. Host zdalny jest określony przez IPAddress numer portu (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

Parametry

address
IPAddress

Host IPAddress zdalny.

port
Int32

Numer portu hosta zdalnego.

requestCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu operacji.

state
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji łączenia. Ten obiekt jest przekazywany do delegata po zakończeniu requestCallback operacji.

Zwraca

IAsyncResult

Obiekt IAsyncResult , który odwołuje się do połączenia asynchronicznego.

Wyjątki

ArgumentNullException

Parametr address to null.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

SecurityException

Obiekt wywołujący wyższy w stosie wywołań nie ma uprawnień do żądanej operacji.

ArgumentOutOfRangeException

Numer portu jest nieprawidłowy.

Uwagi

Operacja asynchroniczna BeginConnect musi zostać ukończona przez wywołanie EndConnect metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .

Ta metoda nie blokuje się, dopóki operacja nie zostanie zakończona. Aby zablokować działanie do momentu zakończenia operacji, użyj jednego z Connect przeciążeń metody.

Aby uzyskać szczegółowe informacje na temat używania asynchronicznego modelu programowania, zobacz Wywoływanie metod synchronicznych asynchronicznie.

Uwaga

Jeśli podczas korzystania z adresu IPv6 otrzymasz komunikat This protocol version is not supported NotSupportedException, upewnij się, że włączono protokół IPv6 w konstruktorze, przekazując polecenie InterNetworkV6.

Dotyczy

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

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Źródło:
TCPClient.cs

Rozpoczyna asynchroniczne żądanie połączenia hosta zdalnego. Host zdalny jest określany przez tablicę IPAddress i numer portu (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

Parametry

addresses
IPAddress[]

Co najmniej jeden, IPAddress który wyznacza hosty zdalne.

port
Int32

Numer portu hostów zdalnych.

requestCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu operacji.

state
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji łączenia. Ten obiekt jest przekazywany do delegata po zakończeniu requestCallback operacji.

Zwraca

IAsyncResult

Obiekt IAsyncResult , który odwołuje się do połączenia asynchronicznego.

Wyjątki

ArgumentNullException

Parametr addresses to null.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

SecurityException

Obiekt wywołujący wyższy w stosie wywołań nie ma uprawnień do żądanej operacji.

ArgumentOutOfRangeException

Numer portu jest nieprawidłowy.

Uwagi

Operacja asynchroniczna BeginConnect musi zostać ukończona przez wywołanie EndConnect metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .

Ta metoda nie blokuje się, dopóki operacja nie zostanie zakończona. Aby zablokować działanie do momentu zakończenia operacji, użyj jednego z Connect przeciążeń metody.

Aby uzyskać szczegółowe informacje na temat używania asynchronicznego modelu programowania, zobacz Wywoływanie metod synchronicznych asynchronicznie.

Ta metoda jest zwykle używana bezpośrednio po wywołaniu BeginGetHostAddresses metody, która może zwrócić wiele adresów IP dla jednego hosta.

Uwaga

Jeśli podczas korzystania z adresu IPv6 otrzymasz komunikat This protocol version is not supported NotSupportedException, upewnij się, że włączono protokół IPv6 w konstruktorze, przekazując polecenie InterNetworkV6.

Dotyczy

BeginConnect(String, Int32, AsyncCallback, Object)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Źródło:
TCPClient.cs

Rozpoczyna asynchroniczne żądanie połączenia hosta zdalnego. Host zdalny jest określany przez nazwę hosta (String) i numer portu (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

Parametry

host
String

Nazwa hosta zdalnego.

port
Int32

Numer portu hosta zdalnego.

requestCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu operacji.

state
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji łączenia. Ten obiekt jest przekazywany do delegata po zakończeniu requestCallback operacji.

Zwraca

IAsyncResult

Obiekt IAsyncResult , który odwołuje się do połączenia asynchronicznego.

Wyjątki

ArgumentNullException

Parametr host to null.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Została zamknięta Socket .

SecurityException

Obiekt wywołujący wyższy w stosie wywołań nie ma uprawnień do żądanej operacji.

ArgumentOutOfRangeException

Numer portu jest nieprawidłowy.

Uwagi

Operacja asynchroniczna BeginConnect musi zostać ukończona przez wywołanie EndConnect metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .

Ta metoda nie blokuje się, dopóki operacja nie zostanie zakończona. Aby zablokować działanie do momentu zakończenia operacji, użyj jednego z Connect przeciążeń metody.

Aby uzyskać szczegółowe informacje na temat używania asynchronicznego modelu programowania, zobacz Wywoływanie metod synchronicznych asynchronicznie.

Dotyczy