Sdílet prostřednictvím


Socket.ConnectAsync Metoda

Definice

Zahájí asynchronní požadavek na připojení ke vzdálenému hostiteli.

Přetížení

ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs)

Zahájí asynchronní požadavek na připojení ke vzdálenému hostiteli.

ConnectAsync(IPAddress[], Int32, CancellationToken)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(String, Int32, CancellationToken)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(IPAddress, Int32, CancellationToken)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(String, Int32)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(IPAddress[], Int32)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(IPAddress, Int32)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(EndPoint, CancellationToken)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(SocketAsyncEventArgs)

Zahájí asynchronní požadavek na připojení ke vzdálenému hostiteli.

ConnectAsync(EndPoint)

Naváže připojení ke vzdálenému hostiteli.

ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs)

Zdroj:
Socket.cs
Zdroj:
Socket.cs
Zdroj:
Socket.cs

Zahájí asynchronní požadavek na připojení ke vzdálenému hostiteli.

public:
 static bool ConnectAsync(System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType, System::Net::Sockets::SocketAsyncEventArgs ^ e);
public static bool ConnectAsync (System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType, System.Net.Sockets.SocketAsyncEventArgs e);
static member ConnectAsync : System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType * System.Net.Sockets.SocketAsyncEventArgs -> bool
Public Shared Function ConnectAsync (socketType As SocketType, protocolType As ProtocolType, e As SocketAsyncEventArgs) As Boolean

Parametry

socketType
SocketType

Jedna z SocketType hodnot.

protocolType
ProtocolType

Jedna z ProtocolType hodnot.

e
SocketAsyncEventArgs

Objekt SocketAsyncEventArgs , který se má použít pro tuto asynchronní soketové operace.

Návraty

true pokud operace V/V čeká na vyřízení. Událost Completed parametru e se vyvolá po dokončení operace.

false pokud se vstupně-výstupní operace dokončila synchronně. V tomto případě událost parametru e nebude vyvolána a e objekt předaný jako parametr může být prozkoumán okamžitě poté, Completed co se volání metody vrátí, aby se načetl výsledek operace.

Výjimky

Argument není platný. K této výjimce dochází, pokud je zadáno více vyrovnávacích pamětí, BufferList vlastnost nemá hodnotu null.

Parametr e nemůže být null a RemoteEndPoint parametr nemůže být null.

Naslouchá Socket nebo operace soketu již probíhala pomocí objektu SocketAsyncEventArgs zadaného v parametru e .

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

Místní koncový bod a RemoteEndPoint nejsou stejná řada adres.

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

Poznámky

Pokud používáte protokol orientovaný na připojení, metoda M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.Sockets.Sockets.Sockets,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs) spustí asynchronní požadavek na připojení ke vzdálenému hostiteli. Pokud používáte protokol bez připojení, ConnectAsync nástroj vytvoří výchozího vzdáleného hostitele určeného socketType parametry a protocolType .

Chcete-li být upozorněni na dokončení, musíte vytvořit metodu zpětného volání, která implementuje EventHandler<SocketAsyncEventArgs> delegáta a připojit zpětné volání k SocketAsyncEventArgs.Completed události.

Volající musí nastavit SocketAsyncEventArgs.RemoteEndPoint vlastnost na IPEndPoint vzdáleného hostitele, ke kterému se má připojit.

Volající může nastavit SocketAsyncEventArgs.UserToken vlastnost na libovolný objekt stavu uživatele požadovaný před voláním ConnectAsync metody tak, aby informace bylo možné získat v metodě zpětného volání. Pokud zpětné volání potřebuje více informací než jeden objekt, lze vytvořit malou třídu, která bude obsahovat ostatní požadované informace o stavu jako členy.

Pokud používáte protokol bez připojení, například UDP, nemusíte před odesláním a příjmem dat volat ConnectAsync . Ke komunikaci se vzdáleným hostitelem můžete použít a SendToAsyncReceiveFromAsync . Pokud zavoláte ConnectAsync, všechny datagramy, které přicházejí z jiné než zadané výchozí adresy, budou zahozeny. Pokud chcete změnit výchozího vzdáleného hostitele, zavolejte metodu ConnectAsync znovu s požadovaným koncovým bodem.

Pokud chcete nastavit výchozího vzdáleného hostitele na adresu všesměrového vysílání, musíte nejprve zavolat SetSocketOption a nastavit všesměrové vysílání na true. Pokud se to neudělá, ConnectAsync metoda vyvolá SocketException.

Vyžadují se následující vlastnosti a události objektu System.Net.Sockets.SocketAsyncEventArgs :

Volitelně může být poskytnuta vyrovnávací paměť, která se po úspěšném provedení metody atomicky odešle do soketu ConnectAsync . V takovém případě je potřeba vlastnost nastavit na vyrovnávací paměť obsahující data, SocketAsyncEventArgs.Buffer která se mají odeslat, a SocketAsyncEventArgs.Count vlastnost musí být nastavena na počet bajtů dat, které se mají z vyrovnávací paměti odeslat. Po navázání připojení se tato vyrovnávací paměť dat odešle.

