Freigeben über


Socket.DisconnectAsync Methode

Definition

Überlädt

DisconnectAsync(SocketAsyncEventArgs)

Beginnt eine asynchrone Anforderung zum Trennen der Verbindung mit einem Remoteendunkt.

DisconnectAsync(Boolean, CancellationToken)

Trennt einen verbundenen Socket vom Remotehost.

DisconnectAsync(SocketAsyncEventArgs)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Beginnt eine asynchrone Anforderung zum Trennen der Verbindung mit einem Remoteendunkt.

public:
 bool DisconnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);
public bool DisconnectAsync (System.Net.Sockets.SocketAsyncEventArgs e);
member this.DisconnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool
Public Function DisconnectAsync (e As SocketAsyncEventArgs) As Boolean

Parameter

e
SocketAsyncEventArgs

Das SocketAsyncEventArgs-Objekt, das für diesen asynchronen Socketvorgang verwendet werden soll.

Gibt zurück

true, wenn der E/A-Vorgang aussteht. Das Completed-Ereignis für den e-Parameter wird nach dem Abschluss des Vorgangs ausgelöst.

false, wenn der E/A-Vorgang synchron abgeschlossen wurde. In diesem Fall wird das Completed-Ereignis für den e-Parameter nicht ausgelöst, und das als Parameter übergebene e-Objekt kann direkt nach der Rückgabe des Methodenaufrufs untersucht werden, um die Ergebnisse des Vorgangs abzurufen.

Ausnahmen

Der e-Parameter darf nicht NULL sein.

Es wird bereits ein Socketvorgang mit dem im e-Parameter angegebenen SocketAsyncEventArgs-Objekt ausgeführt.

Der Socket wurde geschlossen.

Fehler beim Versuch, auf den Socket zuzugreifen.

Hinweise

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, fordert das Aufrufen der DisconnectAsync Methode eine Verbindung von einem Remoteendpunkt an. Wenn Sie im e Parameter auf true festlegenSocketAsyncEventArgs.DisconnectReuseSocket, kann der Socket wiederverwendet werden.

Weitere Informationen

Gilt für:

DisconnectAsync(Boolean, CancellationToken)

Quelle:
Socket.Tasks.cs
Quelle:
Socket.Tasks.cs
Quelle:
Socket.Tasks.cs

Trennt einen verbundenen Socket vom Remotehost.

public System.Threading.Tasks.ValueTask DisconnectAsync (bool reuseSocket, System.Threading.CancellationToken cancellationToken = default);
member this.DisconnectAsync : bool * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function DisconnectAsync (reuseSocket As Boolean, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parameter

reuseSocket
Boolean

Gibt an, ob der Socket nach dem Trennen wiederverwendet werden soll.

cancellationToken
CancellationToken

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

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Socketverbindung getrennt wird.

Ausnahmen

Das Socket-Objekt wurde geschlossen.

Fehler beim Versuch, auf den Socket zuzugreifen.

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

Hinweise

Diese Methode speichert in der Aufgabe, die sie 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Disconnect(Boolean)Ausnahmen.

Gilt für: