ConfigurationLockCollection Classe

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationLockCollection.cs

Contient une collection d'objets de configuration verrouillés. Cette classe ne peut pas être héritée.

C#

public sealed class ConfigurationLockCollection : System.Collections.ICollection

Héritage

Object

ConfigurationLockCollection

Implémente

ICollection IEnumerable

Exemples

L’exemple de code suivant montre comment utiliser le ConfigurationLockCollection type .

C#

#region Using directives

using System;
using System.Configuration;
using System.Web.Configuration;
using System.Collections;
using System.Text;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingConfigurationLockCollection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config =
          WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        AnonymousIdentificationSection configSection =
          (AnonymousIdentificationSection)config.GetSection
          ("system.web/anonymousIdentification");

        // Display title and info.
        Console.WriteLine("Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);
        Console.WriteLine();

        // Create a ConfigurationLockCollection object.
        ConfigurationLockCollection lockedAttribList;
        lockedAttribList = configSection.LockAttributes;

        // Add an attribute to the lock collection.
        if (!lockedAttribList.Contains("enabled"))
        {
          lockedAttribList.Add("enabled");
        }
        if (!lockedAttribList.Contains("cookieless"))
        {
          lockedAttribList.Add("cookieless");
        }

        // Count property.
        Console.WriteLine("Collection Count: {0}",
         lockedAttribList.Count);

        // AttributeList method.
        Console.WriteLine("AttributeList: {0}",
         lockedAttribList.AttributeList);

        // Contains method.
        Console.WriteLine("Contains 'enabled': {0}",
         lockedAttribList.Contains("enabled"));

        // HasParentElements property.
        Console.WriteLine("HasParentElements: {0}",
         lockedAttribList.HasParentElements);

        // IsModified property.
        Console.WriteLine("IsModified: {0}",
         lockedAttribList.IsModified);

        // IsReadOnly method. 
        Console.WriteLine("IsReadOnly: {0}",
         lockedAttribList.IsReadOnly("enabled"));

        // Remove a configuration object 
        // from the collection.
        lockedAttribList.Remove("cookieless");

        // Clear the collection.
        lockedAttribList.Clear();

        // Create an ArrayList to contain
        // the property items of the configuration
        // section.
        ArrayList configPropertyAL = new ArrayList(lockedAttribList.Count);
        foreach (PropertyInformation propertyItem in
          configSection.ElementInformation.Properties)
        {
          configPropertyAL.Add(propertyItem.Name.ToString());
        }
        // Copy the elements of the ArrayList to a string array.
        String[] myArr = (String[])configPropertyAL.ToArray(typeof(string));
        // Create as a comma delimited list.
        string propList = string.Join(",", myArr);
        // Lock the items in the list.
        lockedAttribList.SetFromList(propList);
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait.
      Console.ReadLine();
    }
  }
}

Remarques

Dans un fichier de configuration, une section de configuration contient à la fois des attributs et des éléments. Une ConfigurationLockCollection collection existe pour les attributs verrouillés d’une section de configuration et est accessible via la LockAttributes propriété de la ConfigurationElement classe . Une autre ConfigurationLockCollection collection existe pour les éléments verrouillés d’une section de configuration et est accessible via la LockElements propriété de la ConfigurationElement classe .

Propriétés

AttributeList	Obtient une liste des objets de configuration contenus dans la collection.
Count	Obtient le nombre d'objets de configuration verrouillés contenus dans la collection.
HasParentElements	Obtient une valeur spécifiant si la collection d'objets verrouillés a des éléments parents.
IsModified	Obtient une valeur indiquant si la collection a été modifiée.
IsSynchronized	Obtient une valeur indiquant si la collection est synchronisée.
SyncRoot	Obtient un objet utilisé pour synchroniser l'accès à cette collection ConfigurationLockCollection.

Méthodes

Add(String)	Verrouille un objet de configuration en l'ajoutant à la collection.
Clear()	Efface tous les objets de configuration de la collection.
Contains(String)	Vérifie si un objet de configuration spécifique est verrouillé.
CopyTo(String[], Int32)	Copie la totalité de la collection ConfigurationLockCollection dans un Array compatible unidimensionnel, à partir de l'index spécifié du tableau cible.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Obtient un objet IEnumerator, qui est utilisé pour itérer au sein de cette collection ConfigurationLockCollection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsReadOnly(String)	Vérifie si un objet de configuration spécifique est en lecture seule.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(String)	Supprime un objet de configuration de la collection.
SetFromList(String)	Verrouille un jeu d'objets de configuration selon la liste fournie.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)

Copie la totalité de la collection ConfigurationLockCollection dans un Array compatible unidimensionnel, à partir de l'index spécifié du tableau cible.

Méthodes d’extension

S’applique à

Voir aussi

• LockAllAttributesExcept
• LockAllElementsExcept
• ConfigurationElement