ConfigurationElement.LockAttributes Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ConfigurationElement.cs

Ruft die Auflistung gesperrter Attribute ab.

C#

public System.Configuration.ConfigurationLockCollection LockAttributes { get; }

Eigenschaftswert

ConfigurationLockCollection

Die ConfigurationLockCollection gesperrter Attribute (Eigenschaften) für das Element.

Beispiele

Im folgenden Beispiel wird die Verwendung der LockAttributes-Eigenschaft veranschaulicht.

C#

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

    try
    {
        // Get the 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 the current element.
                ConfigurationElement element =
                    myUrlsSection.Urls[i];

                // Get the lock attributes collection of 
                // the current element.
                ConfigurationLockCollection lockAttributes =
                    element.LockAttributes;

                // Add or remove the lock on the attributes.
                if (lockAttributes.Contains("name"))
                    lockAttributes.Remove("name");
                else
                    lockAttributes.Add("name");

                if (lockAttributes.Contains("url"))
                    lockAttributes.Remove("url");
                else
                    lockAttributes.Add("url");

                if (lockAttributes.Contains("port"))
                    lockAttributes.Remove("port");
                else
                    lockAttributes.Add("port");

                // Get the locket attributes.
                string lockedAttributes =
                    lockAttributes.AttributeList;

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

                i += 1;

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

Hinweise

Mit LockAttributes der -Eigenschaft können Sie alle von Ihnen angegebenen Attribute sperren.

Dazu verwenden Sie die Contains -Methode, wie im Abschnitt Beispiel erläutert.

Hinweis

Mit LockAttributes der -Eigenschaft können Sie verhindern, dass die untergeordneten Konfigurationselemente des Elements, auf das Sie die Regel anwenden, geändert werden. Verwenden Sie LockItem , wenn Sie eine allgemeine Sperre für das Element selbst und seine untergeordneten Elemente festlegen möchten.

Hinweise für Vererber

Wenn Sie die LockAllAttributesExcept Eigenschaften und LockAttributes gleichzeitig verwenden, gilt die restriktivste Regel.

Gilt für:

Weitere Informationen

• ConfigurationLockCollection