TcpClient.ConnectAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Łączy klienta z zdalnym hostem TCP przy użyciu określonej nazwy hosta i numeru portu jako operacji asynchronicznej.

Przeciążenia

ConnectAsync(String, Int32, CancellationToken)	Łączy klienta z określonym portem TCP na określonym hoście jako operacją asynchroniczną.
ConnectAsync(IPAddress[], Int32, CancellationToken)	Łączy klienta z zdalnym hostem TCP przy użyciu określonych adresów IP i numeru portu jako operacji asynchronicznej.
ConnectAsync(IPAddress, Int32, CancellationToken)	Łączy klienta z zdalnym hostem TCP przy użyciu określonego adresu IP i numeru portu jako operacji asynchronicznej.
ConnectAsync(String, Int32)	Łączy klienta z określonym portem TCP na określonym hoście jako operacją asynchroniczną.
ConnectAsync(IPEndPoint, CancellationToken)	Łączy klienta z zdalnym hostem TCP przy użyciu określonego punktu końcowego jako operacji asynchronicznej.
ConnectAsync(IPAddress[], Int32)	Łączy klienta z zdalnym hostem TCP przy użyciu określonych adresów IP i numeru portu jako operacji asynchronicznej.
ConnectAsync(IPAddress, Int32)	Łączy klienta z zdalnym hostem TCP przy użyciu określonego adresu IP i numeru portu jako operacji asynchronicznej.
ConnectAsync(IPEndPoint)	Łączy klienta z zdalnym hostem TCP przy użyciu określonego punktu końcowego jako operacji asynchronicznej.

ConnectAsync(String, Int32, CancellationToken)

Źródło:

TCPClient.cs

Łączy klienta z określonym portem TCP na określonym hoście jako operacją asynchroniczną.

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

Parametry

host

String

Nazwa DNS hosta zdalnego.

port

Int32

Numer portu hosta zdalnego.

cancellationToken

CancellationToken

Należy anulować token anulowania, który może służyć do sygnalizowania operacji asynchronicznej.

Zwraca

ValueTask

Zadanie reprezentujące operację połączenia asynchronicznego.

Wyjątki

ArgumentNullException

Parametr host to null.

ArgumentOutOfRangeException

Parametr port nie znajduje się między MinPort i MaxPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

ObjectDisposedException

TcpClient jest zamknięty.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócone zadanie zostanie zakończone po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z określoną nazwą hosta i numerem portu jako operacją asynchroniczną. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Jeśli protokół IPv6 jest włączony, a ConnectAsync(String, Int32) metoda jest wywoływana w celu nawiązania połączenia z hostem rozpoznawanym zarówno adresami IPv6, jak i IPv4, połączenie z adresem IPv6 zostanie podjęta najpierw przed adresem IPv4. Może to mieć wpływ na opóźnienie czasu nawiązania połączenia, jeśli host nie nasłuchuje na adresie IPv6.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(String, Int32)usługę .

Zobacz też

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPAddress[], Int32, CancellationToken)

Źródło:

TCPClient.cs

Łączy klienta z zdalnym hostem TCP przy użyciu określonych adresów IP i numeru portu jako operacji asynchronicznej.

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

Parametry

addresses

IPAddress[]

Tablica adresów IP hosta zdalnego.

port

Int32

Numer portu hosta zdalnego.

cancellationToken

CancellationToken

Należy anulować token anulowania, który może służyć do sygnalizowania operacji asynchronicznej.

Zwraca

ValueTask

Zadanie reprezentujące operację połączenia asynchronicznego.

Wyjątki

ArgumentNullException

Parametr ipAddresses to null.

ArgumentOutOfRangeException

Numer portu jest nieprawidłowy.

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.

NotSupportedException

Ta metoda jest prawidłowa dla gniazd, które używają flagi InterNetwork lub flagi InterNetworkV6 .

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócone zadanie zostanie zakończone po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

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. Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z hostem określonym przez tablicę adresów IP i numer portu jako operację asynchroniczną. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(IPAddress[], Int32)usługę .

Zobacz też

• TcpListener

ConnectAsync(IPAddress, Int32, CancellationToken)

Źródło:

TCPClient.cs

Łączy klienta z zdalnym hostem TCP przy użyciu określonego adresu IP i numeru portu jako operacji asynchronicznej.

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

Parametry

address

IPAddress

Adres IP hosta zdalnego.

port

Int32

Numer portu hosta zdalnego.

cancellationToken

CancellationToken

Należy anulować token anulowania, który może służyć do sygnalizowania operacji asynchronicznej.

Zwraca

ValueTask

Zadanie reprezentujące operację połączenia asynchronicznego.

Wyjątki

ArgumentNullException

Parametr address to null.

ArgumentOutOfRangeException

Wartość port nie znajduje się między MinPort i MaxPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

ObjectDisposedException

TcpClient jest zamknięty.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócone zadanie zostanie zakończone po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z określonym adresem IP i numerem portu jako operację asynchroniczną. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(IPAddress, Int32)usługę .

Zobacz też

• GetStream()

ConnectAsync(String, Int32)

Źródło:

TCPClient.cs

Łączy klienta z określonym portem TCP na określonym hoście jako operacją asynchroniczną.

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

Parametry

host

String

Nazwa DNS hosta zdalnego, z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu hosta zdalnego, z którym zamierzasz nawiązać połączenie.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr host to null.

ArgumentOutOfRangeException

Parametr port nie znajduje się między MinPort i MaxPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

ObjectDisposedException

TcpClient jest zamknięty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Zwraca Task zostanie ukończony po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z określoną nazwą hosta i numerem portu jako operacją asynchroniczną. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Jeśli protokół IPv6 jest włączony, a ConnectAsync(String, Int32) metoda jest wywoływana w celu nawiązania połączenia z hostem rozpoznawanym zarówno adresami IPv6, jak i IPv4, połączenie z adresem IPv6 zostanie podjęta najpierw przed adresem IPv4. Może to mieć wpływ na opóźnienie czasu nawiązania połączenia, jeśli host nie nasłuchuje na adresie IPv6.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(String, Int32)usługę .

Zobacz też

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPEndPoint, CancellationToken)

Źródło:

TCPClient.cs

Łączy klienta z zdalnym hostem TCP przy użyciu określonego punktu końcowego jako operacji asynchronicznej.

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

Parametry

remoteEP

IPEndPoint

Element IPEndPoint , z którym zamierzasz nawiązać połączenie.

cancellationToken

CancellationToken

Token odwołania, wykorzystywany do propagowania powiadomienia, że niniejsza operacja powinna zostać anulowana.

Zwraca

ValueTask

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Zwraca Task zostanie ukończony po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta zdalnego z określoną metodą IPEndPoint. Przed wywołaniem Connectmetody należy utworzyć wystąpienie IPEndPoint klasy przy użyciu adresu IP i numeru portu. Użyj tego IPEndPoint jako parametru remoteEP . Metoda Connect zostanie zablokowana do momentu nawiązania połączenia lub niepowodzenia. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(IPEndPoint)usługę .

ConnectAsync(IPAddress[], Int32)

Źródło:

TCPClient.cs

Łączy klienta z zdalnym hostem TCP przy użyciu określonych adresów IP i numeru portu jako operacji asynchronicznej.

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

Parametry

addresses

IPAddress[]

Tablica IPAddress hosta, z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu, z którym zamierzasz nawiązać połączenie.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr ipAddresses to null.

ArgumentOutOfRangeException

Numer portu jest nieprawidłowy.

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.

NotSupportedException

Ta metoda jest prawidłowa dla gniazd, które używają flagi InterNetwork lub flagi InterNetworkV6 .

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Zwraca Task zostanie ukończony po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

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. Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z hostem określonym przez tablicę IPAddress elementów i numer portu jako operację asynchroniczną. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(IPAddress[], Int32)usługę .

Zobacz też

• TcpListener

ConnectAsync(IPAddress, Int32)

Źródło:

TCPClient.cs

Łączy klienta z zdalnym hostem TCP przy użyciu określonego adresu IP i numeru portu jako operacji asynchronicznej.

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

Parametry

address

IPAddress

Host IPAddress , z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu, z którym zamierzasz nawiązać połączenie.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr address to null.

ArgumentOutOfRangeException

Wartość port nie znajduje się między MinPort i MaxPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

ObjectDisposedException

TcpClient jest zamknięty.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt Zwraca Task zostanie ukończony po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z określonym IPAddress numerem portu i jako operację asynchroniczną. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(IPAddress, Int32)usługę .

Zobacz też

• GetStream()

ConnectAsync(IPEndPoint)

Źródło:

TCPClient.cs

Łączy klienta z zdalnym hostem TCP przy użyciu określonego punktu końcowego jako operacji asynchronicznej.

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

Parametry

remoteEP

IPEndPoint

Element IPEndPoint , z którym zamierzasz nawiązać połączenie.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task po nawiązaniu połączenia TCP. Ta metoda nie blokuje wątku wywołującego, gdy żądanie połączenia jest w toku.

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta zdalnego z określoną metodą IPEndPoint. Przed wywołaniem Connectmetody należy utworzyć wystąpienie IPEndPoint klasy przy użyciu adresu IP i numeru portu. Użyj tego IPEndPoint jako parametru remoteEP . Metoda Connect zostanie zablokowana do momentu nawiązania połączenia lub niepowodzenia. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody , aby uzyskać bazowy NetworkStreamelement . Użyj tego polecenia NetworkStream , aby wysyłać i odbierać dane.

Uwaga

Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Uwaga

Jeśli zostanie wyświetlony NotSupportedException komunikat "Ta wersja protokołu nie jest obsługiwana" podczas korzystania z adresu IPv6, upewnij się, że włączono protokół IPv6 w konstruktorze, przekazując InterNetworkV6polecenie .

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Connect(IPEndPoint)usługę .