TcpClient.ConnectAsync Metod

Definition

Ansluter klienten till en fjärransluten TCP-värd med det angivna värdnamnet och portnumret som en asynkron åtgärd.

Överlagringar

Name Description
ConnectAsync(String, Int32)

Ansluter klienten till den angivna TCP-porten på den angivna värden som en asynkron åtgärd.

ConnectAsync(IPAddress, Int32)

Ansluter klienten till en fjärransluten TCP-värd med den angivna IP-adressen och portnumret som en asynkron åtgärd.

ConnectAsync(IPAddress[], Int32)

Ansluter klienten till en fjärransluten TCP-värd med angivna IP-adresser och portnummer som en asynkron åtgärd.

ConnectAsync(String, Int32)

Ansluter klienten till den angivna TCP-porten på den angivna värden som en asynkron åtgärd.

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

Parametrar

host
String

DNS-namnet på fjärrvärden som du tänker ansluta till.

port
Int32

Portnumret för fjärrvärden som du tänker ansluta till.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

Parametern host är null.

Parametern port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet Returnerar Task slutförs när TCP-anslutningen har upprättats. Den här metoden blockerar inte den anropande tråden när anslutningsbegäran pågår.

Anropa den här metoden för att upprätta en synkron fjärrvärdanslutning till det angivna värdnamnet och portnumret som en asynkron åtgärd. När du har anslutit med fjärrvärden använder du GetStream metoden för att hämta den underliggande NetworkStream. Använd detta NetworkStream för att skicka och ta emot data.

Om IPv6 är aktiverat och ConnectAsync(String, Int32) metoden anropas för att ansluta till en värd som matchar både IPv6- och IPv4-adresser, görs ett försök att ansluta till IPv6-adressen först före IPv4-adressen. Detta kan medföra att tiden för att upprätta anslutningen fördröjs om värden inte lyssnar på IPv6-adressen.

Note

Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(String, Int32).

Se även

Gäller för

ConnectAsync(IPAddress, Int32)

Ansluter klienten till en fjärransluten TCP-värd med den angivna IP-adressen och portnumret som en asynkron åtgärd.

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

Parametrar

address
IPAddress

Den IPAddress värd som du tänker ansluta till.

port
Int32

Det portnummer som du tänker ansluta till.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

Parametern address är null.

port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet Returnerar Task slutförs när TCP-anslutningen har upprättats. Den här metoden blockerar inte den anropande tråden när anslutningsbegäran pågår.

Anropa den här metoden för att upprätta en synkron fjärrvärdanslutning till angivet IPAddress och portnummer som en asynkron åtgärd. När du har anslutit med fjärrvärden använder du GetStream metoden för att hämta den underliggande NetworkStream. Använd detta NetworkStream för att skicka och ta emot data.

Note

Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Note

Om du får NotSupportedException med meddelande This protocol version is not supported när du använder IPv6-adressen kontrollerar du att du har aktiverat IPv6 i konstruktorn genom att skicka InterNetworkV6.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(IPAddress, Int32).

Se även

Gäller för

ConnectAsync(IPAddress[], Int32)

Ansluter klienten till en fjärransluten TCP-värd med angivna IP-adresser och portnummer som en asynkron åtgärd.

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

Parametrar

addresses
IPAddress[]

Matrisen IPAddress för den värd som du tänker ansluta till.

port
Int32

Det portnummer som du tänker ansluta till.

Returer

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

Parametern addresses är null.

Portnumret är inte giltigt.

Ett fel uppstod vid försök att komma åt socketen.

En anropare högre i anropsstacken har inte behörighet för den begärda åtgärden.

Den här metoden är giltig för socketar som använder InterNetwork flaggan eller InterNetworkV6 flaggan.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet Returnerar Task slutförs när TCP-anslutningen har upprättats. Den här metoden blockerar inte den anropande tråden när anslutningsbegäran pågår.

Den här metoden används vanligtvis omedelbart efter ett anrop till BeginGetHostAddresses metoden, som kan returnera flera IP-adresser för en enda värd. Anropa den här metoden för att upprätta en synkron fjärrvärdanslutning till värden som anges av matrisen med IPAddress element och portnumret som en asynkron åtgärd. När du har anslutit med fjärrvärden använder du GetStream metoden för att hämta den underliggande NetworkStream. Använd detta NetworkStream för att skicka och ta emot data.

Note

Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Note

Om du får NotSupportedException med meddelande This protocol version is not supported när du använder IPv6-adressen kontrollerar du att du har aktiverat IPv6 i konstruktorn genom att skicka InterNetworkV6.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(IPAddress[], Int32).

Se även

Gäller för