ConfigurationSectionGroup.ForceDeclaration Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Erzwingt die Deklaration für dieses ConfigurationSectionGroup-Objekt.

Überlädt

ForceDeclaration()	Erzwingt die Deklaration für dieses ConfigurationSectionGroup-Objekt.
ForceDeclaration(Boolean)	Erzwingt die Deklaration für dieses ConfigurationSectionGroup-Objekt.

ForceDeclaration()

Quelle:

ConfigurationSectionGroup.cs

Erzwingt die Deklaration für dieses ConfigurationSectionGroup-Objekt.

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ForceDeclaration-Methode veranschaulicht.

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

Hinweise

Die ForceDeclaration -Methode kann das Schreiben eines ConfigurationSectionGroup Objekts in eine Konfigurationsdatei erzwingen, auch wenn es nicht erforderlich ist, da es bereits in einer übergeordneten Datei deklariert ist.

Weitere Informationen

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

Quelle:

ConfigurationSectionGroup.cs

Erzwingt die Deklaration für dieses ConfigurationSectionGroup-Objekt.

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

Parameter

force

Boolean

true, wenn das ConfigurationSectionGroup-Objekt in die Datei geschrieben werden muss, andernfalls false.

Ausnahmen

InvalidOperationException

Das ConfigurationSectionGroup-Objekt ist die Stammabschnittsgruppe.

- oder -

Das ConfigurationSectionGroup-Objekt weist einen Speicherort auf.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ForceDeclaration-Methode veranschaulicht.

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

Hinweise

Die ForceDeclaration -Methode erzwingt, dass diese ConfigurationSectionGroup Deklaration in die Datei geschrieben wird, wenn force ist true. Wenn force dies der Fall ist false, kann diese Aktion ignoriert werden, wenn das ConfigurationSectionGroup -Objekt vom System erforderlich ist.

Die ForceDeclaration -Methode kann das Schreiben eines ConfigurationSectionGroup Objekts in eine Konfigurationsdatei erzwingen, auch wenn es nicht erforderlich ist, da es bereits in einer übergeordneten Datei deklariert ist. Außerdem kann eine Gruppe aus einer Konfigurationsdatei entfernt werden, wenn die Gruppe nicht erforderlich ist.

Möglicherweise möchten Sie die ForceDeclaration -Methode verwenden, um eine Konfigurationsdatei von einem Computer auf einen anderen portierbarer zu machen, ohne sich Gedanken darüber zu machen, ob die Gruppendeklaration bereits vorhanden ist.

Weitere Informationen

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection