ConfigurationElement.LockElements プロパティ

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v8.0.0

ソース:

ConfigurationElement.cs

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

C#

public System.Configuration.ConfigurationLockCollection LockElements { get; }

プロパティ値

ConfigurationLockCollection

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

例

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

注釈

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

これを行うには、次の Contains 例で説明するように、 メソッドを使用します。

注意

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

適用対象

こちらもご覧ください

• ConfigurationLockCollection