TcpListener.AcceptSocketAsync Methode

Definition

Überlädt

AcceptSocketAsync()

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

AcceptSocketAsync(CancellationToken)

Akzeptiert eine ausstehende Verbindungsanforderung als abbruchfähigen asynchronen Vorgang.

AcceptSocketAsync()

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

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptSocketAsync();
public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptSocketAsync ();
member this.AcceptSocketAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>
Public Function AcceptSocketAsync () As Task(Of Socket)

Gibt zurück

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

Ausnahmen

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

Hinweise

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

Das Socket in Task<TResult> zurückgegebene wird mit der IP-Adresse und Portnummer des Remotehosts initialisiert. Sie können jede der in der SendSocket -Klasse verfügbaren Methoden und Receive verwenden, um mit dem Remotehost zu kommunizieren. Wenn Sie mit der Verwendung von Socketfertig sind, rufen Sie die - Close Methode auf. Wenn Ihre Anwendung relativ einfach ist, sollten Sie die AcceptTcpClient -Methode anstelle der AcceptSocketAsync -Methode verwenden. TcpClient stellt ihnen einfache Methoden zum Senden und Empfangen von Daten über ein Netzwerk im synchronen Blockierungsmodus bereit.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .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 AcceptSocket().

Weitere Informationen

Gilt für:

AcceptSocketAsync(CancellationToken)

Akzeptiert eine ausstehende Verbindungsanforderung als abbruchfähigen asynchronen Vorgang.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptSocketAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptSocketAsync (System.Threading.CancellationToken cancellationToken);
member this.AcceptSocketAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>
Public Function AcceptSocketAsync (cancellationToken As CancellationToken) As ValueTask(Of Socket)

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 Socket 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 Socketverbindung akzeptiert wurde.

Das Socket in Task<TResult> zurückgegebene wird mit der IP-Adresse und Portnummer des Remotehosts initialisiert. Sie können jede der in der SendSocket -Klasse verfügbaren Methoden und Receive verwenden, um mit dem Remotehost zu kommunizieren. Wenn Sie mit der Verwendung von Socketfertig sind, rufen Sie die - Close Methode auf. Wenn Ihre Anwendung relativ einfach ist, sollten Sie die AcceptTcpClient -Methode anstelle der AcceptSocketAsync -Methode verwenden. TcpClient stellt ihnen einfache Methoden zum Senden und Empfangen von Daten über ein Netzwerk im synchronen Blockierungsmodus bereit.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .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 AcceptSocket().

Gilt für: