Udostępnij za pośrednictwem


TcpClient.ConnectAsync Metoda

Definicja

Łą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
Źródło:
TCPClient.cs
Ź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

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

Wyjątki

Parametr host to null.

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

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

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ż

Dotyczy

ConnectAsync(IPAddress[], Int32, CancellationToken)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Ź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

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

Wyjątki

Parametr ipAddresses to null.

Numer portu jest nieprawidłowy.

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

Została zamknięta Socket .

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

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

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ż

Dotyczy

ConnectAsync(IPAddress, Int32, CancellationToken)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Ź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

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

Wyjątki

Parametr address to null.

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

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

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ż

Dotyczy

ConnectAsync(String, Int32)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Ź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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Parametr host to null.

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

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

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ż

Dotyczy

ConnectAsync(IPEndPoint, CancellationToken)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Ź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

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

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ę .

Dotyczy

ConnectAsync(IPAddress[], Int32)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Ź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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Parametr ipAddresses to null.

Numer portu jest nieprawidłowy.

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

Została zamknięta Socket .

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

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ż

Dotyczy

ConnectAsync(IPAddress, Int32)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Ź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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Parametr address to null.

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

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

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ż

Dotyczy

ConnectAsync(IPEndPoint)

Źródło:
TCPClient.cs
Źródło:
TCPClient.cs
Ź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

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ę .

Dotyczy