TcpListener.AcceptSocketAsync Methode

Definition

Namespace:

System.Net.Sockets

Assemblys:

netstandard.dll, System.Net.Sockets.dll

Überlädt

Name	Beschreibung
AcceptSocketAsync()	Akzeptiert eine ausstehende Verbindungsanforderung als asynchronen Vorgang.
AcceptSocketAsync(CancellationToken)	Akzeptiert eine ausstehende Verbindungsanforderung als abbruchfähige asynchronen Vorgang.

AcceptSocketAsync()

Quelle:

TCPListener.cs

Akzeptiert eine ausstehende Verbindungsanforderung als asynchronen Vorgang.

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

Task<Socket>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Aufgabenobjekt gibt eine Socket zum Senden und Empfangen von Daten verwendete Eigenschaft zurück.

Ausnahmen

InvalidOperationException

Der Listener wurde nicht mit einem Anruf Start()gestartet.

Hinweise

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

Das Socket zurückgegebene In Task<TResult> wird mit der IP-Adresse und der Portnummer des Remotehosts initialisiert. Sie können jede der Send in Receive der Socket Klasse verfügbaren Methoden verwenden, um mit dem Remotehost zu kommunizieren. Wenn Sie mit der Verwendung des SocketVorgangs fertig sind, müssen Sie dessen Close Methode aufrufen. Wenn Ihre Anwendung relativ einfach ist, sollten Sie die AcceptTcpClient Methode anstelle der AcceptSocketAsync Methode verwenden. TcpClient bietet Ihnen einfache Methoden zum Senden und Empfangen von Daten über ein Netzwerk im synchronen Modus.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AcceptSocket().

Weitere Informationen

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(CancellationToken)

Quelle:

TCPListener.cs

Akzeptiert eine ausstehende Verbindungsanforderung als abbruchfähige 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

ValueTask<Socket>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Aufgabenobjekt gibt eine Socket zum Senden und Empfangen von Daten verwendete Eigenschaft zurück.

Ausnahmen

OperationCanceledException

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 zurückgegebene In Task<TResult> wird mit der IP-Adresse und der Portnummer des Remotehosts initialisiert. Sie können jede der Send in Receive der Socket Klasse verfügbaren Methoden verwenden, um mit dem Remotehost zu kommunizieren. Wenn Sie mit der Verwendung des SocketVorgangs fertig sind, müssen Sie dessen Close Methode aufrufen. Wenn Ihre Anwendung relativ einfach ist, sollten Sie die AcceptTcpClient Methode anstelle der AcceptSocketAsync Methode verwenden. TcpClient bietet Ihnen einfache Methoden zum Senden und Empfangen von Daten über ein Netzwerk im synchronen Modus.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von AcceptSocket().