TcpClient.ConnectAsync Metoda

Definice

Obor názvů:: System.Net.Sockets

Sestavení:: netstandard.dll, System.Net.Sockets.dll

Sestavení:: System.Net.Sockets.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného názvu hostitele a čísla portu jako asynchronní operace.

Přetížení

Name	Description
ConnectAsync(String, Int32, CancellationToken)	Připojí klienta k zadanému portu TCP na zadaném hostiteli jako asynchronní operaci.
ConnectAsync(IPAddress[], Int32, CancellationToken)	Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaných IP adres a čísla portu jako asynchronní operace.
ConnectAsync(IPAddress, Int32, CancellationToken)	Připojí klienta ke vzdálenému hostiteli TCP pomocí zadané IP adresy a čísla portu jako asynchronní operace.
ConnectAsync(String, Int32)	Připojí klienta k zadanému portu TCP na zadaném hostiteli jako asynchronní operaci.
ConnectAsync(IPEndPoint, CancellationToken)	Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného koncového bodu jako asynchronní operace.
ConnectAsync(IPAddress[], Int32)	Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaných IP adres a čísla portu jako asynchronní operace.
ConnectAsync(IPAddress, Int32)	Připojí klienta ke vzdálenému hostiteli TCP pomocí zadané IP adresy a čísla portu jako asynchronní operace.
ConnectAsync(IPEndPoint)	Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného koncového bodu jako asynchronní operace.

ConnectAsync(String, Int32, CancellationToken)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta k zadanému portu TCP na zadaném hostiteli jako asynchronní operaci.

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

Název DNS vzdáleného hostitele.

port: Int32

Číslo portu vzdáleného hostitele.

cancellationToken: CancellationToken

Token zrušení, který lze použít k signalizaci asynchronní operace, by se měl zrušit.

Návraty

ValueTask

Úloha, která představuje asynchronní operaci připojení.

Výjimky

ArgumentNullException

Parametr host je null.

ArgumentOutOfRangeException

Parametr port není mezi MinPort a MaxPort.

SocketException

Při přístupu k soketu došlo k chybě.

ObjectDisposedException

TcpClient je uzavřen.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Tato operace nebude blokovat. Vrácený úkol se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Voláním této metody vytvoříte synchronní připojení vzdáleného hostitele k zadanému názvu hostitele a číslu portu jako asynchronní operaci. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamsouboru . NetworkStream Slouží k odesílání a přijímání dat.

Pokud je povolený protokol IPv6 a volá se ConnectAsync(String, Int32) metoda pro připojení k hostiteli, který se překládá na adresy IPv6 i IPv4, připojení k adrese IPv6 se nejprve pokusí před adresou IPv4. To může mít vliv na zpoždění času na navázání připojení, pokud hostitel nenaslouchá na adrese IPv6.

Note

Pokud se zobrazí SocketExceptionkód chyby, použijte SocketException.ErrorCode ho k získání konkrétního kódu chyby. Jakmile tento kód získáte, můžete se podívat do dokumentace k chybě rozhraní API verze 2 rozhraní Windows Sockets , kde najdete podrobný popis chyby.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Connect(String, Int32).

Viz také

Platí pro

ConnectAsync(IPAddress[], Int32, CancellationToken)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaných IP adres a čísla portu jako asynchronní operace.

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[]

Pole IP adresy vzdáleného hostitele.

port: Int32

Číslo portu vzdáleného hostitele.

cancellationToken: CancellationToken

Token zrušení, který lze použít k signalizaci asynchronní operace, by se měl zrušit.

Návraty

ValueTask

Úloha, která představuje asynchronní operaci připojení.

Výjimky

ArgumentNullException

Parametr addresses je null.

ArgumentOutOfRangeException

Číslo portu není platné.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající vyšší v zásobníku volání nemá oprávnění pro požadovanou operaci.

NotSupportedException

Tato metoda je platná pro sokety, které používají InterNetwork příznak nebo InterNetworkV6 příznak.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Tato operace nebude blokovat. Vrácený úkol se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Tato metoda se obvykle používá ihned po volání BeginGetHostAddresses metody, která může vrátit více IP adres pro jednoho hostitele. Voláním této metody vytvoříte synchronní připojení vzdáleného hostitele k hostiteli určenému polem IP adres a číslem portu jako asynchronní operací. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamsouboru . NetworkStream Slouží k odesílání a přijímání dat.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Note

Pokud obdržíte NotSupportedException se zprávou This protocol version is not supported při použití IPv6 adresy, ujistěte se, že jste povolili IPv6 v konstruktoru předáním InterNetworkV6.

Viz také

TcpListener

Platí pro

ConnectAsync(IPAddress, Int32, CancellationToken)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadané IP adresy a čísla portu jako asynchronní operace.

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

IP adresa vzdáleného hostitele.

port: Int32

Číslo portu vzdáleného hostitele.

cancellationToken: CancellationToken

Token zrušení, který lze použít k signalizaci asynchronní operace, by se měl zrušit.

Návraty

ValueTask

Úloha, která představuje asynchronní operaci připojení.

Výjimky

ArgumentNullException

Parametr address je null.

ArgumentOutOfRangeException

Není port mezi MinPort a MaxPort.

SocketException

Při přístupu k soketu došlo k chybě.

ObjectDisposedException

TcpClient je uzavřen.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Tato operace nebude blokovat. Vrácený úkol se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Voláním této metody vytvoříte synchronní připojení vzdáleného hostitele k zadané IP adrese a číslu portu jako asynchronní operace. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamsouboru . NetworkStream Slouží k odesílání a přijímání dat.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Note

Pokud obdržíte NotSupportedException se zprávou This protocol version is not supported při použití IPv6 adresy, ujistěte se, že jste povolili IPv6 v konstruktoru předáním InterNetworkV6.

Viz také

GetStream()

Platí pro

ConnectAsync(String, Int32)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta k zadanému portu TCP na zadaném hostiteli jako asynchronní operaci.

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

Název DNS vzdáleného hostitele, ke kterému se chcete připojit.

port: Int32

Číslo portu vzdáleného hostitele, ke kterému se chcete připojit.

Návraty

Task

Objekt úkolu představující asynchronní operaci.

Výjimky

ArgumentNullException

Parametr host je null.

ArgumentOutOfRangeException

Parametr port není mezi MinPort a MaxPort.

SocketException

Při přístupu k soketu došlo k chybě.

ObjectDisposedException

TcpClient je uzavřen.

Poznámky

Tato operace nebude blokovat. Vrácený objekt Return Task se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Viz také

Platí pro

ConnectAsync(IPEndPoint, CancellationToken)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného koncového bodu jako asynchronní operace.

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

K IPEndPoint tomu, ke kterému se chcete připojit.

cancellationToken: CancellationToken

Token zrušení použitý k šíření oznámení, že by tato operace měla být zrušena.

Návraty

ValueTask

Úloha představující asynchronní operaci.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Tato operace nebude blokovat. Vrácený objekt Return Task se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Voláním této metody navážete synchronní připojení vzdáleného hostitele k zadanému IPEndPoint. Před voláním Connectmusíte vytvořit instanci IPEndPoint třídy pomocí IP adresy a čísla portu. Použijte ho IPEndPointremoteEP jako parametr. Metoda Connect se zablokuje, dokud se nepřipojí nebo selže. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamsouboru . NetworkStream Slouží k odesílání a přijímání dat.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Note

Pokud obdržíte NotSupportedException se zprávou This protocol version is not supported při použití IPv6 adresy, ujistěte se, že jste povolili IPv6 v konstruktoru předáním InterNetworkV6.

Platí pro

ConnectAsync(IPAddress[], Int32)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaných IP adres a čísla portu jako asynchronní operace.

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[]

Pole IPAddress hostitele, ke kterému se chcete připojit.

port: Int32

Číslo portu, ke kterému se chcete připojit.

Návraty

Task

Objekt úkolu představující asynchronní operaci.

Výjimky

ArgumentNullException

Parametr addresses je null.

ArgumentOutOfRangeException

Číslo portu není platné.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající vyšší v zásobníku volání nemá oprávnění pro požadovanou operaci.

NotSupportedException

Tato metoda je platná pro sokety, které používají InterNetwork příznak nebo InterNetworkV6 příznak.

Poznámky

Tato operace nebude blokovat. Vrácený objekt Return Task se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Tato metoda se obvykle používá ihned po volání BeginGetHostAddresses metody, která může vrátit více IP adres pro jednoho hostitele. Voláním této metody navážete synchronní připojení vzdáleného hostitele k hostiteli určenému polem IPAddress prvků a číslo portu jako asynchronní operace. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamsouboru . NetworkStream Slouží k odesílání a přijímání dat.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Note

Pokud obdržíte NotSupportedException se zprávou This protocol version is not supported při použití IPv6 adresy, ujistěte se, že jste povolili IPv6 v konstruktoru předáním InterNetworkV6.

Viz také

TcpListener

Platí pro

ConnectAsync(IPAddress, Int32)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadané IP adresy a čísla portu jako asynchronní operace.

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

Hostitel IPAddress , ke kterému se chcete připojit.

port: Int32

Číslo portu, ke kterému se chcete připojit.

Návraty

Task

Objekt úkolu představující asynchronní operaci.

Výjimky

ArgumentNullException

Parametr address je null.

ArgumentOutOfRangeException

Není port mezi MinPort a MaxPort.

SocketException

Při přístupu k soketu došlo k chybě.

ObjectDisposedException

TcpClient je uzavřen.

Poznámky

Tato operace nebude blokovat. Vrácený objekt Return Task se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Voláním této metody vytvoříte synchronní připojení vzdáleného hostitele k zadanému IPAddress a číslu portu jako asynchronní operaci. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamsouboru . NetworkStream Slouží k odesílání a přijímání dat.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Note

Pokud obdržíte NotSupportedException se zprávou This protocol version is not supported při použití IPv6 adresy, ujistěte se, že jste povolili IPv6 v konstruktoru předáním InterNetworkV6.

Viz také

GetStream()

Platí pro

ConnectAsync(IPEndPoint)

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Zdroj:: TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného koncového bodu jako asynchronní operace.

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

K IPEndPoint tomu, ke kterému se chcete připojit.

Návraty

Task

Úloha představující asynchronní operaci.

Poznámky

Tato operace nebude blokovat. Vrácený Task objekt se dokončí po navázání připojení TCP. Tato metoda neblokuje volající vlákno v době, kdy probíhá požadavek na připojení.

Note

Pokud se zobrazí SocketExceptionkód chyby, použijte SocketException.ErrorCode ho k získání konkrétního kódu chyby. Po získání tohoto kódu se můžete podívat na kód chyby rozhraní API verze 2 Windows sockets verze 2 dokumentaci k podrobnému popisu chyby.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Note

Pokud se vám při použití adresy IPv6 zobrazí NotSupportedException zpráva "Tato verze protokolu není podporována", ujistěte se, že jste v konstruktoru povolili protokol IPv6 předáním InterNetworkV6.

Platí pro

Váš názor

Byla tato stránka užitečná?