ConfigurationElement.LockItem Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ConfigurationElement.cs

Ruft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest.

C#

public bool LockItem { get; set; }

Eigenschaftswert

Boolean

true, wenn das Element gesperrt ist, andernfalls false. Der Standardwert ist false.

Ausnahmen

ConfigurationErrorsException

Das Element wurde bereits auf einer höheren Konfigurationsebene gesperrt.

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie verwendet werden LockItem.

C#

// Show how to set LockItem
// It adds a new UrlConfigElement to 
// the collection.
static void LockItem()
{
    string name = "Contoso";
    string url = "http://www.contoso.com/";
    int port = 8080;

    try
    {
        // Get the current configuration file.
        System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);

        // Get the MyUrls section.
        UrlsSection myUrls =
           config.Sections["MyUrls"] as UrlsSection;

        // Create the new  element.
        UrlConfigElement newElement =
            new UrlConfigElement(name, url, port);

        // Set its lock.
        newElement.LockItem = true;

        // Save the new element to the 
        // configuration file.
        if (!myUrls.ElementInformation.IsLocked)
        {

            myUrls.Urls.Add(newElement);

            config.Save(ConfigurationSaveMode.Full);

            // This is used to obsolete the cached 
            // section and read the updated 
            // bersion from the configuration file.
            ConfigurationManager.RefreshSection("MyUrls");
        }
        else
            Console.WriteLine(
                "Section was locked, could not update.");
    }
    catch (ConfigurationErrorsException e)
    {
        Console.WriteLine("[LockItem: {0}]",
            e.ToString());
    }
}

Hinweise

Verwenden Sie die LockItem -Eigenschaft, wenn Sie eine allgemeine Sperre für das Element selbst und seine untergeordneten Elemente festlegen möchten.

Gilt für: