KestrelServerOptions Klasse

Definition

Stellt die programmgesteuerte Konfiguration von Kestrel-spezifischen Features bereit.

public ref class KestrelServerOptions
public class KestrelServerOptions
type KestrelServerOptions = class
Public Class KestrelServerOptions
Vererbung
KestrelServerOptions

Konstruktoren

KestrelServerOptions()

Eigenschaften

AddServerHeader

Ruft ab oder legt fest, ob der Serverheader in jeder Antwort enthalten sein soll.

AllowAlternateSchemes

Ruft einen Wert ab, der steuert, wie das :scheme Feld für HTTP/2- und HTTP/3-Anforderungen überprüft wird, oder legt diesen fest.

False gibt an, dass das :scheme Feld für HTTP/2- und HTTP/3-Anforderungen genau mit dem Transport übereinstimmen muss (z. B. https für TLS-Verbindungen, HTTP für Nicht-TLS). True gibt an, dass das :scheme Feld für HTTP/2- und HTTP/3-Anforderungen auf alternative Werte festgelegt werden kann. Dies wird durch widergespiegelt. HttpRequest.Scheme Das Schema muss weiterhin gemäß gültig https://datatracker.ietf.org/doc/html/rfc3986/#section-3.1 sein. Aktivieren Sie dies nur, wenn Sie mit einem vertrauenswürdigen Proxy arbeiten. Dies kann in Szenarien wie Proxys verwendet werden, die aus alternativen Protokollen konvertiert werden. Siehe https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.3. Anwendungen, die dies ermöglichen, sollten überprüfen, ob ein erwartetes Schema bereitgestellt wird, bevor es verwendet wird.

AllowResponseHeaderCompression

Ruft einen Wert ab, der steuert, ob die dynamische Komprimierung von Antwortheadern zulässig ist, oder legt diesen fest. Weitere Informationen zu den Sicherheitsüberlegungen der dynamischen HPack-Headerkomprimierung finden Sie unter https://tools.ietf.org/html/rfc7541#section-7 .

AllowSynchronousIO

Ruft einen Wert ab, der steuert, ob synchrone E/A für und zulässig ist, oder legt diesen fest. RequestResponse

ApplicationSchedulingMode

Ruft einen Wert ab, der bestimmt, wie Kestrel Benutzerrückrufe planen soll, oder legt diesen fest.

ApplicationServices

Aktiviert den Rückruf der Lauschenoptionen, um Dienste aufzulösen und zu verwenden, die während des Starts von der Anwendung registriert wurden. Wird in der Regel von UseKestrel() initialisiert.

ConfigurationLoader

Stellt eine Konfigurationsquelle bereit, aus der Endpunkte beim Serverstart geladen werden. Der Standardwert ist null.

DisableStringReuse

Ruft einen Wert ab, der steuert, ob die materialisierten Zeichenfolgenwerte anforderungsübergreifend wiederverwendet werden, oder legt diesen fest. , wenn sie übereinstimmen oder wenn die Zeichenfolgen immer neu zugeordnet werden.

EnableAltSvc
Veraltet.

Steuert, ob der "Alt-Svc"-Header aus einer HTTP/2- oder niedrigeren Antwort für HTTP/3 zurückgegeben werden soll.

Limits

Ermöglicht den Zugriff auf Anforderungslimitoptionen.

RequestHeaderEncodingSelector

Ruft einen Rückruf ab, der Encoding zurückgibt, um den Wert für den angegebenen Anforderungsheadernamen zu decodieren oder den Standard zu verwenden, oder legt diesen null UTF8Encoding fest.

ResponseHeaderEncodingSelector

Ruft einen Rückruf ab, der Encoding zurückgibt, um den Wert für den angegebenen Antwortheader oder Nachspannnamen zu codieren oder den Standardwert zu verwenden, oder legt diesen null ASCIIEncoding fest.

Methoden

Configure()

Erstellt ein Konfigurationsladeprogramm zum Einrichten von Kestrel.

Configure(IConfiguration)

Erstellt ein Konfigurationsladeprogramm für das Einrichten von Kestrel, was IConfiguration als Eingabe erfordert. Diese Konfiguration muss auf den Konfigurationsabschnitt für Kestrel umgrenzt werden. Rufen Sie Configure(IConfiguration, Boolean) auf, um Updates für dynamische Endpunktbindungen zu aktivieren.

Configure(IConfiguration, Boolean)

Erstellt ein Konfigurationsladeprogramm für das Einrichten von Kestrel, was IConfiguration als Eingabe erfordert. Diese Konfiguration muss auf den Konfigurationsabschnitt für Kestrel umgrenzt werden.

ConfigureEndpointDefaults(Action<ListenOptions>)

Gibt eine Konfigurationsaktion an, die für jeden neu erstellten Endpunkt ausgeführt werden soll. Wenn Sie diese erneut aufrufen, wird die vorherige Aktion ersetzt.

ConfigureHttpsDefaults(Action<HttpsConnectionAdapterOptions>)

Gibt eine Konfigurationsaktion an, die für jeden neu erstellten HTTPS-Endpunkt ausgeführt werden soll. Wenn Sie diese erneut aufrufen, wird die vorherige Aktion ersetzt.

Listen(EndPoint)

Binden sie an den angegebenen Endpunkt.

Listen(EndPoint, Action<ListenOptions>)

Binden sie an den angegebenen Endpunkt. Der Rückruf konfiguriert endpunktspezifische Einstellungen.

Listen(IPAddress, Int32)

Binden sie an die angegebene IP-Adresse und den angegebenen Port.

Listen(IPAddress, Int32, Action<ListenOptions>)

Binden sie an die angegebene IP-Adresse und den angegebenen Port. Der Rückruf konfiguriert endpunktspezifische Einstellungen.

Listen(IPEndPoint)

Binden Sie an den angegebenen IP-Endpunkt.

Listen(IPEndPoint, Action<ListenOptions>)

Binden sie an die angegebene IP-Adresse und den angegebenen Port. Der Rückruf konfiguriert endpunktspezifische Einstellungen.

ListenAnyIP(Int32)

Lauscht auf allen IP-Dateien mit IPv6 [::] oder IPv4 0.0.0.0, wenn IPv6 nicht unterstützt wird.

ListenAnyIP(Int32, Action<ListenOptions>)

Lauscht auf allen IP-Dateien mit IPv6 [::] oder IPv4 0.0.0.0, wenn IPv6 nicht unterstützt wird.

ListenHandle(UInt64)

Öffnen Sie einen Socketdateideskriptor.

ListenHandle(UInt64, Action<ListenOptions>)

Öffnen Sie einen Socketdateideskriptor. Der Rückruf konfiguriert endpunktspezifische Einstellungen.

ListenLocalhost(Int32)

Lauscht an ::1 und 127.0.0.1 mit dem angegebenen Port. Das Anfordern eines dynamischen Ports durch Angabe von 0 wird für diesen Endpunkttyp nicht unterstützt.

ListenLocalhost(Int32, Action<ListenOptions>)

Lauscht an ::1 und 127.0.0.1 mit dem angegebenen Port. Das Anfordern eines dynamischen Ports durch Angabe von 0 wird für diesen Endpunkttyp nicht unterstützt.

ListenUnixSocket(String)

Binden sie an den angegebenen Unix-Domänensocketpfad.

ListenUnixSocket(String, Action<ListenOptions>)

Binden sie an den angegebenen Unix-Domänensocketpfad. Geben Sie rückruf an, um endpunktspezifische Einstellungen zu konfigurieren.

Erweiterungsmethoden

UseSystemd(KestrelServerOptions)

Öffnen Sie Dateideskriptoren (beginnend bei SD_LISTEN_FDS_START), die von der systemdocketbasierten Aktivierungslogik initialisiert werden, sofern verfügbar.

UseSystemd(KestrelServerOptions, Action<ListenOptions>)

Öffnen Sie Dateideskriptoren (beginnend bei SD_LISTEN_FDS_START), die von der systemdocketbasierten Aktivierungslogik initialisiert werden, sofern verfügbar. Geben Sie rückruf an, um endpunktspezifische Einstellungen zu konfigurieren.

Gilt für: