SocketOptionName Enumeration

Referenz

Definition

Namespace:: System.Net.Sockets

Assembly:: System.Net.Sockets.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Definiert die Konfigurationsoptionsnamen.

public enum class SocketOptionName

public enum SocketOptionName

type SocketOptionName =

Public Enum SocketOptionName

Vererbung: Object

ValueType

Enum
SocketOptionName

Felder

AcceptConnection	2	Der Socket überwacht.
AddMembership	12	Fügt eine IP-Gruppenmitgliedschaft hinzu.
AddSourceMembership	15	Verknüpft eine Quellgruppe.
BlockSource	17	Blockiert Daten aus einer Quelle.
Broadcast	32	Lässt das Senden von Broadcastmeldungen für den Socket zu.
BsdUrgent	2	Verwendet dringende Daten wie in RFC-1222 definiert. Diese Option kann nur einmal festgelegt werden. Nachdem sie festgelegt wurde, kann sie nicht deaktiviert werden.
ChecksumCoverage	20	Legt die UDP-Prüfsummenabdeckung fest oder ruft diese ab.
Debug	1	Zeichnet Debuginformationen auf.
DontFragment	14	IP-Datagramme werden nicht fragmentiert.
DontLinger	-129	Schließt den Socket ordnungsgemäß und unverzüglich.
DontRoute	16	Keine Weiterleitung. Das Paket wird direkt an die Schnittstellenadressen gesendet.
DropMembership	13	Löscht eine IP-Gruppenmitgliedschaft.
DropSourceMembership	16	Löscht eine Quellgruppe.
Error	4103	Ruft den Fehlerstatus ab und löscht ihn.
ExclusiveAddressUse	-5	Ermöglicht das Binden eines Sockets für den exklusiven Zugriff.
Expedited	2	Verwendet beschleunigte Daten wie in RFC-1222 definiert. Diese Option kann nur einmal festgelegt werden. Nachdem sie festgelegt wurde, kann sie nicht deaktiviert werden.
HeaderIncluded	2	Gibt an, dass die Anwendung den IP-Header für ausgehende Datagramme bereitstellt.
HopLimit	21	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	1	Gibt die IP-Optionen an, die in ausgehende Datagramme eingefügt werden sollen.
IPProtectionLevel	23	Ermöglicht die Einschränkung eines IPv6-Sockets auf einen angegebenen Bereich, z. B. Adressen mit demselben lokalen Oder Standortpräfix. Mit dieser Socketoption können Anwendungen Zugriffsbeschränkungen für IPv6-Sockets platzieren. Mit solchen Einschränkungen kann sich eine im privaten LAN ausgeführte Anwendung selbst einfach und stabil vor externen Angriffen schützen. Diese Socketoption erweitert oder beschränkt den Bereich eines empfangsbereiten Sockets und ermöglicht so bei Bedarf den uneingeschränkten Zugriff von öffentlichen und privaten Benutzern oder beschränkt den Zugriff nur auf denselben Standort. Für diese Socketoption sind in der IPProtectionLevel-Enumeration angegebene Schutzebenen definiert.
IpTimeToLive	4	Legt das Time-To-Live-Feld für die Gültigkeitsdauer im IP-Header fest.
IPv6Only	27	Gibt an, ob ein für die AF_INET6-Adressfamilie erstellter Socket auf IPv6-Kommunikation beschränkt ist. Für die AF_INET6-Adressfamilie erstellte Sockets können sowohl für IPv6- als auch für IPv4-Kommunikation verwendet werden. In einigen Anwendungen kann es erforderlich sein, die Verwendung eines für die AF_INET6-Adressfamilie erstellten Sockets auf die IPv6-Kommunikation zu beschränken. Wenn dieser Wert ungleich 0 ist (Standardwert unter Windows), kann ein für die AF_INET6-Adressfamilie erstellter Socket verwendet werden, um nur IPv6-Pakete zu senden und zu empfangen. Wenn dieser Wert 0 ist, kann ein für die AF_INET6-Adressfamilie erstellter Socket zum Senden und Empfangen von IPv6- oder IPv4-Paketen verwendet werden. Die Möglichkeit der Interaktion mit einer IPv4-Adresse setzt die Verwendung von IPv4-zugeordneten Adressen voraus. Diese Socketoption wird unter Windows Vista oder höher unterstützt.
KeepAlive	8	Verwendet Keep-Alives.
Linger	128	Das Schließen wird verzögert, wenn nicht gesendete Daten vorhanden sind.
MaxConnections	2147483647	Wird nicht unterstützt. Löst bei Verwendung eine SocketException aus.
MulticastInterface	9	Legt die Schnittstelle für ausgehende Multicastpakete fest.
MulticastLoopback	11	Ein IP-Multicast-Loopback.
MulticastTimeToLive	10	Eine IP-Multicast-Gültigkeitsdauer.
NoChecksum	1	Sendet UDP-Datagramme mit auf 0 festgelegter Prüfsumme.
NoDelay	1	Deaktiviert den Nagle-Algorithmus für Sammelsendungen.
OutOfBandInline	256	Empfängt Out-Of-Band-Daten im normalen Datenstream.
PacketInformation	19	Gibt Informationen über empfangene Pakete zurück.
ReceiveBuffer	4098	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	4100	Gibt die untere Grenze für Receive-Vorgänge an.
ReceiveTimeout	4102	Erhalten Sie ein Timeout. Diese Option gilt nur für synchrone Methoden; es hat keine Auswirkung auf asynchrone Methoden wie die BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) Methode.
ReuseAddress	4	Ermöglicht, dass der Socket an eine bereits verwendete Adresse gebunden wird.
ReuseUnicastPort	12295	Gibt an, dass das System die Portzuordnung für ausgehende Verbindungen verzögern soll. Dies entspricht der Verwendung der SO_REUSE_UNICASTPORT-Socketoption von Winsock 2.
SendBuffer	4097	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	4099	Gibt die untere Grenze für Send-Vorgänge an.
SendTimeout	4101	Senden eines Timeouts. Diese Option gilt nur für synchrone Methoden; es hat keine Auswirkung auf asynchrone Methoden wie die BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) Methode.
TcpKeepAliveInterval	17	Die Anzahl der Sekunden, die eine TCP-Verbindung auf eine Keep-Alive-Antwort wartet, bevor ein weiterer Keep-Alive-Test gesendet wird.
TcpKeepAliveRetryCount	16	Die Anzahl der TCP-Keep-Alive-Tests, die vor dem Beenden der Verbindung gesendet werden.
TcpKeepAliveTime	3	Die Anzahl der Sekunden, die eine TCP-Verbindung aktiv/im Leerlauf bleibt, bevor Keep-Alive-Tests an den Remotecomputer gesendet werden.
Type	4104	Ruft den Sockettyp ab.
TypeOfService	3	Ändert den Dienstfeldtyp des IP-Headers.
UnblockSource	18	Hebt die Sperre einer zuvor blockierten Quelle auf.
UpdateAcceptContext	28683	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	28688	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	64	Umgeht die Hardware nach Möglichkeit.

Beispiele

Im folgenden Codebeispiel wird diese Enumeration verwendet, um Socketoptionen festzulegen.

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

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

Hinweise

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

Gilt für