KestrelServerOptions Sınıf

Tanım

Kestrel özgü özelliklerin programlı yapılandırılmasını sağlar.

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

Oluşturucular

KestrelServerOptions()

Özellikler

AddServerHeader

Sunucu üstbilgisinin her yanıta dahil edilip edilmeyeceğini alır veya ayarlar.

AllowAlternateSchemes

:schemeHttp/2 ve http/3 istekleri için alanın nasıl doğrulanacağını denetleyen bir değer alır veya ayarlar.

Yanlış Ise, :scheme http/2 ve http/3 isteklerinin alanı aktarımla tam olarak eşleşmelidir (örneğin, TLS bağlantıları IÇIN https, TLS olmayan için http). Doğru Ise, :scheme http/2 ve http/3 isteklerinin alanı alternatif değerlere ayarlanabilir ve bu, tarafından yansıtılır HttpRequest.Scheme . Düzenin öğesine göre hala geçerli olması gerekir https://datatracker.ietf.org/doc/html/rfc3986/#section-3.1 . Bunu yalnızca güvenilir bir ara sunucu ile çalışırken etkinleştirin. Bu, alternatif protokollerden dönüştürme proxy 'leri gibi senaryolarda kullanılabilir. Bkz. https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.3. Bunu etkinleştiren uygulamalar, kullanılmadan önce beklenen bir düzenin sağlanması gerektiğini doğrulamalıdır.

AllowResponseHeaderCompression

Yanıt üst bilgilerine dinamik sıkıştırmayla izin verilip verilmeyeceğini denetleyen bir değer alır veya ayarlar. HPack dinamik üstbilgi sıkıştırması güvenlik konuları hakkında daha fazla bilgi için, adresini ziyaret edin https://tools.ietf.org/html/rfc7541#section-7 .

AllowSynchronousIO

Ve için zaman uyumlu GÇ izin verilip verilmeyeceğini denetleyen bir değer alır veya ayarlar RequestResponse

ApplicationSchedulingMode

Kestrel 'ın Kullanıcı geri çağırmaları nasıl zamanlamayacağına karar veren bir değer alır veya ayarlar.

ApplicationServices

Başlatma sırasında uygulama tarafından kaydedilen Hizmetleri çözümlemek ve kullanmak için dinleme seçenekleri geri çağırmasını sağlar. Genellikle UseKestrel () tarafından başlatılır.

ConfigurationLoader

Sunucu başlangıcından bitiş noktalarının yükleneceği bir yapılandırma kaynağı sağlar. Varsayılan değer: null.

DisableStringReuse

İstek içinde oluşan dize değerlerinin yeniden kullanılıp kullanılmayacağını denetleyen bir değer alır veya ayarlar; eşleşiyorsa veya dizeler her zaman yeniden ayrılacaktır.

EnableAltSvc
Kullanımdan kalktı.

Http/3 için bir HTTP/2 veya daha düşük yanıttan "alt-svc" üstbilgisinin döndürülüp döndürülmeyeceğini denetler.

Limits

İstek sınırı seçeneklerine erişim sağlar.

RequestHeaderEncodingSelector

EncodingBelirtilen istek üst bilgisi adının kodunu çözmek için ya da varsayılan değeri kullanmak için ' i döndüren bir geri çağırma alır veya ayarlar null UTF8Encoding .

ResponseHeaderEncodingSelector

EncodingBelirtilen yanıt üst bilgisi veya treyler adı için değeri kodlamak üzere veya varsayılanı kullanmak için ' i döndüren bir geri çağırma alır veya ayarlar null ASCIIEncoding .

Yöntemler

Configure()

Kestrel ayarlamak için bir yapılandırma yükleyicisi oluşturur.

Configure(IConfiguration)

Bir as girişi alan Kestrel ayarlamak için bir yapılandırma yükleyicisi oluşturur IConfiguration . Bu yapılandırma, Kestrel için yapılandırma bölümünün kapsamına alınmalıdır. Configure(IConfiguration, Boolean)Dinamik uç nokta bağlama güncelleştirmelerini etkinleştirmek için çağırın.

Configure(IConfiguration, Boolean)

Bir as girişi alan Kestrel ayarlamak için bir yapılandırma yükleyicisi oluşturur IConfiguration . Bu yapılandırma, Kestrel için yapılandırma bölümünün kapsamına alınmalıdır.

ConfigureEndpointDefaults(Action<ListenOptions>)

Yeni oluşturulan her uç nokta için çalıştırılacak bir yapılandırma eylemi belirtir. Bunu yeniden çağırmak, önceki eylemin yerini alır.

ConfigureHttpsDefaults(Action<HttpsConnectionAdapterOptions>)

Yeni oluşturulan her HTTPS uç noktası için çalıştırılacak bir yapılandırma eylemi belirtir. Bunu yeniden çağırmak, önceki eylemin yerini alır.

Listen(EndPoint)

Verilen uç noktaya bağlayın.

Listen(EndPoint, Action<ListenOptions>)

Verilen uç noktaya bağlayın. Geri çağırma, Endpoint 'e özgü ayarları yapılandırır.

Listen(IPAddress, Int32)

Verilen IP adresine ve bağlantı noktasına bağlayın.

Listen(IPAddress, Int32, Action<ListenOptions>)

Verilen IP adresine ve bağlantı noktasına bağlayın. Geri çağırma, Endpoint 'e özgü ayarları yapılandırır.

Listen(IPEndPoint)

Verilen IP uç noktasına bağlayın.

Listen(IPEndPoint, Action<ListenOptions>)

Verilen IP adresine ve bağlantı noktasına bağlayın. Geri çağırma, Endpoint 'e özgü ayarları yapılandırır.

ListenAnyIP(Int32)

IPv6 desteklenmiyorsa IPv6 [::] veya IPv4 0.0.0.0 kullanarak tüm IP 'Lerde dinler.

ListenAnyIP(Int32, Action<ListenOptions>)

IPv6 desteklenmiyorsa IPv6 [::] veya IPv4 0.0.0.0 kullanarak tüm IP 'Lerde dinler.

ListenHandle(UInt64)

Bir yuva dosya tanımlayıcısı açın.

ListenHandle(UInt64, Action<ListenOptions>)

Bir yuva dosya tanımlayıcısı açın. Geri çağırma, Endpoint 'e özgü ayarları yapılandırır.

ListenLocalhost(Int32)

Verilen bağlantı noktasıyla:: 1 ve 127.0.0.1 tarihinde dinler. Bu uç nokta türü için 0 belirterek dinamik bir bağlantı noktası istemek desteklenmez.

ListenLocalhost(Int32, Action<ListenOptions>)

Verilen bağlantı noktasıyla:: 1 ve 127.0.0.1 tarihinde dinler. Bu uç nokta türü için 0 belirterek dinamik bir bağlantı noktası istemek desteklenmez.

ListenUnixSocket(String)

Verilen UNIX etki alanı yuva yoluna bağlayın.

ListenUnixSocket(String, Action<ListenOptions>)

Verilen UNIX etki alanı yuva yoluna bağlayın. Endpoint 'e özgü ayarları yapılandırmak için geri çağırma belirtin.

Uzantı Metotları

UseSystemd(KestrelServerOptions)

Varsa, systemd yuva tabanlı etkinleştirme mantığı tarafından başlatılan dosya tanımlayıcılarını (SD_LISTEN_FDS_START 'den başlayarak) açın.

UseSystemd(KestrelServerOptions, Action<ListenOptions>)

Varsa, systemd yuva tabanlı etkinleştirme mantığı tarafından başlatılan dosya tanımlayıcılarını (SD_LISTEN_FDS_START 'den başlayarak) açın. Endpoint 'e özgü ayarları yapılandırmak için geri çağırma belirtin.

Şunlara uygulanır