SocketOptionName-Enumeration

Definiert Konfigurationsoptionsnamen.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

Syntax

'Declaration
Public Enumeration SocketOptionName
'Usage
Dim instance As SocketOptionName

public enum SocketOptionName

public enum class SocketOptionName

public enum SocketOptionName

public enum SocketOptionName

Member

	Membername	Beschreibung
	AcceptConnection	Der Socket überwacht.
	AddMembership	Fügt eine IP-Gruppenmitgliedschaft hinzu.
	AddSourceMembership	Verknüpft eine Quellgruppe.
	BlockSource	Blockiert Daten aus einer Quelle.
	Broadcast	Lässt das Senden von Broadcastmeldungen für den Socket zu.
	BsdUrgent	Verwendet gemäß RFC-1222 als dringlich (urgent) definierte Daten. Diese Option kann nur einmal festgelegt und anschließend nicht mehr deaktiviert werden.
	ChecksumCoverage	Legt die UDP-Prüfsummenabdeckung fest oder ruft diese ab.
	Debug	Zeichnet Debuginformationen auf.
	DontFragment	Keine Fragmentierung von IP-Datengrammen.
	DontLinger	Ordnungsgemäßes, unverzügliches Schließen des Sockets.
	DontRoute	Keine Weiterleitung. Das Paket wird direkt an die Schnittstellenadressen gesendet.
	DropMembership	Legt eine IP-Gruppenmitgliedschaft ab.
	DropSourceMembership	Legt eine Quellgruppe ab.
	Error	Abrufen und Löschen des Fehlerstatus.
	ExclusiveAddressUse	Ermöglicht das Binden eines Sockets für den exklusiven Zugriff.
	Expedited	Verwendet gemäß RFC-1222 als beschleunigt (expedited) definierte Daten. Diese Option kann nur einmal festgelegt und anschließend nicht mehr deaktiviert werden.
	HeaderIncluded	Gibt an, dass die Anwendung den IP-Header für ausgehende Datagramme bereitstellt.
	HopLimit	Gibt die maximale Anzahl von Routerweiterleitungen für ein IPv6 (Internet Protocol, Version 6)-Paket an. Dies entspricht der Gültigkeitsdauer (TTL) für Internet Protocol, Version 4.
	IPOptions	Gibt die IP-Optionen an, die in ausgehende Datagramme eingefügt werden sollen.
	IpTimeToLive	Legt das Time-To-Live-Feld für die Gültigkeitsdauer im IP-Header fest.
	KeepAlive	Verwendet Keep-Alives.
	Linger	Das Schließen wird verzögert, wenn nicht gesendete Daten vorhanden sind.
	MaxConnections	Wird nicht unterstützt. Löst bei Verwendung eine SocketException aus.
	MulticastInterface	Legt die Schnittstelle für ausgehende Multicastpakete fest.
	MulticastLoopback	Ein IP-Multicast-Loopback.
	MulticastTimeToLive	Eine IP-Multicast-Gültigkeitsdauer.
	NoChecksum	Sendet UDP-Datagramme mit auf 0 festgelegter Prüfsumme.
	NoDelay	Deaktiviert den Nagle-Algorithmus für Sammelsendungen.
	OutOfBandInline	Empfängt Out-Of-Band-Daten im normalen Datenstream.
	PacketInformation	Gibt Informationen über empfangene Pakete zurück.
	ReceiveBuffer	Gibt den Gesamtpufferspeicher pro Socket an, der für Empfangsvorgänge reserviert ist. Dies hängt nicht von der maximalen Meldungsgröße oder der Größe eines TCP-Fensters ab.
	ReceiveLowWater	Gibt die untere Grenze für Receive-Vorgänge an.
	ReceiveTimeout	Empfängt ein Timeout. Diese Option gilt nur für synchrone Methoden, sie wirkt sich nicht auf asynchrone Methoden wie die BeginSend-Methode aus.
	ReuseAddress	Ermöglicht, dass der Socket an eine bereits verwendete Adresse gebunden wird.
	SendBuffer	Gibt den Gesamtpufferspeicher pro Socket an, der für Sendevorgänge reserviert ist. Dies hängt nicht von der maximalen Meldungsgröße oder der Größe eines TCP-Fensters ab.
	SendLowWater	Gibt die untere Grenze für Send-Vorgänge an.
	SendTimeout	Sendet ein Timeout. Diese Option gilt nur für synchrone Methoden, sie wirkt sich nicht auf asynchrone Methoden wie die BeginSend-Methode aus.
	Type	Ruft den Sockettyp ab.
	TypeOfService	Ändert den Dienstfeldtyp des IP-Headers.
	UnblockSource	Hebt die Sperre einer zuvor blockierten Quelle auf.
	UpdateAcceptContext	Aktualisiert die Eigenschaften eines angenommenen Sockets mit den Eigenschaften eines vorhandenen Sockets. Dies entspricht der Verwendung der SO_UPDATE_ACCEPT_CONTEXT-Socketoption von Winsock 2 und wird nur für verbindungsorientierte Sockets unterstützt.
	UpdateConnectContext	Aktualisiert die Eigenschaften eines verbundenen Sockets mit den Eigenschaften eines vorhandenen Sockets. Dies entspricht der Verwendung der SO_UPDATE_CONNECT_CONTEXT-Socketoption von Winsock 2 und wird nur für verbindungsorientierte Sockets unterstützt.
	UseLoopback	Umgeht die Hardware nach Möglichkeit.

Hinweise

Die SocketOptionName-Enumeration definiert den Namen jeder Socket-Konfigurationsoption. Sockets können mit der Socket.SetSocketOption-Methode konfiguriert werden.

Hinweis zu Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows CE: In .NET Compact Framework-Anwendungen werden die folgenden Optionen unterstützt, können jedoch gegenwärtig nicht verwendet werden, sondern sind für eine zukünftige Verwendung reserviert: AcceptConnection, ReceiveLowWater, ReceiveTimeout, SendLowWater, SendTimeout und Type. Weitere Informationen über diese Optionen finden Sie unter Socketprogrammierung.

Beispiel

Im folgenden Codebeispiel wird diese Enumeration zum Festlegen von Socketoptionen verwendet.

'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.
Dim lingerOption As New LingerOption(True, 10)
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption)

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

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

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

System.Net.Sockets-Namespace
SocketOptionLevel-Enumeration
SocketOptionName-Enumeration