SqlCacheDependencySection Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Configure les dépendances de cache SQL pour une application ASP.NET. Cette classe ne peut pas être héritée.
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
- Héritage
Exemples
L’exemple de code suivant montre comment obtenir l’objet SqlCacheDependencySection à partir du fichier de configuration d’une application web existante.
// 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)
Remarques
Il SqlCacheDependencySection vous permet d’accéder par programmation et de modifier l’élément sqlCacheDependency de la cache section de configuration.
La dépendance de cache SQL permet de synchroniser les données mises en cache avec la source d’origine. Après avoir configuré la relation entre un élément stocké dans le cache d'une application ASP.NET et une table de base de données SQL Server spécifique, une instance de la classe SqlCacheDependency surveille la table afin que lorsqu'un élément de la table change, l'élément est automatiquement supprimé du cache.
Les paramètres de cet élément affectent uniquement la version basée sur la table de l’objet SqlCacheDependency . Les objets SqlCacheDependency utilisés avec SQL Server 2005 et versions ultérieures ne sont pas affectés par ces paramètres.
Note
Il SqlCacheDependencySection peut écrire des informations dans la section associée du fichier de configuration en fonction des restrictions définies par la propriété de AllowDefinition section dont la valeur est MachineToApplication. Toute tentative d’écriture dans un fichier de configuration à un niveau non autorisé dans la hiérarchie entraîne un message d’erreur généré par l’analyseur. Toutefois, vous pouvez utiliser cette classe pour lire les informations de configuration à n’importe quel niveau de la hiérarchie.
Constructeurs
| Nom | Description |
|---|---|
| SqlCacheDependencySection() |
Initialise une nouvelle instance de la classe SqlCacheDependencySection. |
Propriétés
| Nom | Description |
|---|---|
| CurrentConfiguration |
Obtient une référence à l’instance de niveau supérieur Configuration qui représente la hiérarchie de configuration à laquelle appartient l’instance ConfigurationElement actuelle. (Hérité de ConfigurationElement) |
| Databases |
Obtient la collection d’objets SqlCacheDependencyDatabase stockés dans le SqlCacheDependencySection. |
| ElementInformation |
Obtient un objet ElementInformation qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement. (Hérité de ConfigurationElement) |
| ElementProperty |
Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement) |
| Enabled |
Obtient ou définit une valeur indiquant si la table de base de données doit être surveillée pour les modifications. |
| EvaluationContext |
Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement) |
| HasContext |
Obtient une valeur qui indique si la propriété CurrentConfiguration est |
| Item[ConfigurationProperty] |
Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement) |
| Item[String] |
Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement) |
| LockAllAttributesExcept |
Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement) |
| LockAllElementsExcept |
Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement) |
| LockAttributes |
Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement) |
| LockElements |
Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement) |
| LockItem |
Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement) |
| PollTime |
Obtient ou définit la fréquence à laquelle la SqlCacheDependency table de base de données interroge les modifications. |
| Properties |
Obtient la collection de propriétés. (Hérité de ConfigurationElement) |
| SectionInformation |
Obtient un SectionInformation objet qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationSection . (Hérité de ConfigurationSection) |
Méthodes
| Nom | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement) |
| DeserializeSection(XmlReader) |
Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationSection) |
| Equals(Object) |
Compare l’instance actuelle ConfigurationElement à l’objet spécifié. (Hérité de ConfigurationElement) |
| GetHashCode() |
Obtient une valeur unique représentant l’instance actuelle ConfigurationElement . (Hérité de ConfigurationElement) |
| GetRuntimeObject() |
Retourne un objet personnalisé en cas de substitution dans une classe dérivée. (Hérité de ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement) |
| GetTransformedTypeString(String) |
Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Init() |
Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement) |
| InitializeDefault() |
Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement. (Hérité de ConfigurationElement) |
| IsModified() |
Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargé lors de l’implémentation dans une classe dérivée. (Hérité de ConfigurationSection) |
| IsReadOnly() |
Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement) |
| ListErrors(IList) |
Ajoute les erreurs de propriété non valides dans cet objet ConfigurationElement et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtient une valeur indiquant si un élément inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement) |
| PostDeserialize() |
Appelé après la désérialisation. (Hérité de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Appelé avant la sérialisation. (Hérité de ConfigurationElement) |
| Reset(ConfigurationElement) |
Réinitialise l’état interne de l’objet ConfigurationElement , y compris les verrous et les collections de propriétés. (Hérité de ConfigurationElement) |
| ResetModified() |
Réinitialise la valeur de la IsModified() méthode |
| SerializeElement(XmlWriter, Boolean) |
Écrit le contenu de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Crée une chaîne XML contenant une vue non fusionnée de l’objet ConfigurationSection sous la forme d’une section unique à écrire dans un fichier. (Hérité de ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement) |
| SetReadOnly() |
Définit la IsReadOnly() propriété de l’objet ConfigurationElement et de tous les sous-éléments. (Hérité de ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indique si l’élément spécifié doit être sérialisé lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du .NET Framework. (Hérité de ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indique si la propriété spécifiée doit être sérialisée lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du .NET Framework. (Hérité de ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indique si l’instance ConfigurationSection actuelle doit être sérialisée lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du framework .NET. (Hérité de ConfigurationSection) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifie l’objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement) |