ConfigurationElement.LockElements Właściwość

Definicja

Pobiera kolekcję zablokowanych elementów.

C#
public System.Configuration.ConfigurationLockCollection LockElements { get; }

Wartość właściwości

Element ConfigurationLockCollection zablokowany.

Przykłady

W poniższym przykładzie pokazano, jak używać LockElements właściwości.

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());
    }
}

Uwagi

Właściwość LockElements umożliwia zablokowanie wszystkich elementów, które określisz.

W tym celu należy użyć Contains metody , jak wyjaśniono w następnym przykładzie.

Uwaga

Właściwość LockElements umożliwia zapobieganie modyfikowaniu podrzędnych elementów konfiguracji elementu, do którego jest stosowana reguła. Użyj polecenia LockItem , jeśli chcesz umieścić ogólną blokadę na samym elemecie i jego elementach podrzędnych.

Dotyczy

Produkt Wersje
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Zobacz też