Partager via


Socket.BeginDisconnect(Boolean, AsyncCallback, Object) Méthode

Définition

Commence une requête asynchrone pour se déconnecter d’un point de terminaison distant.

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

Paramètres

reuseSocket
Boolean

true si ce socket peut être réutilisé une fois la connexion fermée ; sinon, false.

callback
AsyncCallback

Délégué AsyncCallback .

state
Object

Objet qui contient des informations d’état pour cette requête.

Retours

Objet IAsyncResult qui fait référence à l’opération asynchrone.

Exceptions

L’objet Socket a été fermé.

.NET Framework et .NET 5 et versions antérieures uniquement : une erreur s’est produite lors de la tentative d’accès au socket.

Remarques

Important

Il s’agit d’une API de compatibilité. Nous vous déconseillons d’utiliser les méthodes APM (Begin* et End*) pour le nouveau développement. Utilisez plutôt les Taskéquivalents basés sur les valeurs.

Si vous utilisez un protocole orienté connexion, vous pouvez appeler la méthode pour lancer la BeginDisconnect déconnexion à partir d’un point de terminaison distant. Si reuseSocket c’est truele cas, vous pouvez réutiliser le socket.

Vous pouvez passer un rappel qui s’implémente AsyncCallbackBeginDisconnect pour être informé de l’achèvement de l’opération de déconnexion. Notez que si la pile réseau sous-jacente termine l’opération de façon synchrone, le rappel peut être exécuté en ligne, pendant l’appel à BeginDisconnect. Dans ce cas, la CompletedSynchronously propriété sur le retour IAsyncResult sera définie pour true indiquer que la méthode s’est terminée de façon synchrone. Utilisez la AsyncState propriété de l’objet IAsyncResult d’état passé à la BeginDisconnect méthode.

L’opération BeginDisconnect doit être effectuée en appelant la EndDisconnect méthode. En règle générale, la méthode est appelée par le délégué fourni AsyncCallback . EndDisconnect bloque le thread appelant jusqu’à ce que l’opération soit terminée.

Note

Si vous recevez une SocketException exception, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

S’applique à