TcpListener.AcceptTcpClientAsync Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Přetížení

AcceptTcpClientAsync()	Přijme čekající žádost o připojení jako asynchronní operaci.
AcceptTcpClientAsync(CancellationToken)	Přijme čekající požadavek na připojení jako zrušitelnou asynchronní operaci.

AcceptTcpClientAsync()

Zdroj:

TCPListener.cs

Přijme č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í objekt použitý TcpClient k odesílání a příjmu dat.

Výjimky

InvalidOperationException

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

SocketException

ErrorCode Pomocí vlastnosti získejte konkrétní kód chyby. Jakmile tento kód získáte, můžete se podívat do dokumentace ke kódu chyb rozhraní API rozhraní Windows Sockets verze 2 , kde najdete 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í podkladového objektu 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. Po dokončení s TcpClient, nezapomeňte zavolat jeho Close metodu. Pokud chcete větší flexibilitu TcpClient než nabídky, 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 naleznete v tématu Trasování sítě v rozhraní .NET Framework.

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

Viz také

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Zdroj:

TCPListener.cs

Přijme čekající požadavek na 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í objekt použitý TcpClient k odesílání a příjmu dat.

Výjimky

OperationCanceledException

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

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í podkladového objektu 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. Po dokončení s TcpClient, nezapomeňte zavolat jeho Close metodu. Pokud chcete větší flexibilitu TcpClient než nabídky, 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 naleznete v tématu Trasování sítě v rozhraní .NET Framework.

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