OutputCacheProfile 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

設定可由應用程式頁面使用的輸出快取設定檔。 此類別無法獲得繼承。

public ref class OutputCacheProfile sealed : System::Configuration::ConfigurationElement

public sealed class OutputCacheProfile : System.Configuration.ConfigurationElement

type OutputCacheProfile = class
    inherit ConfigurationElement

Public NotInheritable Class OutputCacheProfile
Inherits ConfigurationElement

繼承

Object

ConfigurationElement

OutputCacheProfile

範例

下列程式碼範例示範如何使用 OutputCacheProfiles 集合來存取其 OutputCacheProfile 物件。

  // Get the Web application configuration.
  System.Configuration.Configuration webConfig =
  WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

 // Get the section.

  string configPath = 
      "system.web/caching/outputCacheSettings";
  System.Web.Configuration.OutputCacheSettingsSection outputCacheSettings =
  (System.Web.Configuration.OutputCacheSettingsSection)webConfig.GetSection(
  configPath);

// Get the profile at zero index.
System.Web.Configuration.OutputCacheProfile outputCacheProfile = 
  outputCacheSettings.OutputCacheProfiles[0];

  ' Get the Web application configuration.
  Dim webConfig _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

  ' Get the section.
  Dim configPath As String = _
 "system.web/caching/outputCacheSettings"
  Dim outputCacheSettings _
  As System.Web.Configuration.OutputCacheSettingsSection = _
  CType(webConfig.GetSection(configPath), _
  System.Web.Configuration.OutputCacheSettingsSection)

' Get the profile at zero index.
  Dim outputCacheProfile _
  As System.Web.Configuration.OutputCacheProfile = _
  outputCacheSettings.OutputCacheProfiles(0)

備註

類別 OutputCacheProfile 提供一種方式，以程式設計方式存取和修改 add 組態檔區段中區 outputCacheProfiles 段 caching 的 元素。

物件 OutputCacheProfile 會集中常用的組態設定，例如相依性、快取位置和快取到期時間，而不需要在每個頁面上指定它們。

OutputCacheProfile可以使用 指示詞的 @ OutputCache 屬性，將 套用至頁面 CacheProfile 。

注意

指示 @ OutputCache 詞可以覆寫 物件所包含的 OutputCacheProfile 所有設定，但 屬性除外 Enabled 。 這是啟用或停用 ， OutputCacheProfile 而不需要修改可能已覆寫的所有頁面中的 指示詞。

類別 CacheDependency 會監視相依性，以便在任何快取的專案變更時自動移除快取的專案。

建構函式

OutputCacheProfile(String)

初始化 OutputCacheProfile 類別的新執行個體。

屬性

CurrentConfiguration	取得最上層 Configuration 執行個體的參考，這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。 (繼承來源 ConfigurationElement)
Duration	取得或設定快取頁面或控制項的時間長度。
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
Enabled	取得或設定指示是否啟用快取的值。
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，指出 CurrentConfiguration 屬性是否為 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定此一組態項目的屬性或子項目。 (繼承來源 ConfigurationElement)
Location	取得或設定輸出快取的位置。
LockAllAttributesExcept	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出此項目是否已被鎖定。 (繼承來源 ConfigurationElement)
Name	取得或設定 OutputCacheProfile 名稱。
NoStore	取得或設定值，指出是否啟用次要儲存區。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
SqlDependency	取得或設定 SqlDependency 屬性。
VaryByContentEncoding	取得或設定一組要快取的內容編碼方式，並以分號來區隔。
VaryByControl	取得或設定 VaryByControl 屬性。
VaryByCustom	取得或設定 VaryByCustom 屬性。
VaryByHeader	取得或設定 VaryByHeader 屬性。
VaryByParam	取得或設定 VaryByParam 屬性。

方法

DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	將目前的 ConfigurationElement 執行個體與指定的物件相比較。 (繼承來源 ConfigurationElement)
GetHashCode()	取得表示目前 ConfigurationElement 執行個體的唯一值。 (繼承來源 ConfigurationElement)
GetTransformedAssemblyString(String)	傳回指定之組件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為它的初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	在衍生類別中進行實作時，指出這個組態項目自上次儲存或載入後是否已修改。 (繼承來源 ConfigurationElement)
IsReadOnly()	取得值，這個值表示 ConfigurationElement 物件是否唯讀。 (繼承來源 ConfigurationElement)
ListErrors(IList)	將這個 ConfigurationElement 物件中和所有子項目中的無效屬性錯誤加入傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	取得值，指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	取得值，指出在還原序列化程序中是否遇到未知的項目。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	在找不到必要的屬性時擲回例外狀況 (Exception)。 (繼承來源 ConfigurationElement)
PostDeserialize()	還原序列化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	序列化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	重設 ConfigurationElement 物件的內部狀態，包括鎖定和屬性的集合。 (繼承來源 ConfigurationElement)
ResetModified()	在衍生類別中實作時，將 IsModified() 方法的值重設為 false。 (繼承來源 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	在衍生類別中實作時，將此組態項目的內容寫入組態檔中。 (繼承來源 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態項目的外部標記寫入組態檔中。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。 (繼承來源 ConfigurationElement)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 物件，以移除不應該儲存的所有值。 (繼承來源 ConfigurationElement)

另請參閱

• OutputCacheProfileCollection
• CacheDependency
• 快取應用程式資料
• 如何：以宣告方式設定頁面的快取性
• 作法：以程式設計方式設定頁面的快取性