語言

HttpSysOptions 類別

定義

包含 HttpSys 所使用的選項。

public ref class HttpSysOptions
public class HttpSysOptions
type HttpSysOptions = class
Public Class HttpSysOptions
繼承
HttpSysOptions

建構函式

名稱 Description
HttpSysOptions()

初始化一個新的 HttpSysOptions。

屬性

名稱 Description
AllowSynchronousIO

控制 HttpContext.Request.Body 與 HttpContext.Response.Body 是否允許同步輸入/輸出。 預設值為 false。

Authentication

Http.Sys 認證設定。 刪除監聽器之前可以隨時修改這些設定。

ClientCertificateMethod

指示客戶端憑證應如何填充。 預設是允許憑證且不重新協商。 這不會改變 netsh 的「clientcertnegotiation」綁定選項,該綁定選項必須啟用,ClientCertificateMethod.AllowCertificate 才能解析憑證。

EnableKernelResponseBuffering

在核心中啟用回應資料的緩衝。 預設值為 false。 它應該被執行同步 I/O 的應用程式使用,或是執行一次不超過一個未完成寫入的非同步 I/O 的應用程式,並且能顯著提升高延遲連線下的吞吐量。 使用非同步 I/O 且同時可能有多個未完成發送的應用程式不應使用此標誌。 啟用此功能可能導致 Http.Sys 的 CPU 與記憶體使用率提高。

EnableResponseCaching

嘗試對具有合格標頭的回應進行核心模式快取。 回應中不得包含 Set-Cookie、Vary 或 Pragma 標頭。 它必須包含一個公開的 Cache-Control 標頭,以及共享的最大年齡或最大年齡值,或是過期標頭。 預設值為 true。

Http503Verbosity

會取得或設定一個值,控制 http.sys 在因限速條件而拒絕請求時的反應——例如當請求佇列達到上限時。 http.sys 的預設是「Basic」,意思是 http.sys 只是重置 TCP 連線。 IIS 預設使用 Limited 行為,會導致將 503 - 服務不可用回傳回給用戶端。 此設定在附加至現有佇列時不適用。

HttpAuthenticationHardeningLevel

設定 Http.Sys 的認證強化層級。 非Legacy 值指示 Http.Sys 驗證 RFC 5929 TLS 通道綁定令牌(CBT)是否符合認證請求,並透過 向應用程式 TryGetChannelBindingBytes(ChannelBindingKind, ReadOnlyMemory<Byte>)暴露每個請求的 CBT 。 預設值為 Medium。

MaxAccepts

可同時接收的數目上限。 預設值為 所回傳 ProcessorCount的處理器數量的 5 倍。

MaxConnections

接收或設定最多同時連線數以接受。 設定 -1 為無限。 設定為 以 null 使用登錄檔的全機設定。 預設值為 null (機器範圍設定)。

MaxRequestBodySize

取得或設定任何請求主體的最大允許大小(以位元組為單位)。 當設為 null 時,最大請求體大小為無限。 此限制對升級連線無影響,且連線始終為無限。 此設定可透過 IHttpMaxRequestBodySizeFeature依請求覆寫。 預設值為 30,000,000 位元組,約 28.6MB。

RequestQueueLimit

接收或設定會在 Http.Sys 排隊的最大請求數量。 此設定在附加至現有佇列時不適用。 預設值為 1000。

RequestQueueMode

這會指明伺服器是否負責建立和設定要求佇列,或是否應該附加至現有的佇列。 附加至現有佇列時,大多數的現有組態選項都不適用。 預設值為 RequestQueueMode.Create。

RequestQueueName

Http.Sys 請求佇列的名稱預設為 null (Anonymous queue)。

RequestQueueSecurityDescriptor

取得或設定請求佇列的安全描述符。

ThrowWriteExceptions

如果回應本體寫入因客戶端斷線而失敗,Gets 或 Sets 應該會拋出例外或正常完成。 預設是 false (正常完成)。

Timeouts

會暴露 Http.Sys 的逾時設定。 這些也可以在登錄檔中設定。 刪除監聽器之前可以隨時修改這些設定。 這些設定在附加到現有佇列時不適用。

UnsafePreferInlineScheduling

內嵌請求處理,而非派遣至執行緒池。

UrlPrefixes

網址前綴用於註冊 Http.Sys。 刪除監聽器之前可以隨時修改這些設定。 當連接到現有佇列時,前綴僅用於計算 PathBase 的請求。

UseLatin1RequestHeaders

設定請求標頭以使用 Latin1 編碼。

適用於