ConfigurationSectionGroup.ForceDeclaration Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Força a declaração para este objeto ConfigurationSectionGroup.

Sobrecargas

ForceDeclaration()	Força a declaração para este objeto ConfigurationSectionGroup.
ForceDeclaration(Boolean)	Força a declaração para este objeto ConfigurationSectionGroup.

ForceDeclaration()

Origem:

ConfigurationSectionGroup.cs

Força a declaração para este objeto ConfigurationSectionGroup.

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

Exemplos

O exemplo de código a seguir mostra como usar o método ForceDeclaration.

static void ForceDeclaration(
    ConfigurationSectionGroup sectionGroup)
{

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

    sectionGroup.ForceDeclaration();

    config.Save(ConfigurationSaveMode.Full);

    Console.WriteLine(
        "Forced declaration for the group: {0}",
        sectionGroup.Name);
}

Overloads Shared Sub ForceDeclaration( _
ByVal sectionGroup As ConfigurationSectionGroup)

    ' Get the application configuration file.
    Dim config _
    As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
    ConfigurationUserLevel.None)

    sectionGroup.ForceDeclaration()

    config.Save(ConfigurationSaveMode.Full)

    Console.WriteLine( _
    "Forced declaration for the group: {0}", _
    sectionGroup.Name)
End Sub

Comentários

O ForceDeclaration método pode forçar um ConfigurationSectionGroup objeto a ser gravado em um arquivo de configuração, mesmo que não seja necessário porque já está declarado em um arquivo pai.

Confira também

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

Origem:

ConfigurationSectionGroup.cs

Força a declaração para este objeto ConfigurationSectionGroup.

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

Parâmetros

force

Boolean

true se o objeto ConfigurationSectionGroup deve ser gravado no arquivo; caso contrário, false.

Exceções

InvalidOperationException

O objeto ConfigurationSectionGroup é o grupo da seção de raiz.

- ou -

O objeto ConfigurationSectionGroup tem um local.

Exemplos

O exemplo de código a seguir mostra como usar o método ForceDeclaration.

static void ForceDeclaration(
    ConfigurationSectionGroup sectionGroup,
    bool force)
{
    sectionGroup.ForceDeclaration(force);

    Console.WriteLine(
        "Forced declaration for the group: {0} is {1}",
        sectionGroup.Name, force.ToString());
}

Overloads Shared Sub ForceDeclaration( _
ByVal sectionGroup _
As ConfigurationSectionGroup, _
ByVal force As Boolean)
    sectionGroup.ForceDeclaration(force)

    Console.WriteLine( _
    "Forced declaration for the group: {0} is {1}", _
    sectionGroup.Name, force.ToString())
End Sub

Comentários

O ForceDeclaration método força essa ConfigurationSectionGroup declaração a ser gravada no arquivo se force for true. Se force for false, essa ação poderá ser ignorada se o ConfigurationSectionGroup objeto for exigido pelo sistema.

O ForceDeclaration método pode forçar um ConfigurationSectionGroup objeto a ser gravado em um arquivo de configuração, mesmo que não seja necessário porque já está declarado em um arquivo pai. Além disso, ele poderá remover um grupo de um arquivo de configuração se o grupo não for necessário.

Talvez você queira usar o ForceDeclaration método para tornar um arquivo de configuração mais portátil de um computador para outro, sem se preocupar se a declaração de grupo já existe.

Confira também

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection