Socket.Shutdown(SocketShutdown) Méthode

Définition

Espace de noms:

System.Net.Sockets

Assemblys:

netstandard.dll, System.Net.Sockets.dll

Source:

Socket.cs

Désactive les envois et les réceptions sur un Socket.

public:
 void Shutdown(System::Net::Sockets::SocketShutdown how);

public void Shutdown(System.Net.Sockets.SocketShutdown how);

member this.Shutdown : System.Net.Sockets.SocketShutdown -> unit

Public Sub Shutdown (how As SocketShutdown)

Paramètres

how

SocketShutdown

Une des SocketShutdown valeurs qui spécifie l’opération qui ne sera plus autorisée.

Exceptions

SocketException

Une erreur s’est produite lors de la tentative d’accès au socket.

ObjectDisposedException

Il Socket a été fermé.

Exemples

L’exemple de code suivant utilise Shutdown pour désactiver le Socket.

try
{
    aSocket.Shutdown(SocketShutdown.Both);
}
finally
{
    aSocket.Close();
}

    Try
        aSocket.Shutdown(SocketShutdown.Both)
    Finally
        aSocket.Close()
    End Try

End Sub

Remarques

Lorsque vous utilisez une connexion orientée Socket, appelez toujours la Shutdown méthode avant de fermer le Socket. Cela garantit que toutes les données sont envoyées et reçues sur le socket connecté avant sa fermeture.

Appelez la Close méthode pour libérer toutes les ressources managées et non managées associées au Socket. N’essayez pas de réutiliser le Socket serveur après la fermeture.

Le tableau suivant montre les SocketShutdown valeurs d’énumération valides pour le how paramètre.

Valeur	Description
Envoi	Désactivez l’envoi sur ce Socketfichier .
Recevoir	Désactivez la réception sur ce Socket.
Les deux	Désactivez à la fois l’envoi et la réception sur ce Socket.

Paramètre how pour Send spécifier que les appels suivants à ne Send sont pas autorisés. Si vous utilisez un sans connexion Socket, la spécification Send n’aura aucun effet.

Paramètre how pour Receive spécifier que les appels suivants à ne Receive sont pas autorisés. Cela n’a aucun effet sur les couches de protocole inférieures. Si vous utilisez un protocole orienté connexion, la connexion est arrêtée si l’une des conditions suivantes existe après un appel à Shutdown :

• Les données se trouvent dans la mémoire tampon réseau entrante en attente de réception.

• D’autres données sont arrivées.

Si vous utilisez un protocole sans connexion, les datagrammes sont acceptés et mis en file d’attente. Toutefois, si aucun espace tampon n’est disponible pour d’autres datagrammes entrants, ils sont ignorés et aucune erreur n’est retournée à l’expéditeur. L’utilisation Shutdown sur un sans Socket connexion n’est pas recommandée.

Paramètre how permettant de désactiver les Both envois et les réceptions comme décrit ci-dessus.

Note

Si vous recevez un SocketException message lors de l’appel de la Shutdown méthode, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

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.

Voir aussi

• Close()
• SocketShutdown