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, CancellationToken)

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

ConnectAsync(IPAddress[], Int32, CancellationToken)

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

ConnectAsync(IPAddress, Int32, CancellationToken)

Ansluter klienten till en fjärransluten TCP-värd med den angivna IP-adressen och portnumret 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.

ConnectAsync(IPEndPoint, CancellationToken)

Ansluter klienten till en fjärransluten TCP-värd med den angivna slutpunkten 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(IPAddress, Int32)

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

ConnectAsync(IPEndPoint)

Ansluter klienten till en fjärransluten TCP-värd med den angivna slutpunkten som en asynkron åtgärd.

ConnectAsync(String, Int32, CancellationToken)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

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

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

Parametrar

host
String

DNS-namnet på fjärrvärden.

port
Int32

Portnumret för fjärrvärden.

cancellationToken
CancellationToken

En annulleringstoken som kan användas för att signalera den asynkrona åtgärden bör avbrytas.

Returer

En uppgift som representerar den asynkrona anslutningsåtgärden.

Undantag

Parametern host är null.

Parametern port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Den här åtgärden kommer inte att blockeras. Den returnerade aktiviteten 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, CancellationToken)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

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

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

Parametrar

addresses
IPAddress[]

Matrisen med IP-adressen för fjärrvärden.

port
Int32

Portnumret för fjärrvärden.

cancellationToken
CancellationToken

En annulleringstoken som kan användas för att signalera den asynkrona åtgärden bör avbrytas.

Returer

En uppgift som representerar den asynkrona anslutningså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.

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Den här åtgärden kommer inte att blockeras. Den returnerade aktiviteten 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 IP-adresser 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

ConnectAsync(IPAddress, Int32, CancellationToken)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

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::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

Parametrar

address
IPAddress

IP-adressen för fjärrvärden.

port
Int32

Portnumret för fjärrvärden.

cancellationToken
CancellationToken

En annulleringstoken som kan användas för att signalera den asynkrona åtgärden bör avbrytas.

Returer

En uppgift som representerar den asynkrona anslutningsåtgärden.

Undantag

Parametern address är null.

port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Den här åtgärden kommer inte att blockeras. Den returnerade aktiviteten 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 den angivna IP-adressen 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

ConnectAsync(String, Int32)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

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(IPEndPoint, CancellationToken)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

Ansluter klienten till en fjärransluten TCP-värd med den angivna slutpunkten som en asynkron åtgärd.

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

Parametrar

remoteEP
IPEndPoint

Den IPEndPoint som du tänker ansluta till.

cancellationToken
CancellationToken

En annulleringstoken som används för att sprida meddelanden om att åtgärden ska avbrytas.

Returer

En uppgift som representerar den asynkrona åtgärden.

Undantag

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

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 den angivna IPEndPoint. Innan du anropar Connectmåste du skapa en instans av klassen med hjälp av IPEndPoint en IP-adress och ett portnummer. Använd detta IPEndPoint som remoteEP parameter. Metoden Connect blockeras tills den antingen ansluter eller misslyckas. 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(IPEndPoint).

Gäller för

ConnectAsync(IPAddress[], Int32)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

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

ConnectAsync(IPAddress, Int32)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

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(IPEndPoint)

Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs
Källa:
TCPClient.cs

Ansluter klienten till en fjärransluten TCP-värd med den angivna slutpunkten som en asynkron åtgärd.

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

Parametrar

remoteEP
IPEndPoint

Den IPEndPoint som du tänker ansluta till.

Returer

En uppgift som representerar den asynkrona åtgärden.

Kommentarer

Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task 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 den angivna IPEndPoint. Innan du anropar Connectmåste du skapa en instans av klassen med hjälp av IPEndPoint en IP-adress och ett portnummer. Använd detta IPEndPoint som remoteEP parameter. Metoden Connect blockeras tills den antingen ansluter eller misslyckas. 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 API 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 ett NotSupportedException med meddelandet "Den här protokollversionen stöds inte" 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(IPEndPoint).

Gäller för