KestrelServerOptions Třída

Definice

Obor názvů:: Microsoft.AspNetCore.Server.Kestrel.Core

Sestavení:: Microsoft.AspNetCore.Server.Kestrel.Core.dll

Balíček:: Microsoft.AspNetCore.Server.Kestrel.Core v2.0.0

Balíček:: Microsoft.AspNetCore.Server.Kestrel.Core v2.1.0

Balíček:: Microsoft.AspNetCore.Server.Kestrel.Core v2.2.0

Balíček:: Microsoft.AspNetCore.App.Ref v3.0.1

Balíček:: Microsoft.AspNetCore.App.Ref v3.1.10

Balíček:: Microsoft.AspNetCore.App.Ref v5.0.0

Balíček:: Microsoft.AspNetCore.App.Ref v6.0.0

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje programovou konfiguraci funkcí specifických pro Kestrel.

public ref class KestrelServerOptions

public class KestrelServerOptions

type KestrelServerOptions = class

Public Class KestrelServerOptions

Dědičnost: Object
KestrelServerOptions

Konstruktory

KestrelServerOptions()

Vlastnosti

AddServerHeader	Získá nebo nastaví, jestli má být hlavička `Server` součástí každé odpovědi.
AllowAlternateSchemes	Získá nebo nastaví hodnotu, která určuje, jak se ověřuje pole pro `:scheme` požadavky HTTP/2 a HTTP/3. Pokud `má hodnotu false,` musí pole pro požadavky HTTP/2 a HTTP/3 přesně odpovídat přenosu (např. https pro připojení TLS, http pro jiné protokoly než `:scheme` TLS). Pokud má hodnotu `true,` může být pole pro `:scheme` požadavky HTTP/2 a HTTP/3 nastaveno na alternativní hodnoty a to se projeví pomocí `HttpRequest.Scheme` . Schéma musí být stále platné podle https://datatracker.ietf.org/doc/html/rfc3986/#section-3.1 . Tuto možnost povolte pouze při práci s důvěryhodným proxy serverem. To lze použít ve scénářích, jako jsou například proxy převáděné z alternativních protokolů. Viz třída https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.3. Aplikace, které to umožňují, by měly před použitím ověřit, že je k dispozici očekávané schéma.
AllowResponseHeaderCompression	Získá nebo nastaví hodnotu, která určuje, jestli je povolená dynamická komprese hlaviček odpovědi. Další informace o bezpečnostních aspektech komprese dynamických hlaviček HPacku najdete na adrese https://tools.ietf.org/html/rfc7541#section-7 .
AllowSynchronousIO	Získá nebo nastaví hodnotu, která určuje, zda je pro a povolen synchronní vstupně-v/ Request Response
ApplicationSchedulingMode	Získá nebo nastaví hodnotu, která určuje, jak má Kestrel plánovat zpětná volání uživatelů.
ApplicationServices	Umožňuje zpětnému volání možností Naslouchání přeložit a používat služby zaregistrované aplikací během spuštění. Obvykle je inicializovala metoda UseKestrel().
ConfigurationLoader	Poskytuje zdroj konfigurace, ze které se při spuštění serveru načtou koncové body. Výchozí formát je `null`.
DisableStringReuse	Získá nebo nastaví hodnotu, která určuje, jestli se materializované hodnoty řetězců budou opakovaně používat napříč požadavky. pokud se shodují, nebo pokud se řetězce vždy přerozdělí.
EnableAltSvc	Zastaralé. Určuje, jestli se má vrátit hlavička "Alt-Svc" z HTTP/2 nebo nižší odpovědi pro HTTP/3.
Limits	Poskytuje přístup k možnostem limitu požadavků.
RequestHeaderEncodingSelector	Získá nebo nastaví zpětné volání, které vrátí pro dekódování hodnoty zadaného názvu hlavičky požadavku nebo pro Encoding `null` použití výchozí hodnoty UTF8Encoding .
ResponseHeaderEncodingSelector	Získá nebo nastaví zpětné volání, které vrátí pro kódování hodnoty pro zadanou hlavičku odpovědi nebo název Encoding hlavičky, nebo pro použití výchozí hodnoty `null` ASCIIEncoding .

Metody

Configure()	Vytvoří zavaděč konfigurace pro nastavení Kestrel.
Configure(IConfiguration)	Vytvoří zavaděč konfigurace pro nastavení Kestrel, který přijímá IConfiguration jako vstup. Tato konfigurace musí být vymezená na oddíl konfigurace pro Kestrel. Voláním Configure(IConfiguration, Boolean) metody povolíte aktualizace vazeb dynamických koncových bodů.
Configure(IConfiguration, Boolean)	Vytvoří zavaděč konfigurace pro nastavení Kestrel, který přijímá IConfiguration jako vstup. Tato konfigurace musí být vymezená na oddíl konfigurace pro Kestrel.
ConfigureEndpointDefaults(Action<ListenOptions>)	Určuje konfigurační akci, která se má spustit pro každý nově vytvořený koncový bod. Když to znovu zavoláte, nahradíte předchozí akci.
ConfigureHttpsDefaults(Action<HttpsConnectionAdapterOptions>)	Určuje konfigurační akci, která se má spustit pro každý nově vytvořený koncový bod https. Když to znovu zavoláte, nahradíte předchozí akci.
Listen(EndPoint)	Vytvořte vazbu na daný koncový bod.
Listen(EndPoint, Action<ListenOptions>)	Vytvořte vazbu na daný koncový bod. Zpětné volání konfiguruje nastavení specifická pro koncový bod.
Listen(IPAddress, Int32)	Vytvořte vazbu na danou IP adresu a port.
Listen(IPAddress, Int32, Action<ListenOptions>)	Vytvořte vazbu na danou IP adresu a port. Zpětné volání konfiguruje nastavení specifická pro koncový bod.
Listen(IPEndPoint)	Vytvořte vazbu na daný koncový bod IP adresy.
Listen(IPEndPoint, Action<ListenOptions>)	Vytvořte vazbu na danou IP adresu a port. Zpětné volání konfiguruje nastavení specifická pro koncový bod.
ListenAnyIP(Int32)	Naslouchá všem IP adresám pomocí protokolu IPv6 [::] nebo IPv4 0.0.0.0, pokud se protokol IPv6 nepodporuje.
ListenAnyIP(Int32, Action<ListenOptions>)	Naslouchá všem IP adresám pomocí protokolu IPv6 [::] nebo IPv4 0.0.0.0, pokud se protokol IPv6 nepodporuje.
ListenHandle(UInt64)	Otevřete popisovač souboru soketu.
ListenHandle(UInt64, Action<ListenOptions>)	Otevřete popisovač souboru soketu. Zpětné volání konfiguruje nastavení specifická pro koncový bod.
ListenLocalhost(Int32)	Naslouchá na ::1 a 127.0.0.1 s daným portem. Tento typ koncového bodu nepodporuje vyžádání dynamického portu zadáním hodnoty 0.
ListenLocalhost(Int32, Action<ListenOptions>)	Naslouchá na ::1 a 127.0.0.1 s daným portem. Tento typ koncového bodu nepodporuje vyžádání dynamického portu zadáním hodnoty 0.
ListenUnixSocket(String)	Vytvořte vazbu na danou cestu k unixovému soketu domény.
ListenUnixSocket(String, Action<ListenOptions>)	Vytvořte vazbu na danou cestu k unixovému soketu domény. Zadejte zpětné volání pro konfiguraci nastavení specifických pro koncový bod.

Metody rozšíření

UseSystemd(KestrelServerOptions)	Otevření popisovačů souborů (počínaje SD_LISTEN_FDS_START) inicializovaných systémovou logikou aktivace založené na soketu, je-li k dispozici.
UseSystemd(KestrelServerOptions, Action<ListenOptions>)	Otevření popisovačů souborů (počínaje SD_LISTEN_FDS_START) inicializovaných systémovou logikou aktivace založené na soketu, je-li k dispozici. Zadejte zpětné volání pro konfiguraci nastavení specifického pro koncové body.

Platí pro