SqlCacheDependencySection 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

設定 ASP.NET 應用程式的 SQL 快取相依性。 此類別無法獲得繼承。

public ref class SqlCacheDependencySection sealed : System::Configuration::ConfigurationSection

public sealed class SqlCacheDependencySection : System.Configuration.ConfigurationSection

type SqlCacheDependencySection = class
    inherit ConfigurationSection

Public NotInheritable Class SqlCacheDependencySection
Inherits ConfigurationSection

繼承

Object

ConfigurationElement

ConfigurationSection

SqlCacheDependencySection

範例

下列程式代碼範例示範如何從現有 Web 應用程式的組態檔取得 SqlCacheDependencySection 物件。

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

// Get the section.
string configPath = "system.web/cache/sqlCacheDependency";
System.Web.Configuration.SqlCacheDependencySection sqlDs = 
(System.Web.Configuration.SqlCacheDependencySection)webConfig.GetSection(
configPath);

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


' Get the section.
  Dim configPath As String = _
  "system.web/cache/sqlCacheDependency"
  Dim sqlDs _
  As System.Web.Configuration.SqlCacheDependencySection = _
  CType(webConfig.GetSection(configPath), _
  System.Web.Configuration.SqlCacheDependencySection)

備註

SqlCacheDependencySection可讓您以程式設計方式存取和修改sqlCacheDependency組態區段的 cache 元素。

SQL 快取相依性可讓快取的數據與原始來源同步處理。 設定儲存在 ASP.NET 應用程式快取和特定 SQL Server 資料庫數據表中之專案之間的關聯性之後，類別的 SqlCacheDependency 實例會監視數據表，以便在數據表中的專案變更時，專案會自動從快取中移除。

這個專案中的設定只會影響對象的數據表版本 SqlCacheDependency 。 與 SQL Server 2005 和更新版本搭配使用的數據列層級 SqlCacheDependency 物件不會受到這些設定的影響。

注意

SqlCacheDependencySection可以根據值為MachineToApplication的 section 屬性AllowDefinition所定義的限制，將資訊寫入組態檔的相關區段。 在階層中不允許的層級寫入組態檔的任何嘗試，都會產生剖析器所產生的錯誤訊息。 不過，您可以使用這個類別來讀取階層中任何層級的組態資訊。

建構函式

SqlCacheDependencySection()

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

屬性

CurrentConfiguration	取得最上層 Configuration 執行個體的參考，這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。 (繼承來源 ConfigurationElement)
Databases	取得儲存在 SqlCacheDependencyDatabase 之中的 SqlCacheDependencySection 物件的集合。
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)
LockAllAttributesExcept	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出此項目是否已被鎖定。 (繼承來源 ConfigurationElement)
PollTime	取得或設定 SqlCacheDependency 輪詢資料庫資料表，以監視變更的頻率。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
SectionInformation	取得 SectionInformation 物件，該物件包含 ConfigurationSection 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationSection)

方法

DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
DeserializeSection(XmlReader)	從組態檔讀取 XML。 (繼承來源 ConfigurationSection)
Equals(Object)	將目前的 ConfigurationElement 執行個體與指定的物件相比較。 (繼承來源 ConfigurationElement)
GetHashCode()	取得表示目前 ConfigurationElement 執行個體的唯一值。 (繼承來源 ConfigurationElement)
GetRuntimeObject()	在衍生類別中覆寫時，傳回自訂物件。 (繼承來源 ConfigurationSection)
GetTransformedAssemblyString(String)	傳回指定之組件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為它的初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	在衍生類別中進行實作時，指出這個組態項目自上次儲存或載入後是否已修改。 (繼承來源 ConfigurationSection)
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。 (繼承來源 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	在衍生類別中實作時，將此組態項目的內容寫入組態檔中。 (繼承來源 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	建立 XML 字串，在該字串的單一區段中，包含了要寫入檔案之 ConfigurationSection 物件的取消合併檢視。 (繼承來源 ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態項目的外部標記寫入組態檔中。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。 (繼承來源 ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	指出當針對 .NET Framework 指定的目標版本串行化組態物件階層時，是否應該串行化指定的專案。 (繼承來源 ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	指出當針對 .NET Framework 指定的目標版本串行化組態物件階層時，是否應該串行化指定的屬性。 (繼承來源 ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	指出當針對 .NET Framework 指定的目標版本串行化組態物件階層時，是否應該串行化目前的 ConfigurationSection 實例。 (繼承來源 ConfigurationSection)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 物件，以移除不應該儲存的所有值。 (繼承來源 ConfigurationElement)

另請參閱

• SqlCacheDependencyDatabase
• SqlCacheDependencyDatabaseCollection
• SqlCacheDependency
• ASP.NET 快取功能