HttpSysOptions 类

定义

命名空间:

Microsoft.AspNetCore.Server.HttpSys

程序集:

Microsoft.AspNetCore.Server.HttpSys.dll

程序包:

Microsoft.AspNetCore.App.Ref v10.0.0

包含 HttpSys 使用的选项。

public ref class HttpSysOptions

public class HttpSysOptions

type HttpSysOptions = class

Public Class HttpSysOptions

继承

Object

HttpSysOptions

构造函数

名称	说明
HttpSysOptions()	初始化新的 HttpSysOptions。

属性

名称	说明
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 标头，以及共享最大期限或最大期限值，或 Expires 标头。 默认值为 true。
Http503Verbosity	获取或设置一个值，该值控制在因限制条件而拒绝请求时 http.sys 的反应方式，例如达到请求队列限制时。 http.sys 中的默认值为“基本”，这意味着 http.sys 只是重置 TCP 连接。 IIS 使用 Limited 作为默认行为，这将导致将 503 - 服务不可用发回客户端。 附加到现有队列时，此设置不适用。
MaxAccepts	最大并发接受数量。 默认值是返回的 ProcessorCount处理器数的 5 倍。
MaxConnections	获取或设置要接受的最大并发连接数。 设置为 -1 无限。 null设置为使用注册表的计算机范围设置。 默认值为 null （计算机范围设置）。
MaxRequestBodySize	获取或设置任何请求正文的最大允许大小（以字节为单位）。 设置为 null 时，最大请求正文大小不受限制。 此限制对始终不受限制的升级连接没有影响。 可以通过 < a0/a0> 重写每个请求 。 默认值设置为 30,000,000 字节，大约为 28.6MB。
RequestQueueLimit	获取或设置将在 Http.Sys 中排队的最大请求数。 附加到现有队列时，此设置不适用。 默认值为 1000。
RequestQueueMode	这指示服务器是否负责创建和配置请求队列，或是否应附加到现有队列。 附加到现有队列时，大多数现有配置选项不适用。 默认值为 RequestQueueMode.Create。
RequestQueueName	Http.Sys 请求队列的名称默认值为 null （匿名队列）。
RequestQueueSecurityDescriptor	获取或设置请求队列的安全描述符。
ThrowWriteExceptions	获取或设置由于客户端断开连接而失败的响应正文写入是否应引发异常或正常完成。 默认值为 false （正常完成）。
Timeouts	公开 Http.Sys 超时配置。 还可以在注册表中配置这些配置。 这些设置可以在释放侦听器之前随时进行修改。 附加到现有队列时，这些设置不适用。
UnsafePreferInlineScheduling	内联请求处理，而不是调度到线程池。
UrlPrefixes	要注册到 Http.Sys 的 URL 前缀。 这些设置可以在释放侦听器之前随时进行修改。 附加到现有队列时，前缀仅用于计算请求的 PathBase。
UseLatin1RequestHeaders	配置请求标头以使用 Latin1 编码。