ConfigurationElement.IsModified Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

ConfigurationElement.cs

Indica se este elemento de configuração foi modificado desde a última vez em que foi salvo ou carregado quando implementado em uma classe derivada.

C#

protected internal virtual bool IsModified ();

Retornos

Boolean

true se o elemento tiver sido modificado, caso contrário, false.

Exemplos

O exemplo a seguir mostra como estender IsModified.

C#

protected override bool IsModified()
{
    bool ret = base.IsModified();
    // You can enter your custom processing code here.
    return ret;
}

O método mostrado no exemplo anterior é chamado quando um elemento de configuração é modificado, como no exemplo a seguir.

C#

// Show how to use IsModified.
// This method modifies the port property
// of the url element named Microsoft and
// saves the modification to the configuration
// file. This in turn will cause the overriden
// UrlConfigElement.IsModified() mathod to be called. 
static void ModifyElement()
{
    try
    {
        // Get the configuration file.
        System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);

        // Get the MyUrls section.
        UrlsSection myUrlsSection =
            config.GetSection("MyUrls") as UrlsSection;

        UrlsCollection elements = myUrlsSection.Urls;

        IEnumerator elemEnum =
            elements.GetEnumerator();

        int i = 0;
        while (elemEnum.MoveNext())
        {
            if (elements[i].Name == "Microsoft")
            {
                elements[i].Port = 1010;
                bool readOnly = elements[i].IsReadOnly();
                break;
            }
            i += 1;
        }

        if (!myUrlsSection.ElementInformation.IsLocked)
        {

            config.Save(ConfigurationSaveMode.Full);

            // This to obsolete the MyUrls cached 
            // section and read the updated version
            // from the configuration file.
            ConfigurationManager.RefreshSection("MyUrls");
        }
        else
            Console.WriteLine(
                "Section was locked, could not update.");
    }

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

Comentários

O IsModified método determina se esse ConfigurationElement objeto será gravado no arquivo de configuração quando o Save método for chamado. Se o valor retornado for false, supõe-se que o arquivo de configuração represente o estado atual do elemento.

Por padrão, IsModified retorna true depois que uma propriedade é definida por meio do indexador para esse ConfigurationElement objeto.

Substitua o IsModified método para fornecer indicação personalizada do estado desse ConfigurationElement elemento.

Aplica-se a