Socket.SetSocketOption Méthode

Référence

Définition

Espace de noms:: System.Net.Sockets

Assemblys:: netstandard.dll, System.Net.Sockets.dll

Assembly:: System.Net.Sockets.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

Définit une option Socket.

Surcharges

SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean)	Affecte la valeur Socket spécifiée à l'option Boolean spécifiée.
SetSocketOption(SocketOptionLevel, SocketOptionName, Byte[])	Affecte la valeur spécifiée à l'option Socket spécifiée représentée sous la forme d'un tableau d'octets.
SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)	Affecte la valeur entière spécifiée à l'option Socket spécifiée.
SetSocketOption(SocketOptionLevel, SocketOptionName, Object)	Affecte la valeur spécifiée à l'option Socket spécifiée représentée sous la forme d'un objet.

SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean)

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Affecte la valeur Socket spécifiée à l'option Boolean spécifiée.

public:
 void SetSocketOption(System::Net::Sockets::SocketOptionLevel optionLevel, System::Net::Sockets::SocketOptionName optionName, bool optionValue);

public void SetSocketOption(System.Net.Sockets.SocketOptionLevel optionLevel, System.Net.Sockets.SocketOptionName optionName, bool optionValue);

member this.SetSocketOption : System.Net.Sockets.SocketOptionLevel * System.Net.Sockets.SocketOptionName * bool -> unit

Public Sub SetSocketOption (optionLevel As SocketOptionLevel, optionName As SocketOptionName, optionValue As Boolean)

Paramètres

optionLevel: SocketOptionLevel

Une des valeurs de l'objet SocketOptionLevel.

optionName: SocketOptionName

Une des valeurs de l'objet SocketOptionName.

optionValue: Boolean

Valeur de l'option, représentée en tant que Boolean.

Exceptions

ObjectDisposedException

L’objet Socket a été fermé.

SocketException

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

Exemples

L’exemple de code suivant ouvre un socket et active les DontLinger options de OutOfBandInline socket et.

// Establish the local endpoint for the socket.
IPHostEntry^ ipHost = Dns::GetHostEntry( Dns::GetHostName() );
IPAddress^ ipAddr = ipHost->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddr,11000 );

// Create a TCP socket.
Socket^ client = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );

// Connect the socket to the remote endpoint.
client->Connect( ipEndPoint );

// Set option that allows socket to close gracefully without lingering.
client->SetSocketOption( SocketOptionLevel::Socket, SocketOptionName::DontLinger, true );

// Set option that allows socket to receive out-of-band information in the data stream.
client->SetSocketOption( SocketOptionLevel::Socket, SocketOptionName::OutOfBandInline, true );

// Establish the local endpoint for the socket.
IPHostEntry ipHost = Dns.GetHostEntry(Dns.GetHostName());
IPAddress  ipAddr = ipHost.AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddr, 11000);

// Create a TCP socket.
Socket client = new Socket(AddressFamily.InterNetwork,
    SocketType.Stream, ProtocolType.Tcp);

// Connect the socket to the remote endpoint.
client.Connect(ipEndPoint);

// Set option that allows socket to close gracefully without lingering.
client.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.DontLinger, true);

// Set option that allows socket to receive out-of-band information in the data stream.
client.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.OutOfBandInline, true);

Remarques

Socket les options déterminent le comportement du actuel Socket. Définissez optionValue sur true pour activer l’option ou pour false désactiver l’option.

Socket les options sont regroupées par niveau de prise en charge du protocole.

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

SocketOptionLevel.Socket options qui peuvent être définies à l’aide de cette surcharge.

SocketOptionLevel.IP options qui peuvent être définies à l’aide de cette surcharge.

SocketOptionLevel.Tcp options qui peuvent être définies à l’aide de cette surcharge.

SocketOptionLevel.Udp options qui peuvent être définies à l’aide de cette surcharge.

NoChecksum

Pour plus d’informations sur ces options, reportez-vous à l’énumération SocketOptionName .

Notes

Si vous recevez une SocketException exception, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, 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.

S’applique à

.NET 10 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1

SetSocketOption(SocketOptionLevel, SocketOptionName, Byte[])

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Affecte la valeur spécifiée à l'option Socket spécifiée représentée sous la forme d'un tableau d'octets.

public:
 void SetSocketOption(System::Net::Sockets::SocketOptionLevel optionLevel, System::Net::Sockets::SocketOptionName optionName, cli::array <System::Byte> ^ optionValue);

public void SetSocketOption(System.Net.Sockets.SocketOptionLevel optionLevel, System.Net.Sockets.SocketOptionName optionName, byte[] optionValue);

member this.SetSocketOption : System.Net.Sockets.SocketOptionLevel * System.Net.Sockets.SocketOptionName * byte[] -> unit

Public Sub SetSocketOption (optionLevel As SocketOptionLevel, optionName As SocketOptionName, optionValue As Byte())

Paramètres

optionLevel: SocketOptionLevel

Une des valeurs de l'objet SocketOptionLevel.

optionName: SocketOptionName

Une des valeurs de l'objet SocketOptionName.

optionValue: Byte[]

Tableau de type Byte représentant la valeur de l'option.

Exceptions

SocketException

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

ObjectDisposedException

Socket a été fermé.

Exemples

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

