Socket.BeginDisconnect(Boolean, AsyncCallback, Object) Methode

Definition

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

public:
 IAsyncResult ^ BeginDisconnect(bool reuseSocket, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginDisconnect (bool reuseSocket, AsyncCallback? callback, object? state);
public IAsyncResult BeginDisconnect (bool reuseSocket, AsyncCallback callback, object state);
member this.BeginDisconnect : bool * AsyncCallback * obj -> IAsyncResult
Public Function BeginDisconnect (reuseSocket As Boolean, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

reuseSocket
Boolean

true, wenn dieser Socket wiederverwendet werden kann, nachdem die Verbindung geschlossen wurde, andernfalls false.

callback
AsyncCallback

Der AsyncCallback-Delegat.

state
Object

Ein Objekt mit Zustandsinformationen für diese Anforderung.

Gibt zurück

Ein IAsyncResult-Objekt, das auf den asynchronen Vorgang verweist.

Ausnahmen

Das Socket-Objekt wurde geschlossen.

.NET Framework und .NET 5 und früher: Fehler beim Zugriff auf den Socket.

Hinweise

Wichtig

Dies ist eine Kompatibilitäts-API. Es wird nicht empfohlen, die Methoden APM (Begin* und End*) für die Neuentwicklung zu verwenden. Verwenden Sie stattdessen die Task-basierten Entsprechungen.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, können Sie die -Methode aufrufen, um die BeginDisconnect Trennung von einem Remoteendpunkt zu initiieren. Wenn reuseSocket ist true, können Sie den Socket wiederverwenden.

Sie können einen Rückruf übergeben, der implementiert, BeginDisconnect um über den Abschluss des Trennungsvorgangs AsyncCallback benachrichtigt zu werden. Beachten Sie, dass der Rückruf während des Aufrufs BeginDisconnectvon inline ausgeführt wird, wenn der zugrunde liegende Netzwerkstapel den Vorgang synchron abschließt. In diesem Fall wird die CompletedSynchronously -Eigenschaft für den zurückgegebenen IAsyncResult auf true festgelegt, um anzugeben, dass die Methode synchron abgeschlossen wurde. Verwenden Sie die AsyncState -Eigenschaft von IAsyncResult , um das an die -Methode übergebene Zustandsobjekt BeginDisconnect abzurufen.

Der BeginDisconnect Vorgang muss durch Aufrufen der EndDisconnect -Methode abgeschlossen werden. In der Regel wird die -Methode vom bereitgestellten AsyncCallback Delegaten aufgerufen. EndDisconnect blockiert den aufrufenden Thread, bis der Vorgang abgeschlossen ist.

Hinweis

Wenn Sie eine SocketException Ausnahme erhalten, verwenden Sie die SocketException.ErrorCode -Eigenschaft, um den spezifischen Fehlercode abzurufen.

Hinweis

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

Gilt für: