Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ConfigurationElementCollection classe

 

Date de publication : novembre 2016

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

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

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

public abstract class ConfigurationElementCollection : ConfigurationElement, 
	ICollection, IEnumerable

NomDescription
System_CAPS_protmethodConfigurationElementCollection()

Initialise une nouvelle instance de la classe ConfigurationElementCollection.

System_CAPS_protmethodConfigurationElementCollection(IComparer)

Crée une instance de la classe ConfigurationElementCollection.

NomDescription
System_CAPS_protpropertyAddElementName

Obtient ou définit le nom de le ConfigurationElement à associer à l’opération d’ajout dans la ConfigurationElementCollection en cas de substitution dans une classe dérivée.

System_CAPS_protpropertyClearElementName

Obtient ou définit le nom de le ConfigurationElement à associer à l’opération d’effacement dans le ConfigurationElementCollection en cas de substitution dans une classe dérivée.

System_CAPS_pubpropertyCollectionType

Obtient le type de ConfigurationElementCollection.

System_CAPS_pubpropertyCount

Obtient le nombre d’éléments de la collection.

System_CAPS_pubpropertyCurrentConfiguration

Obtient une référence à un niveau supérieur Configuration instance qui représente la hiérarchie de configuration qui actuel ConfigurationElement instance appartient.(Hérité de ConfigurationElement.)

System_CAPS_pubpropertyElementInformation

Obtient un ElementInformation objet qui contient les informations non personnalisables de la ConfigurationElement objet.(Hérité de ConfigurationElement.)

System_CAPS_protpropertyElementName

Obtient 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.

System_CAPS_protpropertyElementProperty

Obtient le ConfigurationElementProperty objet qui représente le ConfigurationElement objet lui-même.(Hérité de ConfigurationElement.)

System_CAPS_pubpropertyEmitClear

Obtient ou définit une valeur qui indique si la collection a été effacée.

System_CAPS_protpropertyEvaluationContext

Obtient l'objet ContextInformation pour l'objet ConfigurationElement.(Hérité de ConfigurationElement.)

System_CAPS_protpropertyHasContext

Obtient une valeur qui indique si le CurrentConfiguration propriété est null.(Hérité de ConfigurationElement.)

System_CAPS_pubpropertyIsSynchronized

Obtient une valeur indiquant si l’accès à la collection est synchronisé.

System_CAPS_protpropertyItem[ConfigurationProperty]

Obtient ou définit une propriété ou un attribut de cet élément de configuration.(Hérité de ConfigurationElement.)

System_CAPS_protpropertyItem[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.)

System_CAPS_pubpropertyLockAllAttributesExcept

Obtient la collection d’attributs verrouillés.(Hérité de ConfigurationElement.)

System_CAPS_pubpropertyLockAllElementsExcept

Obtient la collection d’éléments verrouillés.(Hérité de ConfigurationElement.)

System_CAPS_pubpropertyLockAttributes

Obtient la collection d’attributs verrouillés (Hérité de ConfigurationElement.)

System_CAPS_pubpropertyLockElements

Obtient la collection d’éléments verrouillés.(Hérité de ConfigurationElement.)

System_CAPS_pubpropertyLockItem

Obtient ou définit une valeur indiquant si l’élément est verrouillé.(Hérité de ConfigurationElement.)

System_CAPS_protpropertyProperties

Obtient la collection de propriétés.(Hérité de ConfigurationElement.)

System_CAPS_protpropertyRemoveElementName

Obtient ou définit le nom de le ConfigurationElement à associer à l’opération de suppression dans la ConfigurationElementCollection en cas de substitution dans une classe dérivée.

System_CAPS_pubpropertySyncRoot

Obtient un objet utilisé pour synchroniser l’accès à la ConfigurationElementCollection.

System_CAPS_protpropertyThrowOnDuplicate

Obtient une valeur indiquant si une tentative d'ajout d'un ConfigurationElement dupliqué à ConfigurationElementCollection provoquera la levée d'une exception.

NomDescription
System_CAPS_protmethodBaseAdd(ConfigurationElement)

Ajoute un élément de configuration à ConfigurationElementCollection.

System_CAPS_protmethodBaseAdd(ConfigurationElement, Boolean)

Ajoute un élément de configuration à la collection d’éléments de configuration.

System_CAPS_protmethodBaseAdd(Int32, ConfigurationElement)

