Questa documentazione è stata archiviata e non viene gestita.

Proprietà ConfigurationElement.LockAttributes

Ottiene l'insieme di attributi bloccati

Spazio dei nomi: System.Configuration
Assembly: System.Configuration (in system.configuration.dll)

public ConfigurationLockCollection LockAttributes { get; }
/** @property */
public ConfigurationLockCollection get_LockAttributes ()

public function get LockAttributes () : ConfigurationLockCollection

Non applicabile.

Valore proprietà

Insieme ConfigurationLockCollection di attributi (proprietà) bloccati dell'elemento.

La proprietà LockAttributes consente di bloccare tutti gli attributi specificati.

A tale scopo, utilizzare il metodo Contains, come illustrato nella sezione Esempio.

NotaNota:

Grazie alla proprietà LockAttributes, è possibile impedire che gli elementi di configurazione figlio dell'elemento a cui viene applicata la regola vengano modificati. Utilizzare la proprietà LockItem se si desidera impostare un blocco generale sull'elemento stesso e sui relativi elementi figlio.

Note per gli implementatori: Se si utilizzano contemporaneamente le proprietà LockAllAttributesExcept e LockAttributes, verrà applicata la regola più restrittiva.

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà LockAttributes.

// 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());
    }

}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:
Mostra: