共用方式為


HttpRuntimeSection 類別

設定 ASP.NET HTTP 執行時間設定,以決定指定 ASP.NET 應用程式的要求處理方式。

Syntax

class HttpRuntimeSection : ConfigurationSection  

方法

下表列出 類別所 HttpRuntimeSection 公開的方法。

名稱 描述
GetAllowDefinition (繼承自 ConfigurationSection.)
GetAllowLocation (繼承自 ConfigurationSection。)
RevertToParent (繼承自 ConfigurationSection。)
SetAllowDefinition (繼承自 ConfigurationSection。)
SetAllowLocation (繼承自 ConfigurationSection。)

屬性

下表列出 類別所 HttpRuntimeSection 公開的屬性。

名稱 描述
ApartmentThreading 選擇性的讀取/寫入 boolean 值。 true 如果已啟用 Apartment 執行緒,則為傳統 ASP 相容性;否則為 false 。 預設值為 false注意:此屬性是 .NET Framework 2.0 的新功能。
AppRequestQueueLimit 選擇性的讀取/寫入 sint32 值,指定應用程式 ASP.NET 佇列的要求數目上限。 預設值為 5000。 注意:針對 .NET Framework 1.0 和 1.1 版,預設值為 100。

當沒有足夠的可用執行緒來處理要求時,要求會排入佇列。 當佇列中的要求數目超過此屬性中指定的限制時,傳入要求會遭到拒絕,並出現「503 - 伺服器太忙碌」錯誤。
DelayNotificationTimeout 選擇性的讀取/寫入 datetime 值,指定延遲通知的逾時。 預設值是 5 秒。 注意:此屬性是 .NET Framework 2.0 的新功能。
Enable 選擇性的讀取/寫入 boolean 值。 true 如果應用程式域 (AppDomain) 啟用,以接受目前和子節點層級的傳入要求;否則為 false 。 預設值為 true。 如果 false 為 ,則會有效地關閉應用程式。
EnableHeaderChecking 選擇性的讀取/寫入 boolean 值。 true 如果 ASP.NET 應該檢查要求標頭是否有潛在的插入式攻擊;否則為 false 。 預設值為 true。 如果偵測到攻擊,ASP.NET 回應錯誤。 注意:此屬性是 .NET Framework 2.0 的新功能。
EnableKernelOutputCache 選擇性的讀取/寫入 boolean 值。 如果啟用輸出快取則為 true,否則為 false。 預設值為 true

只有在安裝 IIS 6.0 或 7.0 時,此屬性才相關。 輸出快取組態和要求類型會決定是否可以快取內容。

若要快取回應,您必須確定符合下列準則:

- 快取必須由頁面指示詞或使用快取 API 明確啟用。
- 快取必須有到期原則,才能讓核心辨識何時捨棄回應。
- 快取沒有任何變數標頭或參數。
- 不需要驗證。
EnableVersionHeader 選擇性的讀取/寫入 boolean 值。 true 如果 ASP.NET 應該輸出版本標頭,則為 ;否則為 false 。 預設值為 true

Visual Studio 2005 會使用這個屬性來判斷正在使用哪一個版本的 ASP.NET。 生產網站不需要這個屬性,而且可以停用。
ExecutionTimeout 選擇性的讀取/寫入 datetime 值,指定要求在自動停止 ASP.NET 之前,允許執行要求的時間上限。 預設值為 1 分鐘,50 秒。

只有當CompilationSection類別中的 屬性為 false 時, Debug 才會套用這個逾時。 若要避免在偵錯時關閉應用程式,請勿將此逾時設定為大型值。
Location (繼承自 ConfigurationSection .) 索引鍵屬性。
MaxRequestLength 選擇性的讀取/寫入 sint32 值,指定輸入資料流程緩衝閾值的限制,以 KB 為單位。 預設值為 4096 (4 MB) 。

您可以使用此限制來防止拒絕服務攻擊,例如,使用者將大型檔案張貼到伺服器。
MaxWaitChangeNotification 選擇性的讀取/寫入 sint32 值,指定在應用程式域重新開機新要求之前,在第一個檔案變更通知之後等候的時間上限,以秒為單位。 預設值是 0。

將此屬性設定為大於完成任何檔案複製程式之時間長度的數位。 檔案變更通知會根據這個屬性和 WaitChangeNotification 屬性的值結合。 注意:此屬性是 .NET Framework 2.0 的新功能。
MinFreeThreads 選擇性的讀取/寫入 sint32 值,指定 ASP.NET 要求需要其他執行緒才能完成處理的執行緒數目下限。 預設值為 8。
MinLocalRequestFreeThreads 選擇性的讀取/寫入 sint32 值,指定 ASP.NET 保留可供需要其他執行緒完成處理的本機要求使用的最小線程數目。 預設值為 4。 注意: 指定的執行緒數目會保留給來自本機主機的要求,在某些情況下,這些要求會在處理期間發出子要求。 這有助於防止具有遞迴遞迴重新進入網頁伺服器的可能死結。
Path (繼承自 ConfigurationSection .) 索引鍵屬性。
RequestLengthDiskThreshold 選擇性讀取/寫入 sint32 值,指定輸入資料流程緩衝閾值的限制,以位元組為單位。 預設值是 256。

此值不應超過 屬性中的 MaxRequestLength 值。 注意:此屬性是 .NET Framework 2.0 的新功能。
RequireRootedSaveAsPath 選擇性的讀取/寫入 boolean 值。 truefilename如果方法中的 SaveAs 參數必須是絕對路徑,則為 , false 否則為 。 預設值為 true

ASP.NET 進程必須具有在指定位置中建立檔案的許可權。 注意:此屬性是 .NET Framework 2.0 的新功能。
SectionInformation (繼承自 ConfigurationSection。)
SendCacheControlHeader 選擇性的讀取/寫入 boolean 值。 true 如果預設會傳送設定為 Private 的快取控制項標頭;否則為 false 。 如果 true 為 ,則會停用用戶端快取。 預設值為 true注意:此屬性是 .NET Framework 2.0 的新功能。
ShutdownTimeout 選擇性讀取/寫入 datetime 值,指定背景工作進程關閉所允許的時間。 預設值為 1 分鐘,30 秒。

逾時到期時,ASP.NET 關閉背景工作進程。 注意:此屬性是 .NET Framework 2.0 的新功能。
UseFullyQualifiedRedirectUrl 選擇性的讀取/寫入 boolean 值。 如果用戶端重新導向為完整的則為 true,否則為 false。 預設值為 false

若要完整限定用戶端重新導向,請使用 格式 http://server/path 。 某些行動控制項需要此格式。 如果 true 為 ,則所有未完整重新導向都會自動轉換成完整格式。 如果 false 為 ,則會將相對重新導向傳送至用戶端。 注意: 如果 false 為 ,則某些瀏覽器可能會在載入無 Cookie 會話中的頁面時發生問題。
WaitChangeNotification 選擇性的讀取/寫入 sint32 值,指定在應用程式域重新開機之前等候另一個檔案變更通知的時間,以秒為單位。 預設值是 0。

將此屬性設定為大於兩個檔案複製變更通知更新之間時間的數位。 檔案變更通知會根據此屬性和 MaxWaitChangeNotification 屬性的值來合併。 注意:此屬性是 .NET Framework 2.0 中的新功能。

子類別

這個類別不包含子類別。

繼承階層架構

ConfigurationSection

HttpRuntimeSection

規格需求

類型 描述
Client - Windows Vista 上的 IIS 7.0
- Windows 7 上的 IIS 7.5
- Windows 8 上的 IIS 8.0
- Windows 10上的 IIS 10.0
伺服器 - Windows Server 2008 上的 IIS 7.0
- Windows Server 2008 R2 上的 IIS 7.5
- Windows Server 2012 上的 IIS 8.0
- Windows Server 2012 R2 上的 IIS 8.5
- Windows Server 2016上的 IIS 10.0
產品 - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 檔案 WebAdministration.mof

另請參閱

System.Web.Configuration.SystemWebSectionGroup.HttpRuntime
ConfigurationSection 類別
CompilationSection 類別
CIM_DATETIME