Socket.ConnectAsync Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

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

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

Boolean

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

ArgumentException

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.

ArgumentNullException

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

InvalidOperationException

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

SocketException

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

NotSupportedException

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

ObjectDisposedException

Byla Socket uzavřena.

SecurityException

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 :

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

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 .

ConnectAsync(IPAddress[], Int32, CancellationToken)

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

ValueTask

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

Výjimky

ArgumentNullException

Parametr addresses nemůže být null.

ArgumentException

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

ArgumentOutOfRangeException

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

InvalidOperationException

Poslouchá Socket .

NotSupportedException

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

SocketException

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

ObjectDisposedException

Byla Socket uzavřena.

SecurityException

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

OperationCanceledException

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

ConnectAsync(String, Int32, CancellationToken)

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

ValueTask

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

Výjimky

ArgumentNullException

Parametr host nemůže být null.

ArgumentOutOfRangeException

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

InvalidOperationException

Poslouchá Socket .

NotSupportedException

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

SocketException

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

ObjectDisposedException

Byla Socket uzavřena.

SecurityException

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

OperationCanceledException

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

ConnectAsync(IPAddress, Int32, CancellationToken)

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

ValueTask

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

Výjimky

ArgumentNullException

Parametr address nemůže být null.

ArgumentOutOfRangeException

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

InvalidOperationException

Poslouchá Socket .

SocketException

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

ObjectDisposedException

Byl Socket zavřený.

SecurityException

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

OperationCanceledException

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

ConnectAsync(String, Int32)

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

Task

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

Výjimky

ArgumentNullException

Parametr host nemůže být null.

ArgumentOutOfRangeException

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

InvalidOperationException

Poslouchá Socket .

NotSupportedException

Soket není v rodině InterNetwork nebo InterNetworkV6 .

SocketException

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

ObjectDisposedException

Byl Socket zavřený.

SecurityException

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

ConnectAsync(IPAddress[], Int32)

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

Task

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

Výjimky

ArgumentNullException

Parametr addresses nemůže být null.

ArgumentException

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

ArgumentOutOfRangeException

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

InvalidOperationException

Poslouchá Socket .

NotSupportedException

Soket není v rodině InterNetwork nebo InterNetworkV6 .

SocketException

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

ObjectDisposedException

Byl Socket zavřený.

SecurityException

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

ConnectAsync(IPAddress, Int32)

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

Task

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

Výjimky

ArgumentNullException

Parametr address nemůže být null.

ArgumentOutOfRangeException

port je menší než MinPort.

-nebo-

port je větší než MaxPort.

InvalidOperationException

Poslouchá Socket .

NotSupportedException

Soket není v rodině InterNetwork nebo InterNetworkV6 .

SocketException

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

ObjectDisposedException

Byl Socket zavřený.

SecurityException

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

ConnectAsync(EndPoint, CancellationToken)

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

ValueTask

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

Výjimky

ArgumentNullException

Parametr remoteEP nemůže být null.

InvalidOperationException

Poslouchá Socket .

SocketException

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

NotSupportedException

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

ObjectDisposedException

Byl Socket zavřený.

SecurityException

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

OperationCanceledException

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

ConnectAsync(SocketAsyncEventArgs)

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

Boolean

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

ArgumentException

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.

ArgumentNullException

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

InvalidOperationException

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

SocketException

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

NotSupportedException

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

ObjectDisposedException

Byl Socket zavřený.

SecurityException

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 :

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

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é

• SocketAsyncEventArgs
• Buffer
• Completed
• Count
• RemoteEndPoint
• UserToken

ConnectAsync(EndPoint)

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

Task

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

Výjimky

ArgumentNullException

Parametr remoteEP nemůže být null.

InvalidOperationException

Poslouchá Socket .

SocketException

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

NotSupportedException

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

ObjectDisposedException

Byla Socket uzavřena.

SecurityException

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