Ajoute un élément de configuration à la collection d’éléments de configuration.

System_CAPS_protmethodBaseClear()

Supprime tous les objets d’élément de configuration de la collection.

System_CAPS_protmethodBaseGet(Int32)

Obtient l’élément de configuration à l’emplacement de l’index spécifié.

System_CAPS_protmethodBaseGet(Object)

Retourne l’élément de configuration avec la clé spécifiée.

System_CAPS_protmethodBaseGetAllKeys()

Retourne un tableau des clés pour tous les éléments de configuration contenus dans le ConfigurationElementCollection.

System_CAPS_protmethodBaseGetKey(Int32)

Obtient la clé pour le ConfigurationElement à l’index spécifié.

System_CAPS_protmethodBaseIndexOf(ConfigurationElement)

Indique l’index de l’objet ConfigurationElement.

System_CAPS_protmethodBaseIsRemoved(Object)

Indique si le ConfigurationElement avec la clé spécifiée a été supprimé de la ConfigurationElementCollection.

System_CAPS_protmethodBaseRemove(Object)

Supprime un ConfigurationElement à partir de la collection.

System_CAPS_protmethodBaseRemoveAt(Int32)

Supprime la ConfigurationElement à l’index spécifié.

System_CAPS_pubmethodCopyTo(ConfigurationElement[], Int32)

Copie le contenu de la ConfigurationElementCollection dans un tableau.

System_CAPS_protmethodCreateNewElement()

En cas de substitution dans une classe dérivée, crée ConfigurationElement.

System_CAPS_protmethodCreateNewElement(String)

Crée un ConfigurationElement en cas de substitution dans une classe dérivée.

System_CAPS_protmethodDeserializeElement(XmlReader, Boolean)

Lit du XML à partir du fichier de configuration.(Hérité de ConfigurationElement.)

System_CAPS_pubmethodEquals(Object)

Compare le ConfigurationElementCollection à l’objet spécifié.(Remplace ConfigurationElement.Equals(Object).)

System_CAPS_protmethodFinalize()

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.)

System_CAPS_protmethodGetElementKey(ConfigurationElement)

Obtient la clé de l’élément pour un élément de configuration spécifié en cas de substitution dans une classe dérivée.

System_CAPS_pubmethodGetEnumerator()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Obtient un IEnumerator qui est utilisé pour itérer au sein du ConfigurationElementCollection.

System_CAPS_pubmethodGetHashCode()

Obtient une valeur unique représentant le ConfigurationElementCollection instance.(Remplace ConfigurationElement.GetHashCode().)

System_CAPS_protmethodGetTransformedAssemblyString(String)

Retourne la version transformée du nom de l’assembly spécifié.(Hérité de ConfigurationElement.)

System_CAPS_protmethodGetTransformedTypeString(String)

Retourne la version transformée du nom de type spécifié.(Hérité de ConfigurationElement.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodInit()

Définit le ConfigurationElement objet à son état initial.(Hérité de ConfigurationElement.)

System_CAPS_protmethodInitializeDefault()

Utilisé pour initialiser un jeu de valeurs pour le ConfigurationElement objet.(Hérité de ConfigurationElement.)

System_CAPS_protmethodIsElementName(String)

Indique si le texte spécifié ConfigurationElement existe dans le ConfigurationElementCollection.

System_CAPS_protmethodIsElementRemovable(ConfigurationElement)

Indique si le texte spécifié ConfigurationElement peuvent être supprimés de la ConfigurationElementCollection.

System_CAPS_protmethodIsModified()

Indique si cette ConfigurationElementCollection a été modifié depuis son dernier enregistrement ou chargé en cas de substitution dans une classe dérivée.(Remplace ConfigurationElement.IsModified().)

System_CAPS_pubmethodIsReadOnly()

Indique si le ConfigurationElementCollection objet est en lecture seule.(Remplace ConfigurationElement.IsReadOnly().)

System_CAPS_protmethodListErrors(IList)

Ajoute les erreurs de propriété non valide dans ce ConfigurationElement objet et dans tous les sous-éléments à la liste passée.(Hérité de ConfigurationElement.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnDeserializeUnrecognizedAttribute(String, String)

Obtient une valeur indiquant si un attribut inconnu est rencontré pendant la désérialisation.(Hérité de ConfigurationElement.)

System_CAPS_protmethodOnDeserializeUnrecognizedElement(String, XmlReader)

Amène le système de configuration lève une exception.(Remplace ConfigurationElement.OnDeserializeUnrecognizedElement(String, XmlReader).)

System_CAPS_protmethodOnRequiredPropertyNotFound(String)

Lève une exception lorsqu’une propriété requise est introuvable.(Hérité de ConfigurationElement.)

System_CAPS_protmethodPostDeserialize()

Appelé après la désérialisation.(Hérité de ConfigurationElement.)

System_CAPS_protmethodPreSerialize(XmlWriter)

Appelé avant la sérialisation.(Hérité de ConfigurationElement.)

System_CAPS_protmethodReset(ConfigurationElement)

Réinitialise le ConfigurationElementCollection à son état non modifié en cas de substitution dans une classe dérivée.(Remplace ConfigurationElement.Reset(ConfigurationElement).)

System_CAPS_protmethodResetModified()

Réinitialise la valeur de la propriété IsModified à false en cas de substitution dans une classe dérivée.(Remplace ConfigurationElement.ResetModified().)

System_CAPS_protmethodSerializeElement(XmlWriter, Boolean)

Écrit les données de configuration dans un élément XML dans le fichier de configuration en cas de substitution dans une classe dérivée.(Remplace ConfigurationElement.SerializeElement(XmlWriter, Boolean).)

System_CAPS_protmethodSerializeToXmlElement(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.)

System_CAPS_protmethodSetPropertyValue(ConfigurationProperty, Object, Boolean)

Définit une propriété à la valeur spécifiée.(Hérité de ConfigurationElement.)

System_CAPS_protmethodSetReadOnly()

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Définit le IsReadOnly propriété pour la ConfigurationElementCollection objet et pour tous les sous-éléments.(Remplace ConfigurationElement.SetReadOnly().)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodUnmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Inverse l’effet de fusion des informations de configuration de différents niveaux de la hiérarchie de configuration (Remplace ConfigurationElement.Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode).)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Copie le ConfigurationElementCollection dans un tableau.

NomDescription
System_CAPS_pubmethodAsParallel()

Surchargé. Active la parallélisation d'une requête.(Défini par ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Surchargé. Convertit un IEnumerable à un IQueryable.(Défini par Queryable.)

System_CAPS_pubmethodCast<TResult>()

Convertit les éléments d’un IEnumerable au type spécifié.(Défini par Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtre les éléments d’un IEnumerable basé sur un type spécifié.(Défini par Enumerable.)

The T:System.Configuration.ConfigurationElementCollection represents a collection of elements within a configuration file.

System_CAPS_noteRemarque

An element within a configuration file refers to a basic XML element or a section. A simple element is an XML tag with related attributes, if any. A simple element constitutes a section. Complex sections can contain one or more simple elements, a collection of elements, and other sections.

You use the T:System.Configuration.ConfigurationElementCollection to work with a collection of T:System.Configuration.ConfigurationElement objects. Implement this class to add collections of custom T:System.Configuration.ConfigurationElement elements to a T:System.Configuration.ConfigurationSection.

Remarques à l’attention des implémenteurs :

You can use a programmatic or a declarative (attributed) coding model to create a custom configuration element.

The programmatic model requires that for each element attribute you create a property to get and set its value, and that you add it to the internal property bag of the underlying T:System.Configuration.ConfigurationElement base class.

The declarative model, also referred to as the attributed model, allows you to define an element attribute by using a property and configuring it with attributes. These attributes instruct the ASP.NET configuration system about the property types and their default values. ASP.NET can use reflection to obtain this information and then create the element property objects and perform the required initialization.

The following example shows how to use the T:System.Configuration.ConfigurationElementCollection.

The first example consists of three classes: UrlsSection, UrlsCollection and UrlConfigElement.The UrlsSection class uses the T:System.Configuration.ConfigurationCollectionAttribute to define a custom configuration section. This section contains a URL collection (defined by the UrlsCollection class) of URL elements (defined by the UrlConfigElement class).

using System;
using System.Configuration;

// Define a UrlsSection custom section that contains a 
// UrlsCollection collection of UrlConfigElement elements.
public class UrlsSection : ConfigurationSection
{

    // Declare the UrlsCollection collection property.
    [ConfigurationProperty("urls", IsDefaultCollection = false)]
    [ConfigurationCollection(typeof(UrlsCollection),
        AddItemName = "add",
        ClearItemsName = "clear",
        RemoveItemName = "remove")]
    public UrlsCollection Urls
    {
        get
        {
            UrlsCollection urlsCollection =
                (UrlsCollection)base["urls"];

            return urlsCollection;
        }

        set
        {
            UrlsCollection urlsCollection = value;
        }

    }

    // Create a new instance of the UrlsSection.
    // This constructor creates a configuration element 
    // using the UrlConfigElement default values.
    // It assigns this element to the collection.
    public UrlsSection()
    {
        UrlConfigElement url = new UrlConfigElement();
        Urls.Add(url);

    }

}

// Define the UrlsCollection that contains the 
// UrlsConfigElement elements.
// This class shows how to use the ConfigurationElementCollection.
public class UrlsCollection : ConfigurationElementCollection
{


    public UrlsCollection()
    {

    }

    public override ConfigurationElementCollectionType CollectionType
    {
        get
        {
            return ConfigurationElementCollectionType.AddRemoveClearMap;
        }
    }

    protected override ConfigurationElement CreateNewElement()
    {
        return new UrlConfigElement();
    }

    protected override Object GetElementKey(ConfigurationElement element)
    {
        return ((UrlConfigElement)element).Name;
    }

    public UrlConfigElement this[int index]
    {
        get
        {
            return (UrlConfigElement)BaseGet(index);
        }
        set
        {
            if (BaseGet(index) != null)
            {
                BaseRemoveAt(index);
            }
            BaseAdd(index, value);
        }
    }

    new public UrlConfigElement this[string Name]
    {
        get
        {
            return (UrlConfigElement)BaseGet(Name);
        }
    }


    public int IndexOf(UrlConfigElement url)
    {
        return BaseIndexOf(url);
    }

    public void Add(UrlConfigElement url)
    {
        BaseAdd(url);

        // Your custom code goes here.

    }

    protected override void BaseAdd(ConfigurationElement element)
    {
        BaseAdd(element, false);

        // Your custom code goes here.

    }

    public void Remove(UrlConfigElement url)
    {
        if (BaseIndexOf(url) >= 0)
        {
            BaseRemove(url.Name);
            // Your custom code goes here.
            Console.WriteLine("UrlsCollection: {0}", "Removed collection element!");
        }
    }

    public void RemoveAt(int index)
    {
        BaseRemoveAt(index);

        // Your custom code goes here.

    }

    public void Remove(string name)
    {
        BaseRemove(name);

        // Your custom code goes here.

    }

    public void Clear()
    {
        BaseClear();

        // Your custom code goes here.
        Console.WriteLine("UrlsCollection: {0}", "Removed entire collection!");
    }

}

// Define the UrlsConfigElement elements that are contained 
// by the UrlsCollection.
public class UrlConfigElement : ConfigurationElement
{
    public UrlConfigElement(String name, String url, int port)
    {
        this.Name = name;
        this.Url = url;
        this.Port = port;
    }

    public UrlConfigElement()
    {

    }

    [ConfigurationProperty("name", DefaultValue = "Contoso",
        IsRequired = true, IsKey = true)]
    public string Name
    {
        get
        {
            return (string)this["name"];
        }
        set
        {
            this["name"] = value;
        }
    }

    [ConfigurationProperty("url", DefaultValue = "http://www.contoso.com",
        IsRequired = true)]
    [RegexStringValidator(@"\w+:\/\/[\w.]+\S*")]
    public string Url
    {
        get
        {
            return (string)this["url"];
        }
        set
        {
            this["url"] = value;
        }
    }

    [ConfigurationProperty("port", DefaultValue = (int)4040, IsRequired = false)]
    [IntegerValidator(MinValue = 0, MaxValue = 8080, ExcludeRange = false)]
    public int Port
    {
        get
        {
            return (int)this["port"];
        }
        set
        {
            this["port"] = value;
        }
    }

}

This second code example uses the classes specified before. You combine these two examples in a console application project.

using System;
using System.Configuration;
using System.Text;

class UsingConfigurationCollectionElement
{

    // Create a custom section and save it in the 
    // application configuration file.
    static void CreateCustomSection()
    {
        try
        {

            // Get the current configuration file.
            System.Configuration.Configuration config =
                    ConfigurationManager.OpenExeConfiguration(
                    ConfigurationUserLevel.None);

            // Add the custom section to the application
            // configuration file.
            UrlsSection myUrlsSection = (UrlsSection)config.Sections["MyUrls"];

            if (myUrlsSection == null)
            {
                //  The configuration file does not contain the
                // custom section yet. Create it.
                myUrlsSection = new UrlsSection();

                config.Sections.Add("MyUrls", myUrlsSection);

                // Save the application configuration file.
                myUrlsSection.SectionInformation.ForceSave = true;
                config.Save(ConfigurationSaveMode.Modified); 
            }
            else
                if (myUrlsSection.Urls.Count == 0)
                {

                    // The configuration file contains the
                    // custom section but its element collection is empty.
                    // Initialize the collection. 
                    UrlConfigElement url = new UrlConfigElement();
                    myUrlsSection.Urls.Add(url);

                    // Save the application configuration file.
                    myUrlsSection.SectionInformation.ForceSave = true;
                    config.Save(ConfigurationSaveMode.Modified);
                }


            Console.WriteLine("Created custom section in the application configuration file: {0}",
                config.FilePath);
            Console.WriteLine();

        }
        catch (ConfigurationErrorsException err)
        {
            Console.WriteLine("CreateCustomSection: {0}", err.ToString());
        }

    }

    static void ReadCustomSection()
    {
        try
        {
            // Get the application configuration file.
            System.Configuration.Configuration config =
                    ConfigurationManager.OpenExeConfiguration(
                    ConfigurationUserLevel.None) as Configuration;

            // Read and display the custom section.
            UrlsSection myUrlsSection =
               config.GetSection("MyUrls") as UrlsSection;

            if (myUrlsSection == null)
                Console.WriteLine("Failed to load UrlsSection.");
            else
            {
                Console.WriteLine("Collection elements contained in the custom section collection:");
                for (int i = 0; i < myUrlsSection.Urls.Count; i++)
                {
                    Console.WriteLine("   Name={0} URL={1} Port={2}",
                        myUrlsSection.Urls[i].Name,
                        myUrlsSection.Urls[i].Url,
                        myUrlsSection.Urls[i].Port);
                }
            }

        }
        catch (ConfigurationErrorsException err)
        {
            Console.WriteLine("ReadCustomSection(string): {0}", err.ToString());
        }

    }

    // Add an element to the custom section collection.
    // This function uses the ConfigurationCollectionElement Add method.
    static void AddCollectionElement()
    {
        try
        {

            // Get the current configuration file.
            System.Configuration.Configuration config =
                    ConfigurationManager.OpenExeConfiguration(
                    ConfigurationUserLevel.None);


            // Get the custom configuration section.
            UrlsSection myUrlsSection = config.GetSection("MyUrls") as UrlsSection;


            // Add the element to the collection in the custom section.
            if (config.Sections["MyUrls"] != null)
            {
                UrlConfigElement urlElement = new UrlConfigElement();
                urlElement.Name = "Microsoft";
                urlElement.Url = "http://www.microsoft.com";
                urlElement.Port = 8080;

                // Use the ConfigurationCollectionElement Add method
                // to add the new element to the collection.
                myUrlsSection.Urls.Add(urlElement);


                // Save the application configuration file.
                myUrlsSection.SectionInformation.ForceSave = true;
                config.Save(ConfigurationSaveMode.Modified);


                Console.WriteLine("Added collection element to the custom section in the configuration file: {0}",
                    config.FilePath);
                Console.WriteLine();
            }
            else
                Console.WriteLine("You must create the custom section first.");

        }
        catch (ConfigurationErrorsException err)
        {
            Console.WriteLine("AddCollectionElement: {0}", err.ToString());
        }

    }

    // Remove element from the custom section collection.
    // This function uses one of the ConfigurationCollectionElement 
    // overloaded Remove methods.
    static void RemoveCollectionElement()
    {
        try
        {

            // Get the current configuration file.
            System.Configuration.Configuration config =
                    ConfigurationManager.OpenExeConfiguration(
                    ConfigurationUserLevel.None);


            // Get the custom configuration section.
            UrlsSection myUrlsSection = config.GetSection("MyUrls") as UrlsSection;


            // Remove the element from the custom section.
            if (config.Sections["MyUrls"] != null)
            {
                UrlConfigElement urlElement = new UrlConfigElement();
                urlElement.Name = "Microsoft";
                urlElement.Url = "http://www.microsoft.com";
                urlElement.Port = 8080;

                // Use one of the ConfigurationCollectionElement Remove 
                // overloaded methods to remove the element from the collection.
                myUrlsSection.Urls.Remove(urlElement);


                // Save the application configuration file.
                myUrlsSection.SectionInformation.ForceSave = true;
                config.Save(ConfigurationSaveMode.Full);


                Console.WriteLine("Removed collection element from he custom section in the configuration file: {0}",
                    config.FilePath);
                Console.WriteLine();
            }
            else
                Console.WriteLine("You must create the custom section first.");

        }
        catch (ConfigurationErrorsException err)
        {
            Console.WriteLine("RemoveCollectionElement: {0}", err.ToString());
        }

    }

    // Remove the collection of elements from the custom section.
    // This function uses the ConfigurationCollectionElement Clear method.
    static void ClearCollectionElements()
    {
        try
        {

            // Get the current configuration file.
            System.Configuration.Configuration config =
                    ConfigurationManager.OpenExeConfiguration(
                    ConfigurationUserLevel.None);


            // Get the custom configuration section.
            UrlsSection myUrlsSection = config.GetSection("MyUrls") as UrlsSection;


            // Remove the collection of elements from the section.
            if (config.Sections["MyUrls"] != null)
            {
                myUrlsSection.Urls.Clear();


                // Save the application configuration file.
                myUrlsSection.SectionInformation.ForceSave = true;
                config.Save(ConfigurationSaveMode.Full);


                Console.WriteLine("Removed collection of elements from he custom section in the configuration file: {0}",
                    config.FilePath);
                Console.WriteLine();
            }
            else
                Console.WriteLine("You must create the custom section first.");

        }
        catch (ConfigurationErrorsException err)
        {
            Console.WriteLine("ClearCollectionElements: {0}", err.ToString());
        }

    }

    public static void UserMenu()
    {
        string applicationName =
           Environment.GetCommandLineArgs()[0] + ".exe";
        StringBuilder buffer = new StringBuilder();

        buffer.AppendLine("Application: " + applicationName);
        buffer.AppendLine("Make your selection.");
        buffer.AppendLine("?    -- Display help.");
        buffer.AppendLine("Q,q  -- Exit the application.");
        buffer.Append("1    -- Create a custom section that");
        buffer.AppendLine(" contains a collection of elements.");
        buffer.Append("2    -- Read the custom section that");
        buffer.AppendLine(" contains a collection of custom elements.");
        buffer.Append("3    -- Add a collection element to");
        buffer.AppendLine(" the custom section.");
        buffer.Append("4    -- Remove a collection element from");
        buffer.AppendLine(" the custom section.");
        buffer.Append("5    -- Clear the collection of elements from");
        buffer.AppendLine(" the custom section.");

        Console.Write(buffer.ToString());
    }

    // Obtain user's input and provide
    // feedback.
    static void Main(string[] args)
    {
        // Define user selection string.
        string selection;

        // Get the name of the application.
        string appName =
          Environment.GetCommandLineArgs()[0];

        // Get user selection.
        while (true)
        {

            UserMenu();
            Console.Write("> ");
            selection = Console.ReadLine();
            if (selection != string.Empty)
                break;
        }

        while (selection.ToLower() != "q")
        {
            // Process user's input.
            switch (selection)
            {
                case "1":
                    // Create a custom section and save it in the 
                    // application configuration file.
                    CreateCustomSection();
                    break;

                case "2":
                    // Read the custom section from the
                    // application configuration file.
                    ReadCustomSection();
                    break;

                case "3":
                    // Add a collection element to the
                    // custom section.
                    AddCollectionElement();
                    break;

                case "4":
                    // Remove a collection element from the
                    // custom section.
                    RemoveCollectionElement();
                    break;

                case "5":
                    // Clear the collection of elements from the
                    // custom section.
                    ClearCollectionElements();
                    break;

                default:
                    UserMenu();
                    break;
            }
            Console.Write("> ");
            selection = Console.ReadLine();
        }
    }
}

When you run the console application, an instance of the UrlsSection class is created and the following configuration elements are generated in the application configuration file:

<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
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: