Socket.SetSocketOption, méthode (SocketOptionLevel, SocketOptionName, Int32)

Les options Socket déterminent le comportement du Socket en cours. Pour une option avec un type de données Boolean, spécifiez une valeur différente de zéro pour activer l'option et la valeur zéro pour désactiver l'option. Pour une option avec un type de données Integer, spécifiez la valeur appropriée. Les options Socket sont groupées par niveau de prise en charge de protocoles.

La liste ci-dessous contient les différentes options Socket pouvant être définies à l'aide de cette surcharge. Ces options sont regroupées selon le SocketOptionLevel approprié. Si vous avez l'intention de définir l'une de ces options, veillez à utiliser le SocketOptionLevel approprié pour le paramètre optionLevel. L'option que vous choisissez de définir doit être spécifiée dans le paramètre optionName. Si vous souhaitez obtenir la valeur actuelle de l'une des options répertoriées, utilisez la méthode GetSocketOption.

Options SocketOptionLevel.Socket pouvant être définies à l'aide de cette surcharge.

• Broadcast

• DontLinger

• Debug

• Error

• KeepAlive

• OutOfBandInline

• ReceiveBuffer

• ReceiveTimeout

• ReuseAddress

• SendBuffer

• SendTimeout

• Type

Options SocketOptionLevel.IP pouvant être définies à l'aide de cette surcharge.

• HeaderIncluded

• IPOptions

• IpTimeToLive

• MulticastInterface

• MulticastLoopback

• MulticastTimeToLive

• TypeOfService

• UseLoopback

Options SocketOptionLevel.Tcp pouvant être définies à l'aide de cette surcharge.

• BsdUrgent

• Expedited

• NoDelay

Options SocketOptionLevel.Udp pouvant être définies à l'aide de cette surcharge.

• ChecksumCoverage

• NoChecksum

Options SocketOptionLevel.IPv6 pouvant être définies à l'aide de cette surcharge.

• HopLimit

Pour plus d'informations sur ces options, consultez l'énumération SocketOptionName.

Remarque
Si vous recevez SocketException, utilisez la propriété SocketException.ErrorCode pour obtenir le code d'erreur spécifique. Une fois que vous avez obtenu ce code, reportez-vous à la documentation sur les codes d'erreur de l'API Windows Sockets version 2 dans MSDN Library pour obtenir une description détaillée de l'erreur.

Remarque
Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d'informations, consultez Traçage réseau.

Remarque sur la plateforme  : Vous devez appeler la méthode Bind avant d'utiliser AddMembership comme paramètre optionName.

L'exemple de code suivant définit les valeurs de délai d'attente de LingerOption et Send.

        // Send operations will time-out if confirmation 
        // is not received within 1000 milliseconds.
        s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 1000);

        // The socket will linger for 10 seconds after Socket.Close is called.
        LingerOption lingerOption = new LingerOption (true, 10);

        s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence