ConfigurationElement.LockElements Propriété

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationElement.cs

Obtient la collection d'éléments verrouillés.

C#

public System.Configuration.ConfigurationLockCollection LockElements { get; }

Valeur de propriété

ConfigurationLockCollection

ConfigurationLockCollection d'éléments verrouillés.

Exemples

L'exemple suivant indique comment utiliser la propriété LockElements.

C#

// Show how to use LockElements
// It locks and unlocks the urls element.
static void LockElements()
{

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

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

        if (myUrlsSection == null)
        {
            Console.WriteLine("Failed to load UrlsSection.");
        }
        else
        {
            // Get MyUrls section LockElements collection.
            ConfigurationLockCollection lockElements =
                myUrlsSection.LockElements;

            // Get MyUrls section LockElements collection 
            // enumerator.
            IEnumerator lockElementEnum =
                 lockElements.GetEnumerator();

            // Position the collection index.
            lockElementEnum.MoveNext();

            if (lockElements.Contains("urls"))
                // Remove the lock on the urls element.
                lockElements.Remove("urls");
            else
                // Add the lock on the urls element.
                lockElements.Add("urls");

            // Save the change.
            config.Save(ConfigurationSaveMode.Full);
        }
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine("[LockElements: {0}]",
            err.ToString());
    }
}

Remarques

La LockElements propriété vous permet de verrouiller tous les éléments que vous spécifiez.

Pour ce faire, vous utilisez la Contains méthode, comme expliqué dans l’exemple suivant.

Notes

La LockElements propriété vous permet d’empêcher la modification des éléments de configuration enfants de l’élément auquel vous appliquez la règle. Utilisez LockItem si vous souhaitez placer un verrou général sur l’élément lui-même et ses éléments enfants.

S’applique à

Voir aussi

• ConfigurationLockCollection