Pokud používáte protokol orientovaný na připojení a před voláním ConnectAsyncnevoláte Bind , přiřadí příslušný poskytovatel služeb nejvhodnější místní síťovou adresu a číslo portu.

Pokud používáte protokol bez připojení, poskytovatel služeb nepřiřadí IP adresu a číslo portu místní sítě, dokud nezavoláte SendAsync metody nebo ReceiveAsync .

Metoda ConnectAsync vyvolá výjimku NotSupportedException , pokud rodina Socket adres a SocketAsyncEventArgs.RemoteEndPoint nejsou stejné rodiny adres.

Poznámka

Pokud se při volání této metody zobrazí SocketException , pomocí SocketException.ErrorCode vlastnosti získejte konkrétní kód chyby. Jakmile tento kód získáte, projděte si podrobný popis chyby v dokumentaci k rozhraní API rozhraní Windows Sockets verze 2 .

Platí pro

ConnectAsync(IPAddress[], Int32, CancellationToken)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

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

Seznam IPAddresses pro vzdáleného hostitele, které se použijí k pokusu o připojení ke vzdálenému hostiteli.

port
Int32

Port na vzdáleném hostiteli, ke kterému se chcete připojit.

cancellationToken
CancellationToken

Token zrušení, který lze použít ke zrušení asynchronní operace.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr addresses nemůže být null.

Parametr addresses nemůže být prázdným polem.

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

Zásuvka není v rodině InterNetwork nebo InterNetworkV6 .

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

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(IPAddress[], Int32).

Platí pro

ConnectAsync(String, Int32, CancellationToken)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

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 hostitele vzdáleného hostitele, ke kterému se chcete připojit.

port
Int32

Port na vzdáleném hostiteli, ke kterému se chcete připojit.

cancellationToken
CancellationToken

Token zrušení, který lze použít ke zrušení asynchronní operace.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr host nemůže být null.

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

Zásuvka není v rodině InterNetwork nebo InterNetworkV6 .

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

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(String, Int32).

Platí pro

ConnectAsync(IPAddress, Int32, CancellationToken)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

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, ke kterému se chcete připojit.

port
Int32

Port na vzdáleném hostiteli, ke kterému se chcete připojit.

cancellationToken
CancellationToken

Token zrušení, který lze použít ke zrušení asynchronní operace.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr address nemůže být null.

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

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

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(IPAddress, Int32).

Platí pro

ConnectAsync(String, Int32)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

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 hostitele vzdáleného hostitele, ke kterému se chcete připojit.

port
Int32

Port na vzdáleném hostiteli, ke kterému se chcete připojit.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr host nemůže být null.

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

Soket není v rodině InterNetwork nebo InterNetworkV6 .

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

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(String, Int32).

Platí pro

ConnectAsync(IPAddress[], Int32)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

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

Seznam IPAddresses pro vzdáleného hostitele, který se použije k pokusu o připojení ke vzdálenému hostiteli.

port
Int32

Port na vzdáleném hostiteli, ke kterému se chcete připojit.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr addresses nemůže být null.

Parametrem addresses nemůže být prázdné pole.

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

Soket není v rodině InterNetwork nebo InterNetworkV6 .

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

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(IPAddress[], Int32).

Platí pro

ConnectAsync(IPAddress, Int32)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

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

Ip adresa vzdáleného hostitele, ke kterému se chcete připojit.

port
Int32

Port na vzdáleném hostiteli, ke kterému se chcete připojit.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr address nemůže být null.

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

Soket není v rodině InterNetwork nebo InterNetworkV6 .

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

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(IPAddress, Int32).

Platí pro

ConnectAsync(EndPoint, CancellationToken)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::EndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken);
member this.ConnectAsync : System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ConnectAsync (remoteEP As EndPoint, cancellationToken As CancellationToken) As ValueTask

Parametry

remoteEP
EndPoint

Koncový bod, ke kterému se chcete připojit.

cancellationToken
CancellationToken

Token zrušení, který lze použít ke zrušení asynchronní operace.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr remoteEP nemůže být null.

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

Místní koncový bod a remoteEP parametr nejsou stejné řady adres.

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(EndPoint).

Platí pro

ConnectAsync(SocketAsyncEventArgs)

Zdroj:
Socket.cs
Zdroj:
Socket.cs
Zdroj:
Socket.cs

Zahájí asynchronní požadavek na připojení ke vzdálenému hostiteli.

public:
 bool ConnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);
public bool ConnectAsync (System.Net.Sockets.SocketAsyncEventArgs e);
member this.ConnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool
Public Function ConnectAsync (e As SocketAsyncEventArgs) As Boolean

Parametry

e
SocketAsyncEventArgs

Objekt SocketAsyncEventArgs , který se má použít pro tuto asynchronní operaci soketu.

Návraty