// Specifies that the Socket will linger for 10 seconds after Close is called.
LingerOption^ lingerOption = gcnew LingerOption(true, 10);
s->SetSocketOption(SocketOptionLevel::Socket, SocketOptionName::Linger, lingerOption);

// The socket will linger for 10 seconds after Socket.Close is called.
var lingerOption = new LingerOption(true, 10);
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);

' The socket will linger for 10 seconds after Socket.Close is called.
Dim lingerOption As New LingerOption(True, 10)
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption)

Remarques

Socket les options déterminent le comportement du actuel Socket. Utilisez cette surcharge pour définir les Socket options qui nécessitent un tableau d’octets comme valeur d’option.

Notes

Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, 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.

Notes

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 Suivi réseau dans .NET Framework.

Voir aussi

S’applique à

.NET 10 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1

SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Affecte la valeur entière spécifiée à l'option Socket spécifiée.

public:
 void SetSocketOption(System::Net::Sockets::SocketOptionLevel optionLevel, System::Net::Sockets::SocketOptionName optionName, int optionValue);

public void SetSocketOption(System.Net.Sockets.SocketOptionLevel optionLevel, System.Net.Sockets.SocketOptionName optionName, int optionValue);

member this.SetSocketOption : System.Net.Sockets.SocketOptionLevel * System.Net.Sockets.SocketOptionName * int -> unit

Public Sub SetSocketOption (optionLevel As SocketOptionLevel, optionName As SocketOptionName, optionValue As Integer)

Paramètres

optionLevel: SocketOptionLevel

Une des valeurs de l'objet SocketOptionLevel.

optionName: SocketOptionName

Une des valeurs de l'objet SocketOptionName.

optionValue: Int32

Valeur de l'option.

Exceptions

SocketException

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

ObjectDisposedException

Socket a été fermé.

Exemples

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

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

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

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

Remarques

Socket les options déterminent le comportement du actuel Socket. Pour une option avec un Boolean type de données, spécifiez une valeur différente de zéro pour activer l’option et une valeur zéro pour désactiver l’option. Pour une option avec un type de données entier, spécifiez la valeur appropriée. Socket les options sont regroupées par niveau de prise en charge du protocole.

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

SocketOptionLevel.Socket options qui peuvent être définies à l’aide de cette surcharge.

SocketOptionLevel.IP options qui peuvent être définies à l’aide de cette surcharge.

SocketOptionLevel.Tcp options qui peuvent être définies à l’aide de cette surcharge.

SocketOptionLevel.Udp options qui peuvent être définies à l’aide de cette surcharge.

SocketOptionLevel.IPv6 options qui peuvent être définies à l’aide de cette surcharge.

HopLimit

Pour plus d’informations sur ces options, reportez-vous à l’énumération SocketOptionName .

Notes

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 Suivi réseau dans .NET Framework.

Voir aussi

S’applique à

.NET 10 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1

SetSocketOption(SocketOptionLevel, SocketOptionName, Object)

Source:: Socket.cs

Source:: Socket.cs

Source:: Socket.cs

Affecte la valeur spécifiée à l'option Socket spécifiée représentée sous la forme d'un objet.

public:
 void SetSocketOption(System::Net::Sockets::SocketOptionLevel optionLevel, System::Net::Sockets::SocketOptionName optionName, System::Object ^ optionValue);

public void SetSocketOption(System.Net.Sockets.SocketOptionLevel optionLevel, System.Net.Sockets.SocketOptionName optionName, object optionValue);

member this.SetSocketOption : System.Net.Sockets.SocketOptionLevel * System.Net.Sockets.SocketOptionName * obj -> unit

Public Sub SetSocketOption (optionLevel As SocketOptionLevel, optionName As SocketOptionName, optionValue As Object)

Paramètres

optionLevel: SocketOptionLevel

Une des valeurs de l'objet SocketOptionLevel.

optionName: SocketOptionName

Une des valeurs de l'objet SocketOptionName.

optionValue: Object

LingerOption ou MulticastOption qui contient la valeur de l'option.

Exceptions

ArgumentNullException

optionValue a la valeur null.

SocketException

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

ObjectDisposedException

Socket a été fermé.

Exemples

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

// Specifies that the Socket will linger for 10 seconds after Close is called.
LingerOption^ lingerOption = gcnew LingerOption(true, 10);
s->SetSocketOption(SocketOptionLevel::Socket, SocketOptionName::Linger, lingerOption);

// The socket will linger for 10 seconds after Socket.Close is called.
var lingerOption = new LingerOption(true, 10);
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);

' The socket will linger for 10 seconds after Socket.Close is called.
Dim lingerOption As New LingerOption(True, 10)
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption)

Remarques

Socket les options déterminent le comportement du actuel Socket. Utilisez cette surcharge pour définir les Lingeroptions , AddMembershipet DropMembership Socket . Pour l’option Linger , utilisez Socket pour le optionLevel paramètre . Pour AddMembership et DropMembership, utilisez IP. Si vous souhaitez obtenir la valeur actuelle de l’une des options répertoriées ci-dessus, utilisez la GetSocketOption méthode .

Notes

Voir aussi

S’applique à

.NET 10 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1

Partager via

Socket.SetSocketOption Méthode

Définition

Surcharges

SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

SetSocketOption(SocketOptionLevel, SocketOptionName, Byte[])

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

SetSocketOption(SocketOptionLevel, SocketOptionName, Object)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires