Socket.BeginDisconnect(Boolean, AsyncCallback, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.