ConfigurationSectionGroup.ForceDeclaration Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Vynutí deklaraci pro tento ConfigurationSectionGroup objekt.

Přetížení

ForceDeclaration()	Vynutí deklaraci pro tento ConfigurationSectionGroup objekt.
ForceDeclaration(Boolean)	Vynutí deklaraci pro tento ConfigurationSectionGroup objekt.

ForceDeclaration()

Zdroj:

ConfigurationSectionGroup.cs

Vynutí deklaraci pro tento ConfigurationSectionGroup objekt.

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

Příklady

Následující příklad kódu ukazuje, jak použít metodu 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

Poznámky

Metoda ForceDeclaration může vynutit zápis objektu ConfigurationSectionGroup do konfiguračního souboru, i když to není nutné, protože je již deklarován v nadřazeného souboru.

Viz také

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

Zdroj:

ConfigurationSectionGroup.cs

Vynutí deklaraci pro tento ConfigurationSectionGroup objekt.

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

Parametry

force

Boolean

trueConfigurationSectionGroup pokud musí být objekt zapsán do souboru, v opačném případě false.

Výjimky

InvalidOperationException

Objekt ConfigurationSectionGroup je kořenová skupina oddílů.

-nebo-

Objekt ConfigurationSectionGroup má umístění.

Příklady

Následující příklad kódu ukazuje, jak použít metodu 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

Poznámky

Metoda ForceDeclaration vynutí zápis této ConfigurationSectionGroup deklarace do souboru, pokud force je true. Pokud force je false, může být tato akce ignorována, ConfigurationSectionGroup pokud systém vyžaduje objekt.

Metoda ForceDeclaration může vynutit zápis objektu ConfigurationSectionGroup do konfiguračního souboru, i když to není nutné, protože je již deklarován v nadřazeného souboru. Může také odebrat skupinu z konfiguračního souboru, pokud skupina není vyžadována.

Tuto metodu ForceDeclaration můžete použít k zajištění větší přenositelnosti konfiguračního souboru z jednoho počítače do druhého, aniž byste se museli starat o to, jestli už deklarace skupiny existuje.

Viz také

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection