ConfigurationElement.LockAllElementsExcept プロパティ

定義

ロックされている要素のコレクションを取得します。

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

プロパティ値

ロックされている要素の ConfigurationLockCollection

LockAllElementsExcept プロパティを使用する方法を次の例に示します。

C#
// Show how to use LockAllElementsExcept.
// It locks and unlocks all the MyUrls elements 
// except urls.
static void LockAllElementsExcept()
{

    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 lockElementsExcept =
                myUrlsSection.LockAllElementsExcept;

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

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

            if (lockElementsExcept.Contains("urls"))
                // Remove the lock on all the ther elements.
                lockElementsExcept.Remove("urls");
            else
                // Add the lock on all the other elements 
                // but urls element.
                lockElementsExcept.Add("urls");

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

注釈

LockAllElementsExceptプロパティを使用すると、指定した要素を除き、すべての要素を一度にロックできます。

注意

LockAllElementsExceptプロパティを使用すると、ルールを適用する要素の子構成要素が変更されないようにすることができます。 LockItem要素自体とその子要素に一般的なロックを設定する場合は、 プロパティを使用します。

適用対象

製品 バージョン
.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

こちらもご覧ください