Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ConfigurationElementCollection, classe

Représente un élément de configuration contenant une collection d'éléments enfants.

System.Object
  System.Configuration.ConfigurationElement
    System.Configuration.ConfigurationElementCollection
      En savoir plus...

Espace de noms :  System.Configuration
Assembly :  System.Configuration (dans System.Configuration.dll)

public abstract class ConfigurationElementCollection : ConfigurationElement, 
	ICollection, IEnumerable

Le type ConfigurationElementCollection expose les membres suivants.

  NomDescription
Méthode protégéeConfigurationElementCollection()Initialise une nouvelle instance de la classe ConfigurationElementCollection.
Méthode protégéeConfigurationElementCollection(IComparer)Crée une instance de la classe ConfigurationElementCollection.
Début

  NomDescription
Propriété protégéeAddElementNameObtient ou définit le nom du ConfigurationElement à associer à l'opération d'ajout dans ConfigurationElementCollection en cas de substitution dans une classe dérivée.
Propriété protégéeClearElementNameObtient ou définit le nom du ConfigurationElement à associer à l'opération d'effacement dans ConfigurationElementCollection en cas de substitution dans une classe dérivée.
Propriété publiqueCollectionTypeObtient le type de ConfigurationElementCollection.
Propriété publiqueCountObtient le nombre d'éléments de la collection.
Propriété publiqueCurrentConfigurationObtient une référence à l'instance Configuration de niveau supérieur qui représente la hiérarchie de configuration à laquelle l'instance ConfigurationElement actuelle appartient. (Hérité de ConfigurationElement.)
Propriété publiqueElementInformationObtient un objet ElementInformation qui contient les fonctionnalités et informations non personnalisables de l'objet ConfigurationElement. (Hérité de ConfigurationElement.)
Propriété protégéeElementNameObtient le nom utilisé pour identifier cette collection d'éléments dans le fichier de configuration en cas de substitution dans une classe dérivée.
Propriété protégéeElementPropertyObtient l'objet ConfigurationElementProperty qui représente l'objet ConfigurationElement lui-même. (Hérité de ConfigurationElement.)
Propriété publiqueEmitClearObtient ou définit une valeur qui spécifie si la collection a été effacée.
Propriété protégéeEvaluationContextObtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement.)
Propriété protégéeHasContextObtient une valeur qui indique si la propriété CurrentConfiguration a la valeur null. (Hérité de ConfigurationElement.)
Propriété publiqueIsSynchronizedObtient une valeur indiquant si l'accès à la collection est synchronisé.
Propriété protégéeItem[ConfigurationProperty]Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement.)
Propriété protégéeItem[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.)
Propriété publiqueLockAllAttributesExceptObtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement.)
Propriété publiqueLockAllElementsExceptObtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement.)
Propriété publiqueLockAttributesObtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement.)
Propriété publiqueLockElementsObtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement.)
Propriété publiqueLockItemObtient ou définit une valeur indiquant si l'élément est verrouillé. (Hérité de ConfigurationElement.)
Propriété protégéePropertiesObtient la collection de propriétés. (Hérité de ConfigurationElement.)
Propriété protégéeRemoveElementNameObtient ou définit le nom du ConfigurationElement à associer à l'opération de suppression dans ConfigurationElementCollection en cas de substitution dans une classe dérivée.
Propriété publiqueSyncRootObtient un objet utilisé pour synchroniser l'accès à ConfigurationElementCollection.
Propriété protégéeThrowOnDuplicateObtient une valeur indiquant si une tentative d'ajout d'un ConfigurationElement dupliqué à ConfigurationElementCollection provoquera la levée d'une exception.
Début

  NomDescription
Méthode protégéeBaseAdd(ConfigurationElement)Ajoute un élément de configuration à ConfigurationElementCollection.
Méthode protégéeBaseAdd(ConfigurationElement, Boolean)Ajoute un élément de configuration à la collection d'éléments de configuration.
Méthode protégéeBaseAdd(Int32, ConfigurationElement)Ajoute un élément de configuration à la collection d'éléments de configuration.
Méthode protégéeBaseClearSupprime tous les objets d'élément de configuration de la collection.
Méthode protégéeBaseGet(Int32)Obtient l'élément de configuration à l'emplacement d'index spécifié.
Méthode protégéeBaseGet(Object)Retourne l'élément de configuration avec la clé spécifiée.
Méthode protégéeBaseGetAllKeysRetourne un tableau des clés pour tous les éléments de configuration contenus dans ConfigurationElementCollection.
Méthode protégéeBaseGetKeyObtient la clé pour le ConfigurationElement à l'emplacement d'index spécifié.
Méthode protégéeBaseIndexOfIndique l'index de l'élément ConfigurationElement spécifié.
Méthode protégéeBaseIsRemovedIndique si l'élément ConfigurationElement avec la clé spécifiée a été supprimé de la collection ConfigurationElementCollection.
Méthode protégéeBaseRemoveSupprime un ConfigurationElement de la collection.
Méthode protégéeBaseRemoveAtSupprime le ConfigurationElement à l'emplacement d'index spécifié.
Méthode publiqueCopyToCopie le contenu de ConfigurationElementCollection dans un tableau.
Méthode protégéeCreateNewElement()En cas de substitution dans une classe dérivée, crée ConfigurationElement.
Méthode protégéeCreateNewElement(String)Crée un nouveau ConfigurationElement en cas de substitution dans une classe dérivée.
Méthode protégéeDeserializeElementLit le langage XML dans le fichier de configuration. (Hérité de ConfigurationElement.)
Méthode publiqueEqualsCompare ConfigurationElementCollection avec l'objet spécifié. (Substitue ConfigurationElement.Equals(Object).)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode protégéeGetElementKeyObtient la clé d'élément pour un élément de configuration spécifié en cas de substitution dans une classe dérivée.
Méthode publiqueGetEnumeratorInfrastructure. Obtient un IEnumerator utilisé pour itérer au sein de ConfigurationElementCollection.
Méthode publiqueGetHashCodeObtient une valeur unique représentant l'instance de ConfigurationElementCollection. (Substitue ConfigurationElement.GetHashCode().)
Méthode protégéeGetTransformedAssemblyStringRetourne la version transformée du nom de l'assembly spécifié. (Hérité de ConfigurationElement.)
Méthode protégéeGetTransformedTypeStringRetourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeInitRétablit l'état initial de l'objet ConfigurationElement. (Hérité de ConfigurationElement.)
Méthode protégéeInitializeDefaultUtilisé pour initialiser un jeu de valeurs par défaut pour l'objet ConfigurationElement. (Hérité de ConfigurationElement.)
Méthode protégéeIsElementNameIndique si le ConfigurationElement spécifié existe dans ConfigurationElementCollection.
Méthode protégéeIsElementRemovableIndique si l'élément ConfigurationElement spécifié peut être supprimée de la collection ConfigurationElementCollection.
Méthode protégéeIsModifiedIndique si cette ConfigurationElementCollection a été modifiée depuis son dernier enregistrement ou chargement en cas de substitution dans une classe dérivée. (Substitue ConfigurationElement.IsModified().)
Méthode publiqueIsReadOnlyIndique si l'objet ConfigurationElementCollection est en lecture seule. (Substitue ConfigurationElement.IsReadOnly().)
Méthode protégéeListErrorsAjoute les erreurs de propriété non valide dans cet objet ConfigurationElement et dans tous les sous-éléments à la liste passée. (Hérité de ConfigurationElement.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnDeserializeUnrecognizedAttributeObtient une valeur indiquant si un attribut inconnu est rencontré pendant la désérialisation. (Hérité de ConfigurationElement.)
Méthode protégéeOnDeserializeUnrecognizedElementFait en sorte que le système de configuration lève une exception. (Substitue ConfigurationElement.OnDeserializeUnrecognizedElement(String, XmlReader).)
Méthode protégéeOnRequiredPropertyNotFoundLève une exception lorsqu'une propriété requise est introuvable. (Hérité de ConfigurationElement.)
Méthode protégéePostDeserializeAppelé après la désérialisation. (Hérité de ConfigurationElement.)
Méthode protégéePreSerializeAppelé avant la sérialisation. (Hérité de ConfigurationElement.)
Méthode protégéeResetRéinitialise ConfigurationElementCollection à son état non modifié en cas de substitution dans une classe dérivée. (Substitue ConfigurationElement.Reset(ConfigurationElement).)
Méthode protégéeResetModifiedRéinitialise la valeur de la propriété IsModified à false en cas de substitution dans une classe dérivée. (Substitue ConfigurationElement.ResetModified().)
Méthode protégéeSerializeElementÉcrit les données de configuration d'un élément XML dans le fichier de configuration en cas de substitution dans une classe dérivée. (Substitue ConfigurationElement.SerializeElement(XmlWriter, Boolean).)
Méthode protégéeSerializeToXmlElementÉcrit les balises extérieures de cet élément de configuration dans le fichier de configuration lorsqu'il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement.)
Méthode protégéeSetPropertyValueAffecte la valeur spécifiée à une propriété. (Hérité de ConfigurationElement.)
Méthode protégéeSetReadOnlyInfrastructure. Définit la propriété IsReadOnly pour l'objet ConfigurationElementCollection et pour tous les sous-éléments. (Substitue ConfigurationElement.SetReadOnly().)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode protégéeUnmergeInfrastructure. Inverse l'effet de fusion des informations de configuration de différents niveaux de la hiérarchie de configuration. (Substitue ConfigurationElement.Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode).)
Début

  NomDescription
Méthode d'extension publiqueAsParallelActive la parallélisation d'une requête. (Défini par ParallelEnumerable.)
Méthode d'extension publiqueAsQueryableConvertit un IEnumerable en IQueryable. (Défini par Queryable.)
Méthode d'extension publiqueCast<TResult>Effectue un cast des éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.)
Méthode d'extension publiqueOfType<TResult>Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICollection.CopyToCopie ConfigurationElementCollection dans un tableau.
Début

Le ConfigurationElementCollection représente une collection d'éléments dans un fichier de configuration.

RemarqueRemarque

Un élément dans un fichier de configuration fait référence à un élément XML de base ou à une section. Un élément simple est une balise XML avec des attributs connexes, le cas échéant. Un élément simple constitue une section. Les sections complexes peuvent contenir un ou plusieurs éléments simples, une collection d'éléments et d'autres sections.

Vous utilisez ConfigurationElementCollection pour travailler avec une collection d'objets ConfigurationElement. Implémentez cette classe pour ajouter des collections d'éléments ConfigurationElement personnalisés à ConfigurationSection.

Remarques à l'attention des implémenteurs

Vous pouvez utiliser un modèle de codage déclaratif (attribué) ou de programmation pour créer un élément de configuration personnalisé.

Le modèle de programmation exige que pour chaque attribut d'élément vous créiez une propriété pour obtenir et définir sa valeur et que vous l'ajoutiez au sac de propriétés internes de la classe de base ConfigurationElement sous-jacente.

Le modèle déclaratif, également connu sous le nom de modèle attribué, vous permet de définir un attribut d'élément en utilisant une propriété et en la configurant avec des attributs. Ces attributs donnent au système de configuration ASP.NET des informations sur les types de propriété et leurs valeurs par défaut. ASP.NET peut utiliser la réflexion pour obtenir ces informations, puis créer les objets de propriété d'élément et effectuer l'initialisation requise.

L'exemple suivant montre comment utiliser ConfigurationCollectionElement.

Le premier exemple se compose de trois classes : UrlsSection, UrlsCollection et UrlsSection.La classe UrlConfigElement utilise le ConfigurationCollectionAttribute pour définir une section de configuration personnalisée. Cette section contient une collection d'URL (définie par la classe UrlsCollection ) d'éléments URL (définis par la classe UrlConfigElement ).

Ce deuxième exemple de code utilise les classes spécifiées auparavant. Vous combinez ces deux exemples dans un projet d'application console.

Lorsque vous exécutez l'application console, une instance de la classe UrlsSection est créée et les éléments de configuration suivants sont générés dans le fichier de configuration de l'application :

<configuration>
    <configSections>
        <section name="MyUrls" type="UrlsSection, 
          ConfigurationElementCollection, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
    </configSections>
    <MyUrls>
        <urls>
           <add name="Contoso" url="http://www.contoso.com" port="4040 />
        </urls>
    </MyUrls>
</configuration

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

