Socket.SetSocketOption Methode

Definitie

Naamruimte:: System.Net.Sockets

Assembly:: System.dll

Assembly:: System.Net.Sockets.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee stelt u een Socket optie in.

Overloads

Name	Description
SetSocketOption(SocketOptionLevel, SocketOptionName, Object)	Hiermee stelt u de opgegeven Socket optie in op de opgegeven waarde, weergegeven als een object.
SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)	Hiermee stelt u de opgegeven Socket optie in op de opgegeven gehele waarde.
SetSocketOption(SocketOptionLevel, SocketOptionName, Byte[])	Hiermee stelt u de opgegeven optie in op de opgegeven Socket waarde, die wordt weergegeven als een bytematrix.
SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean)	Hiermee stelt u de opgegeven Socket optie in op de opgegeven Boolean waarde.

SetSocketOption(SocketOptionLevel, SocketOptionName, Object)

Hiermee stelt u de opgegeven Socket optie in op de opgegeven waarde, weergegeven als een object.

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)

Parameters

optionLevel: SocketOptionLevel

Een van de SocketOptionLevel waarden.

optionName: SocketOptionName

Een van de SocketOptionName waarden.

optionValue: Object

Een LingerOption of MulticastOption die de waarde van de optie bevat.

Uitzonderingen

ArgumentNullException

optionValue is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

Voorbeelden

In het volgende codevoorbeeld worden de LingerOption waarden voor en Send time-outs ingesteld.

// 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)

Opmerkingen

Socket opties bepalen het gedrag van de huidige Socket. Gebruik deze overbelasting om de Lingeropties en AddMembership DropMembership Socket opties in te stellen. Gebruik voor de parameter voor de LingeroptionLevel optieSocket. Voor AddMembership en DropMembership, gebruik IP. Als u de huidige waarde van een van de bovenstaande opties wilt ophalen, gebruikt u de GetSocketOption methode.

Note

Als u een SocketExceptionontvangt, gebruikt u de SocketException.ErrorCode eigenschap om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, raadpleegt u de Windows Sockets versie 2 API-foutcode documentatie voor een gedetailleerde beschrijving van de fout.

Zie ook

Van toepassing op

SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)

Hiermee stelt u de opgegeven Socket optie in op de opgegeven gehele waarde.

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)

Parameters

optionLevel: SocketOptionLevel

Een van de SocketOptionLevel waarden.

optionName: SocketOptionName

Een van de SocketOptionName waarden.

optionValue: Int32

Een waarde van de optie.

Uitzonderingen

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

Voorbeelden

In het volgende codevoorbeeld worden de LingerOption en Send time-outwaarden ingesteld.

// 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)

Opmerkingen

Socket opties bepalen het gedrag van de huidige Socket. Geef voor een optie met een Boolean gegevenstype een niet-nulwaarde op om de optie in te schakelen en een nulwaarde om de optie uit te schakelen. Geef de juiste waarde op voor een optie met een gegevenstype geheel getal. Socket opties worden gegroepeerd op protocolondersteuningsniveau.

Hieronder vindt u de verschillende Socket opties die kunnen worden ingesteld met behulp van deze overbelasting. Deze opties worden gegroepeerd op de juiste SocketOptionLevel. Als u van plan bent een van deze opties in te stellen, moet u de juiste SocketOptionLevel voor de optionLevel parameter gebruiken. De optie die u wilt instellen, moet worden opgegeven in de optionName parameter. Als u de huidige waarde van een van de vermelde opties wilt ophalen, gebruikt u de GetSocketOption methode.

SocketOptionLevel.Socket opties die kunnen worden ingesteld met deze overbelasting.

SocketOptionLevel.IP opties die kunnen worden ingesteld met deze overbelasting.

SocketOptionLevel.Tcp opties die kunnen worden ingesteld met deze overbelasting.

SocketOptionLevel.Udp opties die kunnen worden ingesteld met deze overbelasting.

SocketOptionLevel.IPv6 opties die kunnen worden ingesteld met deze overbelasting.

HopLimit

Raadpleeg de SocketOptionName opsomming voor meer informatie over deze opties.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Zie ook

Van toepassing op

SetSocketOption(SocketOptionLevel, SocketOptionName, Byte[])

Hiermee stelt u de opgegeven optie in op de opgegeven Socket waarde, die wordt weergegeven als een bytematrix.

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())

Parameters

optionLevel: SocketOptionLevel

Een van de SocketOptionLevel waarden.

optionName: SocketOptionName

Een van de SocketOptionName waarden.

optionValue: Byte[]

Een matrix van het type Byte dat de waarde van de optie vertegenwoordigt.

Uitzonderingen

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

Voorbeelden

In het volgende codevoorbeeld worden de LingerOption en Send time-outwaarden ingesteld.

// 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)

Opmerkingen

Socket opties bepalen het gedrag van de huidige Socket. Gebruik deze overbelasting om deze Socket opties in te stellen waarvoor een bytematrix als optiewaarde is vereist.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Zie ook

Van toepassing op

SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean)

Hiermee stelt u de opgegeven Socket optie in op de opgegeven Boolean waarde.

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)

Parameters

optionLevel: SocketOptionLevel

Een van de SocketOptionLevel waarden.

optionName: SocketOptionName

Een van de SocketOptionName waarden.

optionValue: Boolean

De waarde van de optie, weergegeven als een Boolean.

Uitzonderingen

ObjectDisposedException

Het Socket object is gesloten.

SocketException

Er is een fout opgetreden bij het openen van de socket.

Voorbeelden

In het volgende codevoorbeeld wordt een socket geopend en worden OutOfBandInline de DontLinger socketopties ingeschakeld.

// 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);

Opmerkingen

Socket opties bepalen het gedrag van de huidige Socket. Stel optionValue deze optie in om true de optie in te schakelen of om false de optie uit te schakelen.

Socket opties worden gegroepeerd op protocolondersteuningsniveau.

Hieronder vindt u de verschillende Socket opties die kunnen worden ingesteld met behulp van deze overbelasting. Deze opties worden gegroepeerd op de juiste SocketOptionLevel waarde. Als u van plan bent een van deze opties in te stellen, moet u de juiste SocketOptionLevel waarde voor de optionLevel parameter gebruiken. De optie die u wilt instellen, moet worden opgegeven in de optionName parameter. Als u de huidige waarde van een van de vermelde opties wilt ophalen, gebruikt u de GetSocketOption methode.

SocketOptionLevel.Socket opties die kunnen worden ingesteld met deze overbelasting.

SocketOptionLevel.IP opties die kunnen worden ingesteld met deze overbelasting.

SocketOptionLevel.Tcp opties die kunnen worden ingesteld met deze overbelasting.

SocketOptionLevel.Udp opties die kunnen worden ingesteld met deze overbelasting.

NoChecksum

Raadpleeg de SocketOptionName opsomming voor meer informatie over deze opties.

Note

Als u een SocketException uitzondering ontvangt, gebruikt u de SocketException.ErrorCode eigenschap om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, raadpleegt u de Windows Sockets versie 2 API-foutcode documentatie voor een gedetailleerde beschrijving van de fout.

Van toepassing op

Feedback

Is deze pagina nuttig?