ConfigurationSectionWithCollection Class
Sert de classe de base pour les classes de section de configuration qui contiennent des collections.
Syntaxe
class ConfigurationSectionWithCollection : ConfigurationSection
Méthodes
Le tableau suivant répertorie les méthodes exposées par la classe ConfigurationSectionWithCollection.
| Nom | Description |
|---|---|
| Ajouter | Ajoute un élément à une collection dans une section de configuration. |
| Clear | Efface tous les éléments d’une collection dans une section de configuration. |
| Get | Récupère le membre spécifié d'une collection à partir d'une section de configuration. |
| GetAllowDefinition | (Hérité de ConfigurationSection.) |
| GetAllowLocation | (Hérité de ConfigurationSection.) |
| Remove | Supprime l'élément spécifié d'une collection dans une section de configuration. |
| RevertToParent | (Hérité de ConfigurationSection.) |
| SetAllowDefinition | (Hérité de ConfigurationSection.) |
| SetAllowLocation | (Hérité de ConfigurationSection.) |
Propriétés
Le tableau suivant répertorie les propriétés exposées par la classe ConfigurationSectionWithCollection.
| Nom | Description |
|---|---|
Location |
(Hérité de ConfigurationSection.) Une propriété clé. |
Path |
(Hérité de ConfigurationSection.) Une propriété clé. |
SectionInformation |
(Hérité de ConfigurationSection.) |
Sous-classes
Le tableau suivant répertorie les sous-classes exposées par la classe ConfigurationSectionWithCollection.
| Nom | Description |
|---|---|
| ApplicationDependenciesSection | Expose les informations de dépendance de l’application. |
| AppSettingsSection | Contient des paramètres d'application personnalisés, tels que des chemins de fichiers, des URL de service Web XML ou des informations stockées dans le fichier .ini d'une application. |
| AuthenticationModulesSection | Spécifie les modules d'authentification qui effectuent le processus d'authentification avec un serveur. |
| AuthenticationSection | Configure l'authentification ASP.NET. |
| AuthorizationSection | Configure l'autorisation d'accès aux URL. |
| CachingSection | Configure la sortie et la mise en cache du noyau. |
| ClientTargetSection | Spécifie une collection de mappages entre les alias et les agents utilisateurs. |
| CompilationSection | Configure les paramètres de compilation pour les applications ASP.NET. |
| ConfigProtectedDataSection | Contient des informations protégées sur le fournisseur de configuration. |
| ConnectionManagementSection | Contient une collection qui spécifie le nombre maximal de connexions aux hôtes réseau spécifiés pour les API System.Net. |
| ConnectionStringsSection | Spécifie une collection de chaînes de connexions aux bases de données pour les applications ASP.NET. |
| CustomErrorsSection | Configure les messages d'erreur personnalisés ASP.NET. |
| DefaultDocumentSection | Spécifie les noms de fichiers de pages Web à servir aux clients par défaut. |
| DefaultProxySection | Configure les valeurs par défaut du serveur proxy web. |
| DeviceFiltersSection | Représente une collection de filtres d’appareils qui déterminent les types d’appareils mobiles ou les fonctionnalités du navigateur mobile. |
| FastCgiSection | Contains configuration settings for FastCGI applications. |
| GlobalModulesSection | Expose les paramètres de configuration pour les modules globaux IIS. |
| HandlersSection | Stocke les gestionnaires d’une URL. |
| HealthMonitoringSection | Configure une application pour la surveillance de l’état. |
| HttpCompressionSection | Configure la compression HTTP. |
| HttpErrorsSection | Configure la gestion des erreurs HTTP pour un serveur web. |
| HttpHandlersSection | Configure les paramètres des gestionnaires ASP.NET. |
| HttpModulesSection | Contient des modules ASP.NET. |
| HttpProtocolSection | Représente une section de configuration du protocole HTTP. |
| HttpRedirectSection | Configure la redirection HTTP. |
| HttpTracingSection | Représente une section de configuration du traçage HTTP. |
| IisClientCertificateMappingAuthenticationSection | Configure le mappage pour les certificats clients IIS. |
| IPSecuritySection | Configure l'accès au contenu du serveur Web en fonction des informations relatives à l'adresse IP. |
| IsapiCgiRestrictionSection | Configure les restrictions ISAPI et Common Gateway Interface (CGI) pour un serveur Web qui s'exécute en mode ISAPI. |
| IsapiFiltersSection | Configure les filtres ISAPI sur un serveur Web. |
| ListenerAdaptersSection | Expose une collection d’adaptateurs d’écouteur. |
| MembershipSection | Valide les informations d’identification de l’utilisateur et gère les paramètres utilisateur. |
| MobileControlsSection | Expose les informations de configuration pour les contrôles mobiles, leurs adaptateurs et filtres d’appareil. |
| ModulesSection | Représente la section modules dans un fichier de configuration. |
| OutputCacheSettingsSection | Spécifie les paramètres de profil de cache de sortie qui peuvent être appliqués aux pages d’une application ASP.NET. |
| PagesSection | Représente la section <pages> d’un fichier Web.config. |
| ProtocolsSection | Contient une liste de protocoles de transmission qu'ASP.NET peut utiliser pour déchiffrer les données envoyées depuis un navigateur client dans la requête HTTP. |
| RequestFilteringSection | Configure l'analyse des requêtes URL entrantes. |
| RoleManagerSection | Définit les paramètres de configuration utilisés pour prendre en charge l'infrastructure de gestion des rôles des applications Web. |
| SchemaImporterExtensionsSection | Contient une collection d’extensions qui mappent les types XML Schema (XSD) aux types .NET Framework. |
| SecurityPolicySection | Définit une collection de mappages entre les fichiers de stratégie de sécurité et leurs noms de niveau de confiance. |
| SessionStateSection | Configure l’état de session pour une application Web. |
| SiteMapSection | Définit les paramètres de configuration pour la navigation sur le site. |
| SqlCacheDependencySection | Représente un System.Web.Caching.SqlCacheDependency |
| StaticContentSection | Expose les paramètres de configuration pour le contenu statique sur un site Web. |
| SystemCodeDomSection | Spécifie une collection de compilateurs qui fournissent la prise en charge Code Document Object Model (CodeDOM). |
| SystemDataSection | Spécifie une liste des fournisseurs de données ADO.NET installés. |
| SystemDiagnosticsSection | Configure les diagnostics et le suivi système. |
| TraceFailedRequestsSection | Représente une section de configuration de suivi des requêtes ayant échoué. |
| TraceProviderDefinitionsSection | Représente la section de configuration qui définit les fournisseurs de trace. |
| UrlMappingsSection | Représente une section <urlMappings> qui contient des paires de mappages d'URL entrants/sortants. |
| WebRequestModulesSection | Contient une collection de modules de requête Web inscrits. |
| WebServicesSection | Contrôle le comportement des services Web XML et de leurs clients. |
| WindowsAuthenticationSection | Configure l'Authentification Windows intégrée. |
Notes
Si vous modifiez une propriété de clé qui se trouve dans une collection, l'ordre de position (et l'index) de la propriété dans la collection peut changer. La propriété de clé modifiée sera ajoutée au début ou à la fin de la collection en fonction de la valeur de l'attribut mergeAppend.
Remarque
L'attribut mergeAppend se trouve dans le fichier de schéma approprié, dans la section qui correspond à la propriété de classe. Si l'attribut mergeAppend est false, les nouveaux éléments sont ajoutés au début de la collection ; si l'attribut mergeAppend est true, les nouveaux éléments sont ajoutés à la fin de la collection.
Vous devez faire attention à la façon dont vous accédez à une propriété clé dans une collection après que la valeur de la propriété clé a changé. Par exemple, si vous modifiez la valeur d'une propriété clé dont l'index est 4, le nouvel index de la propriété clé sera 0 si l'attribut mergeAppend est false.
Remarque
Vous devez être conscient de ce comportement lorsque vous créez un schéma personnalisé et des fichiers de configuration personnalisés. Vous ne devez pas modifier les attributs mergeAppend dans les fichiers de schéma fournis avec IIS 7. Vous ne pouvez pas modifier l'attribut mergeAppend à l'aide du fournisseur WMI pour IIS 7.
L'attribut mergeAppend affecte les propriétés de classe ConfigurationSectionWithCollection suivantes fournies avec IIS 7. Le tableau répertorie ces propriétés et leurs fichiers de schéma correspondants. Dans tous ces cas, les fichiers de schéma fournis avec IIS 7 spécifient false l'attribut mergeAppend.
| Classe | Propriété | Fichier de schéma |
|---|---|---|
| AuthorizationSection | Authorization |
ASPNET_Schema.xml |
| CachingSection | Profiles.Profiles |
IIS_Schema.xml |
| DefaultDocumentSection | Files.Files |
IIS_Schema.xml |
| HandlersSection | Handlers |
IIS_Schema.xml |
| HttpHandlersSection | HttpHandlers |
ASPNET_Schema.xml |
Hiérarchie d'héritage
ConfigurationSectionWithCollection
Spécifications
| Type | Description |
|---|---|
| Client | - IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10 |
| Serveur | - IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016 |
| Produit | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Fichier MOF | Webadministration.mof |
Voir aussi
Classe AuthorizationRule
Classe AuthorizationSection
Classe CachingProfileElement
Classe CachingProfileSettings
Classe CachingSection
Classe ConfigurationSection
Classe DefaultDocumentSection
Classe FileSettings
Classe HandlerAction
Classe HandlersSection
Classe HttpHandlerAction
Classe de section HttpHandlers
Classe StringElement