System.Object
  System.Configuration.ConfigurationElement
    System.Configuration.ConfigurationElementCollection
      System.Configuration.ConnectionStringSettingsCollection
      System.Configuration.KeyValueConfigurationCollection
      System.Configuration.NameValueConfigurationCollection
      System.Configuration.ProviderSettingsCollection
      System.Configuration.SchemeSettingElementCollection
      System.Configuration.SettingElementCollection
      System.IdentityModel.Configuration.AudienceUriElementCollection
      System.IdentityModel.Configuration.IdentityConfigurationElementCollection
      System.IdentityModel.Configuration.SecurityTokenHandlerElementCollection
      System.IdentityModel.Configuration.SecurityTokenHandlerSetElementCollection
      System.IdentityModel.Services.Configuration.FederationConfigurationElementCollection
      System.Net.Configuration.AuthenticationModuleElementCollection
      System.Net.Configuration.BypassElementCollection
      System.Net.Configuration.ConnectionManagementElementCollection
      System.Net.Configuration.WebRequestModuleElementCollection
      System.Runtime.Caching.Configuration.MemoryCacheSettingsCollection
      System.Runtime.Serialization.Configuration.DeclaredTypeElementCollection
      System.Runtime.Serialization.Configuration.ParameterElementCollection
      System.Runtime.Serialization.Configuration.TypeElementCollection
      System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElementCollection
      System.ServiceModel.Activities.Tracking.Configuration.TrackingConfigurationCollection<TConfigurationElement>
      System.ServiceModel.Configuration.ServiceModelConfigurationElementCollection<ConfigurationElementType>
      System.ServiceModel.Routing.Configuration.BackupEndpointCollection
      System.ServiceModel.Routing.Configuration.BackupListCollection
      System.ServiceModel.Routing.Configuration.FilterElementCollection
      System.ServiceModel.Routing.Configuration.FilterTableCollection
      System.ServiceModel.Routing.Configuration.FilterTableEntryCollection
      System.ServiceModel.Routing.Configuration.NamespaceElementCollection
      System.Web.Configuration.AssemblyCollection
      System.Web.Configuration.AuthorizationRuleCollection
      System.Web.Configuration.BufferModesCollection
      System.Web.Configuration.BuildProviderCollection
      System.Web.Configuration.ClientTargetCollection
      System.Web.Configuration.CodeSubDirectoriesCollection
      System.Web.Configuration.CompilerCollection
      System.Web.Configuration.ConvertersCollection
      System.Web.Configuration.CustomErrorCollection
      System.Web.Configuration.EventMappingSettingsCollection
      System.Web.Configuration.ExpressionBuilderCollection
      System.Web.Configuration.FolderLevelBuildProviderCollection
      System.Web.Configuration.FormsAuthenticationUserCollection
      System.Web.Configuration.FullTrustAssemblyCollection
      System.Web.Configuration.HttpHandlerActionCollection
      System.Web.Configuration.HttpModuleActionCollection
      System.Web.Configuration.IgnoreDeviceFilterElementCollection
      System.Web.Configuration.NamespaceCollection
      System.Web.Configuration.OutputCacheProfileCollection
      System.Web.Configuration.PartialTrustVisibleAssemblyCollection
      System.Web.Configuration.ProfileGroupSettingsCollection
      System.Web.Configuration.ProfilePropertySettingsCollection
      System.Web.Configuration.ProfileSettingsCollection
      System.Web.Configuration.ProtocolCollection
      System.Web.Configuration.RuleSettingsCollection
      System.Web.Configuration.SqlCacheDependencyDatabaseCollection
      System.Web.Configuration.TagMapCollection
      System.Web.Configuration.TagPrefixCollection
      System.Web.Configuration.TransformerInfoCollection
      System.Web.Configuration.TrustLevelCollection
      System.Web.Configuration.UrlMappingCollection
      System.Web.Mobile.DeviceFilterElementCollection
      System.Web.Services.Configuration.ProtocolElementCollection
      System.Web.Services.Configuration.SoapExtensionTypeElementCollection
      System.Web.Services.Configuration.TypeElementCollection
      System.Web.Services.Configuration.WsiProfilesElementCollection
      System.Web.UI.MobileControls.ControlElementCollection
      System.Web.UI.MobileControls.DeviceElementCollection
      System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElementCollection
      System.Xml.Serialization.Configuration.SchemaImporterExtensionElementCollection

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft