ConfigurationElement.LockAllAttributesExcept Proprietà

Definizione

Ottiene l'insieme di attributi bloccati.Gets the collection of locked attributes.

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

Valore della proprietà

Insieme ConfigurationLockCollection di attributi (proprietà) bloccati dell'elemento.The ConfigurationLockCollection of locked attributes (properties) for the element.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il LockAllAttributesExcept.The following example shows how to use the LockAllAttributesExcept.

// Show how to use LockAllAttributesExcept.
// It locks and unlocks all urls elements 
// except the port.
static void LockAllAttributesExcept()
{

    try
    {
        // Get current 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
        {

            IEnumerator elemEnum =
                 myUrlsSection.Urls.GetEnumerator();

            int i = 0;
            while (elemEnum.MoveNext())
            {

                // Get current element.
                ConfigurationElement element =
                    myUrlsSection.Urls[i];

                // Get current element lock all attributes.
                ConfigurationLockCollection lockAllAttributesExcept =
                    element.LockAllAttributesExcept;

                // Add or remove the lock on all attributes 
                // except port.
                if (lockAllAttributesExcept.Contains("port"))
                    lockAllAttributesExcept.Remove("port");
                else
                    lockAllAttributesExcept.Add("port");


                string lockedAttributes =
                    lockAllAttributesExcept.AttributeList;

                Console.WriteLine(
                    "Element {0} Locked attributes list: {1}",
                    i.ToString(), lockedAttributes);


                i += 1;

                config.Save(ConfigurationSaveMode.Full);

            }


        }
    }
    catch (ConfigurationErrorsException e)
    {
        Console.WriteLine(
            "[LockAllAttributesExcept: {0}]",
            e.ToString());
    }

}
' Show how to use LockAllAttributesExcept.
' It locks and unlocks all urls elements 
' except the port.
Shared Sub LockAllAttributesExcept()

    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

            Dim elemEnum As IEnumerator = _
            myUrlsSection.Urls.GetEnumerator()

            Dim i As Integer = 0
            While elemEnum.MoveNext()

                ' Get current element.
                Dim element _
                As ConfigurationElement = _
                myUrlsSection.Urls(i)

                ' Get current element lock all attributes.
                Dim lockAllAttributesExcept _
                As ConfigurationLockCollection = _
                element.LockAllAttributesExcept

                ' Add or remove the lock on all attributes 
                ' except port.
                If lockAllAttributesExcept.Contains("port") Then
                    lockAllAttributesExcept.Remove("port")
                Else
                    lockAllAttributesExcept.Add("port")
                End If

                Dim lockedAttributes As String = _
                lockAllAttributesExcept.AttributeList()

                Console.WriteLine("Element {0} Locked attributes list: {1}", _
                i.ToString(), lockedAttributes)

                i += 1

                config.Save(ConfigurationSaveMode.Full)
            End While
        End If


    Catch e As ConfigurationErrorsException
        Console.WriteLine("[LockAllAttributesExcept: {0}]", _
        e.ToString())
    End Try

End Sub

Commenti

La proprietà LockAllAttributesExcept consente di bloccare tutti gli attributi in una sola volta, ad eccezione di quello specificato.The LockAllAttributesExcept property allows you to lock all the attributes at once, with the exception of the one you specify. A tale scopo, usare il metodo Contains, come illustrato nella sezione di esempio.To do that, you use the Contains method, as explained in the Example section.

Nota

La proprietà LockAllAttributesExcept consente di impedire che gli elementi di configurazione figlio dell'elemento a cui si applica la regola vengano modificati.The LockAllAttributesExcept property allows you to prevent the child configuration elements of the element to which you apply the rule from being modified. Utilizzare la proprietà LockItem se si desidera inserire un blocco generale sull'elemento padre e sui relativi elementi figlio.Use the LockItem property if you want to put a general lock on the parent element itself and its child elements.

Note per gli eredi

Se si utilizzano contemporaneamente le proprietà LockAllAttributesExcept e LockAttributes, viene applicata la regola più restrittiva.If you use the LockAllAttributesExcept and LockAttributes properties at the same time, the most restrictive rule applies.

Si applica a

Vedi anche