Freigeben über


TcpListener.AcceptTcpClientAsync Methode

Definition

Überlädt

AcceptTcpClientAsync()

Nimmt eine ausstehende Aufforderung zum Aufbau einer Verbindung als asynchroner Vorgang an.

AcceptTcpClientAsync(CancellationToken)

Akzeptiert eine ausstehende Verbindungsanforderung als abbruchfähigen asynchronen Vorgang.

AcceptTcpClientAsync()

Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs

Nimmt eine ausstehende Aufforderung zum Aufbau einer Verbindung als asynchroner Vorgang an.

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)

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt TcpClient zurück, das verwendet wird, um Daten zu senden und zu empfangen.

Ausnahmen

Der Listener wurde nicht mit einem Aufruf von Start() gestartet.

Mit der ErrorCode-Eigenschaft können Sie den spezifischen Fehlercode abrufen. Wenn Sie diesen Code abgerufen haben, finden Sie in der Dokumentation zu API-Fehlercodes unter Windows Sockets, Version 2, eine ausführliche Beschreibung des Fehlers.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die TCP-Verbindung akzeptiert wurde.

Verwenden Sie die TcpClient.GetStream -Methode, um die zugrunde liegende NetworkStream der in der Task<TResult>-Methode abzurufenTcpClient. Bietet NetworkStream Ihnen Methoden zum Senden und Empfangen mit dem Remotehost. Wenn Sie mit durch TcpClientsind, müssen Sie die - Close Methode aufrufen. Wenn Sie eine größere Flexibilität als ein TcpClient Angebot wünschen, sollten Sie oder AcceptSocketAsyncverwendenAcceptSocket.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden AcceptTcpClient().

Weitere Informationen

Gilt für:

AcceptTcpClientAsync(CancellationToken)

Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs

Akzeptiert eine ausstehende Verbindungsanforderung als abbruchfähigen asynchronen Vorgang.

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)

Parameter

cancellationToken
CancellationToken

Ein Abbruchtoken, das zum Abbrechen des asynchronen Vorgangs verwendet werden kann

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt TcpClient zurück, das verwendet wird, um Daten zu senden und zu empfangen.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die TCP-Verbindung akzeptiert wurde.

Verwenden Sie die TcpClient.GetStream -Methode, um die zugrunde liegende NetworkStream der in der Task<TResult>-Methode abzurufenTcpClient. Bietet NetworkStream Ihnen Methoden zum Senden und Empfangen mit dem Remotehost. Wenn Sie mit durch TcpClientsind, müssen Sie die - Close Methode aufrufen. Wenn Sie eine größere Flexibilität als ein TcpClient Angebot wünschen, sollten Sie oder AcceptSocketAsyncverwendenAcceptSocket.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden AcceptTcpClient().

Gilt für: