ConfigurationElement.LockAllElementsExcept 속성

정의

잠긴 요소의 컬렉션을 가져옵니다.

public:
 property System::Configuration::ConfigurationLockCollection ^ LockAllElementsExcept { System::Configuration::ConfigurationLockCollection ^ get(); };
public System.Configuration.ConfigurationLockCollection LockAllElementsExcept { get; }
member this.LockAllElementsExcept : System.Configuration.ConfigurationLockCollection
Public ReadOnly Property LockAllElementsExcept As ConfigurationLockCollection

속성 값

잠긴 요소의 ConfigurationLockCollection입니다.

예제

다음 예제에서는 LockAllElementsExcept 속성을 사용하는 방법을 보여 줍니다.

// 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());
    }
}
' Show how to use LockAllElementsExcept.
' It locks and unlocks all the MyUrls elements 
' except urls.
Shared Sub LockAllElementsExcept()

    Try
        ' Get the current configuration file.
        Dim config _
        As System.Configuration.Configuration = _
        ConfigurationManager.OpenExeConfiguration( _
        ConfigurationUserLevel.None)

        ' Get the MyUrls section.
        Dim myUrlsSection As UrlsSection = _
        config.GetSection("MyUrls")

        If myUrlsSection Is Nothing Then
            Console.WriteLine("Failed to load UrlsSection.")
        Else

            ' Get MyUrls section LockElements collection.
            Dim lockElementsExcept _
            As ConfigurationLockCollection = _
            myUrlsSection.LockAllElementsExcept

            ' Get MyUrls section LockElements collection 
            ' enumerator.
            Dim lockElementEnum As IEnumerator = _
            lockElementsExcept.GetEnumerator()

            ' Position the collection index.
            lockElementEnum.MoveNext()

            If lockElementsExcept.Contains("urls") Then
                ' Remove the lock on all the ther elements.
                lockElementsExcept.Remove("urls")
                ' Add the lock on all the other elements 
                ' but urls element.
            Else
                lockElementsExcept.Add("urls")
            End If

            config.Save(ConfigurationSaveMode.Full)
        End If
    Catch err As ConfigurationErrorsException
        Console.WriteLine("[LockAllElementsExcept: {0}]", _
        err.ToString())
    End Try

End Sub

설명

LockAllElementsExcept 속성을 사용하면 지정한 요소를 제외한 모든 요소를 한 번에 잠글 수 있습니다.

참고

속성을 LockAllElementsExcept 사용하면 규칙을 적용하는 요소의 자식 구성 요소가 수정되지 않도록 할 수 있습니다. LockItem 요소 자체 및 해당 자식 요소에 대한 일반 잠금을 적용하려면 속성을 사용합니다.

적용 대상

추가 정보