HttpRuntime的requestLengthDiskThreshold单位是字节还是千字节？

结论 #

requestLengthDiskThreshold的实际单位为千字节，和同配置段下的maxRequestLength单位一致，官方文档中“单位为字节”的描述属于笔误。 #

依据说明 #

1. 首先可以确认HttpRuntime配置段下的maxRequestLength单位为千字节，该标注与实际运行表现完全匹配，没有争议。
2. 官方文档对requestLengthDiskThreshold的描述存在自相矛盾：

   表示输入流缓冲阈值的字节数，默认值为80千字节。
   但该属性的配置元数据默认值为80，若单位为字节，80字节完全不可能等于文档标注的80千字节默认大小，显然存在描述错误。
   对应的属性元数据如下：

   // 可通过官方文档或IIS管理器验证该元数据
   [System.Configuration.ConfigurationProperty(
       "requestLengthDiskThreshold",
       DefaultValue=80)]
   

3. 现有公开资料确实存在两种矛盾说法，其中主张单位为字节的内容均是直接照搬了官方文档的错误描述，未经过实际运行验证；经过实测的资料均表明该参数的实际单位为千字节，和默认值表现一致。

使用建议 #

配置该参数时直接按千字节为单位填写数值即可，例如要设置阈值为256KB，直接配置对应值为256即可。 #

内容的提问来源于stack exchange，提问作者user2864740