ConfigurationElement.LockItem Właściwość

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

ConfigurationElement.cs

Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany.

C#

public bool LockItem { get; set; }

Wartość właściwości

Boolean

true jeśli element jest zablokowany; w przeciwnym razie , false. Wartość domyślna to false.

Wyjątki

ConfigurationErrorsException

Element został już zablokowany na wyższym poziomie konfiguracji.

Przykłady

W poniższym przykładzie pokazano, jak używać polecenia 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());
    }
}

Uwagi

Użyj właściwości , LockItem jeśli chcesz umieścić ogólną blokadę na samym elemecie i jego elementach podrzędnych.

Dotyczy