true pokud operace V/V čeká na vyřízení. Událost Completed parametru e se vyvolá po dokončení operace.

false pokud se vstupně-výstupní operace dokončila synchronně. V tomto případě událost parametru e nebude vyvolána a e objekt předaný jako parametr může být prozkoumán okamžitě poté, Completed co se volání metody vrátí, aby se načetl výsledek operace.

Výjimky

Argument není platný. K této výjimce dochází, pokud je zadáno více vyrovnávacích pamětí, BufferList vlastnost není null.

Parametr e nemůže být null a RemoteEndPoint parametr nemůže být null.

Naslouchá Socket nebo již probíhala operace soketu pomocí objektu SocketAsyncEventArgs zadaného v parametru e .

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

Místní koncový bod a RemoteEndPoint adresa nejsou stejné řady adres.

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

Poznámky

Pokud používáte protokol orientovaný na připojení, ConnectAsync metoda spustí asynchronní požadavek na připojení ke vzdálenému hostiteli. Pokud používáte protokol bez připojení, ConnectAsync vytvoří výchozího vzdáleného hostitele.

Chcete-li být upozorněni na dokončení, musíte vytvořit metodu zpětného volání, která implementuje EventHandler<SocketAsyncEventArgs> delegáta a připojit zpětné volání k SocketAsyncEventArgs.Completed události.

Volající musí nastavit SocketAsyncEventArgs.RemoteEndPoint vlastnost na IPEndPoint vzdáleného hostitele, ke kterému se má připojit.

Volající může nastavit SocketAsyncEventArgs.UserToken vlastnost na libovolný objekt stavu uživatele požadovaný před voláním ConnectAsync metody tak, aby informace bylo možné získat v metodě zpětného volání. Pokud zpětné volání potřebuje více informací než jeden objekt, lze vytvořit malou třídu, která bude obsahovat ostatní požadované informace o stavu jako členy.

Pokud používáte protokol bez připojení, například UDP, nemusíte před odesláním a příjmem dat volat ConnectAsync . Ke komunikaci se vzdáleným hostitelem můžete použít a SendToAsyncReceiveFromAsync . Pokud zavoláte ConnectAsync, všechny datagramy, které přicházejí z jiné než zadané výchozí adresy, budou zahozeny. Pokud chcete změnit výchozího vzdáleného hostitele, zavolejte metodu ConnectAsync znovu s požadovaným koncovým bodem.

Pokud chcete nastavit výchozího vzdáleného hostitele na adresu všesměrového vysílání, musíte nejprve zavolat SetSocketOption a nastavit všesměrové vysílání na true. Pokud se to neudělá, ConnectAsync metoda vyvolá SocketException.

Vyžadují se následující vlastnosti a události objektu System.Net.Sockets.SocketAsyncEventArgs :

Volitelně může být poskytnuta vyrovnávací paměť, která se po úspěšném provedení metody atomicky odešle do soketu ConnectAsync . V takovém případě je potřeba vlastnost nastavit na vyrovnávací paměť obsahující data, SocketAsyncEventArgs.Buffer která se mají odeslat, a SocketAsyncEventArgs.Count vlastnost musí být nastavena na počet bajtů dat, které se mají z vyrovnávací paměti odeslat. Po navázání připojení se tato vyrovnávací paměť dat odešle.

Pokud používáte protokol orientovaný na připojení a před voláním ConnectAsyncnevoláte Bind , přiřadí příslušný poskytovatel služeb nejvhodnější místní síťovou adresu a číslo portu.

Pokud používáte protokol bez připojení, poskytovatel služeb nepřiřadí IP adresu a číslo portu místní sítě, dokud nezavoláte SendAsync metody nebo ReceiveAsync .

Metoda ConnectAsync vyvolá výjimku NotSupportedException , pokud rodina Socket adres a SocketAsyncEventArgs.RemoteEndPoint nejsou stejné rodiny adres.

Poznámka

Pokud se při volání této metody zobrazí SocketException , pomocí SocketException.ErrorCode vlastnosti získejte konkrétní kód chyby. Jakmile tento kód získáte, projděte si podrobný popis chyby v dokumentaci k rozhraní API rozhraní Windows Sockets verze 2 .

Viz také

Platí pro

ConnectAsync(EndPoint)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Naváže připojení ke vzdálenému hostiteli.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::EndPoint ^ remoteEP);
public System.Threading.Tasks.Task ConnectAsync (System.Net.EndPoint remoteEP);
member this.ConnectAsync : System.Net.EndPoint -> System.Threading.Tasks.Task
Public Function ConnectAsync (remoteEP As EndPoint) As Task

Parametry

remoteEP
EndPoint

Koncový bod, ke kterému se chcete připojit.

Návraty

Asynchronní úloha, která se dokončí při navázání připojení.

Výjimky

Parametr remoteEP nemůže být null.

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

Místní koncový bod a remoteEP parametr nejsou stejné řady adres.

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Connect(EndPoint).

Platí pro