KestrelServerOptions Kelas

Definisi

Ruang nama:

Microsoft.AspNetCore.Server.Kestrel.Core

Rakitan:

Microsoft.AspNetCore.Server.Kestrel.Core.dll

Paket:

Microsoft.AspNetCore.App.Ref v8.0.0

Sumber:

KestrelServerOptions.cs

Menyediakan konfigurasi terprogram fitur khusus Kestrel.

public ref class KestrelServerOptions

public class KestrelServerOptions

type KestrelServerOptions = class

Public Class KestrelServerOptions

Warisan

Object

KestrelServerOptions

Konstruktor

KestrelServerOptions()

Menyediakan konfigurasi terprogram fitur khusus Kestrel.

Properti

AddServerHeader	Mendapatkan atau mengatur apakah Server header harus disertakan dalam setiap respons.
AllowAlternateSchemes	Mendapatkan atau menetapkan nilai yang mengontrol bagaimana :scheme bidang untuk permintaan HTTP/2 dan HTTP/3 divalidasi. Jika false kemudian bidang ':scheme' untuk permintaan HTTP/2 dan HTTP/3 harus sama persis dengan transportasi (misalnya https untuk koneksi TLS, http untuk non-TLS). Jika true kemudian bidang ':scheme' untuk permintaan HTTP/2 dan HTTP/3 dapat diatur ke nilai alternatif dan ini akan tercermin oleh 'HttpRequest.Scheme'. Skema masih harus valid sesuai dengan https://datatracker.ietf.org/doc/html/rfc3986/#section-3.1. Hanya aktifkan ini saat bekerja dengan proksi tepercaya. Ini dapat digunakan dalam skenario seperti proksi yang dikonversi dari protokol alternatif. Lihat https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.3. Aplikasi yang mengaktifkan ini harus memvalidasi skema yang diharapkan disediakan sebelum menggunakannya.
AllowHostHeaderOverride	Dalam HTTP/1.x, ketika target permintaan dalam bentuk absolut (lihat RFC 9112 Bagian 3.2.2), misalnya GET http://www.example.com/path/to/index.html HTTP/1.1 header Host redundan. Bahkan, RFC mengatakan Ketika server asal menerima permintaan dengan bentuk absolut dari target permintaan, server asal HARUS mengabaikan bidang header Host yang diterima (jika ada) dan sebaliknya menggunakan informasi host dari target permintaan. Namun, masih masuk akal untuk memeriksa apakah target permintaan dan header Host cocok karena ketidakcocokan mungkin menunjukkan, misalnya, upaya spoofing. Mengatur properti ini ke bypass true yang memeriksa dan secara tanpa syarat menimpa header Host dengan nilai dari target permintaan.
AllowResponseHeaderCompression	Mendapatkan atau menetapkan nilai yang mengontrol apakah pemadatan dinamis header respons diizinkan. Untuk informasi selengkapnya tentang pertimbangan keamanan kompresi header dinamis HPack, kunjungi https://tools.ietf.org/html/rfc7541#section-7.
AllowSynchronousIO	Mendapatkan atau menetapkan nilai yang mengontrol apakah IO sinkron diizinkan untuk Request dan Response
ApplicationServices	Memungkinkan panggilan balik opsi Dengar untuk mengatasi dan menggunakan layanan yang didaftarkan oleh aplikasi selama startup. Biasanya diinisialisasi oleh UseKestrel().
ConfigurationLoader	Menyediakan sumber konfigurasi tempat titik akhir akan dimuat pada awal server. Default adalah null.
DisableStringReuse	Mendapatkan atau menetapkan nilai yang mengontrol apakah nilai string yang terwujud akan digunakan kembali di seluruh permintaan; jika cocok, atau jika string akan selalu dialokasikan kembali.
EnableAltSvc	Kedaluwarsa. Mengontrol apakah akan mengembalikan header "Alt-Svc" dari HTTP/2 atau respons yang lebih rendah untuk HTTP/3.
Limits	Menyediakan akses ke opsi batas permintaan.
RequestHeaderEncodingSelector	Mendapatkan atau mengatur panggilan balik yang mengembalikan Encoding untuk mendekode nilai untuk nama header permintaan yang ditentukan, atau null untuk menggunakan default UTF8Encoding.
ResponseHeaderEncodingSelector	Mendapatkan atau mengatur panggilan balik yang mengembalikan Encoding untuk mengodekan nilai untuk header respons atau nama trailer yang ditentukan, atau null untuk menggunakan default ASCIIEncoding.

Metode

Configure()	Membuat pemuat konfigurasi untuk menyiapkan Kestrel.
Configure(IConfiguration)	Membuat pemuat konfigurasi untuk menyiapkan Kestrel yang mengambil IConfiguration sebagai input. Konfigurasi ini harus dilingkup ke bagian konfigurasi untuk Kestrel. Panggil Configure(IConfiguration, Boolean) untuk mengaktifkan pembaruan pengikatan titik akhir dinamis.
Configure(IConfiguration, Boolean)	Membuat pemuat konfigurasi untuk menyiapkan Kestrel yang mengambil IConfiguration sebagai input. Konfigurasi ini harus dilingkup ke bagian konfigurasi untuk Kestrel.
ConfigureEndpointDefaults(Action<ListenOptions>)	Menentukan Tindakan konfigurasi yang akan dijalankan untuk setiap titik akhir yang baru dibuat. Memanggil ini lagi akan menggantikan tindakan sebelumnya.
ConfigureHttpsDefaults(Action<HttpsConnectionAdapterOptions>)	Menentukan Tindakan konfigurasi yang akan dijalankan untuk setiap titik akhir https yang baru dibuat. Memanggil ini lagi akan menggantikan tindakan sebelumnya.
Listen(EndPoint)	Ikat ke titik akhir yang diberikan.
Listen(EndPoint, Action<ListenOptions>)	Ikat ke titik akhir yang diberikan. Panggilan balik mengonfigurasi pengaturan khusus titik akhir.
Listen(IPAddress, Int32)	Ikat ke alamat IP dan port yang diberikan.
Listen(IPAddress, Int32, Action<ListenOptions>)	Ikat ke alamat IP dan port yang diberikan. Panggilan balik mengonfigurasi pengaturan khusus titik akhir.
Listen(IPEndPoint)	Ikat ke titik akhir IP yang diberikan.
Listen(IPEndPoint, Action<ListenOptions>)	Ikat ke alamat IP dan port yang diberikan. Panggilan balik mengonfigurasi pengaturan khusus titik akhir.
ListenAnyIP(Int32)	Mendengarkan semua IP menggunakan IPv6 [::], atau IPv4 0.0.0.0 jika IPv6 tidak didukung.
ListenAnyIP(Int32, Action<ListenOptions>)	Mendengarkan semua IP menggunakan IPv6 [::], atau IPv4 0.0.0.0 jika IPv6 tidak didukung.
ListenHandle(UInt64)	Buka deskriptor file soket.
ListenHandle(UInt64, Action<ListenOptions>)	Buka deskriptor file soket. Panggilan balik mengonfigurasi pengaturan khusus titik akhir.
ListenLocalhost(Int32)	Mendengarkan di ::1 dan 127.0.0.1 dengan port yang diberikan. Meminta port dinamis dengan menentukan 0 tidak didukung untuk jenis titik akhir ini.
ListenLocalhost(Int32, Action<ListenOptions>)	Mendengarkan di ::1 dan 127.0.0.1 dengan port yang diberikan. Meminta port dinamis dengan menentukan 0 tidak didukung untuk jenis titik akhir ini.
ListenNamedPipe(String)	Ikat ke pipa bernama yang diberikan.
ListenNamedPipe(String, Action<ListenOptions>)	Ikat ke pipa bernama yang diberikan. Tentukan panggilan balik untuk mengonfigurasi pengaturan khusus titik akhir.
ListenUnixSocket(String)	Ikat ke jalur soket domain Unix yang diberikan.
ListenUnixSocket(String, Action<ListenOptions>)	Ikat ke jalur soket domain Unix yang diberikan. Tentukan panggilan balik untuk mengonfigurasi pengaturan khusus titik akhir.

Metode Ekstensi

UseSystemd(KestrelServerOptions)	Buka deskriptor file (mulai dari SD_LISTEN_FDS_START) yang diinisialisasi oleh logika aktivasi berbasis soket sistem jika tersedia.
UseSystemd(KestrelServerOptions, Action<ListenOptions>)	Buka deskriptor file (mulai dari SD_LISTEN_FDS_START) yang diinisialisasi oleh logika aktivasi berbasis soket sistem jika tersedia. Tentukan panggilan balik untuk mengonfigurasi pengaturan khusus titik akhir.