TcpListener.AcceptTcpClientAsync Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Přetížení

AcceptTcpClientAsync()	Přijímá čekající žádost o připojení jako asynchronní operaci.
AcceptTcpClientAsync(CancellationToken)	Přijímá čekající žádost o připojení jako zrušitelnou asynchronní operaci.

AcceptTcpClientAsync()

Zdroj:

TCPListener.cs

Přijímá čekající žádost o připojení jako asynchronní operaci.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::TcpClient ^> ^ AcceptTcpClientAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.TcpClient> AcceptTcpClientAsync ();

member this.AcceptTcpClientAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync () As Task(Of TcpClient)

Návraty

Task<TcpClient>

Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí TcpClient objekt použitý k odesílání a přijímání dat.

Výjimky

InvalidOperationException

Naslouchací proces nebyl zahájen s voláním Start().

SocketException

ErrorCode Pomocí vlastnosti získejte konkrétní kód chyby. Po získání tohoto kódu můžete v dokumentaci ke kódu chyby rozhraní API pro Windows Sockets verze 2 získat podrobný popis chyby.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přijetí připojení TCP.

Použijte metodu TcpClient.GetStream k získání podkladu NetworkStream vráceného TcpClient v objektu Task<TResult>. Poskytne NetworkStream vám metody pro odesílání a příjem se vzdáleným hostitelem. Až budete s TcpClientnástrojem , nezapomeňte zavolat jeho Close metodu. Pokud chcete větší flexibilitu než nabídky TcpClient , zvažte použití AcceptSocket nebo AcceptSocketAsync.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

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

Viz také

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Zdroj:

TCPListener.cs

Přijímá čekající žádost o připojení jako zrušitelnou asynchronní operaci.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::TcpClient ^> AcceptTcpClientAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient> AcceptTcpClientAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptTcpClientAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync (cancellationToken As CancellationToken) As ValueTask(Of TcpClient)

Parametry

cancellationToken

CancellationToken

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

Návraty

ValueTask<TcpClient>

Objekt úlohy představující asynchronní operaci. Vlastnost Result objektu úkolu vrátí TcpClient objekt použitý k odesílání a přijímání dat.

Výjimky

OperationCanceledException

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

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přijetí připojení TCP.

Použijte metodu TcpClient.GetStream k získání podkladu NetworkStream vráceného TcpClient v objektu Task<TResult>. Poskytne NetworkStream vám metody pro odesílání a příjem se vzdáleným hostitelem. Až budete s TcpClientnástrojem , nezapomeňte zavolat jeho Close metodu. Pokud chcete větší flexibilitu než nabídky TcpClient , zvažte použití AcceptSocket nebo AcceptSocketAsync.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

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