ConfigurationSectionGroup.ForceDeclaration Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Force la déclaration de cet objet ConfigurationSectionGroup.

Surcharges

ForceDeclaration()	Force la déclaration de cet objet ConfigurationSectionGroup.
ForceDeclaration(Boolean)	Force la déclaration de cet objet ConfigurationSectionGroup.

ForceDeclaration()

Source:

ConfigurationSectionGroup.cs

Force la déclaration de cet objet ConfigurationSectionGroup.

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

Exemples

L'exemple de code suivant montre comment utiliser la méthode 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

Remarques

La ForceDeclaration méthode peut forcer l’écriture d’un ConfigurationSectionGroup objet dans un fichier de configuration, même si elle n’est pas obligatoire, car elle est déjà déclarée dans un fichier parent.

Voir aussi

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

Source:

ConfigurationSectionGroup.cs

Force la déclaration de cet objet ConfigurationSectionGroup.

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

Paramètres

force

Boolean

true si l'objet ConfigurationSectionGroup doit être écrit dans le fichier ; sinon, false.

Exceptions

InvalidOperationException

L'objet ConfigurationSectionGroup est le groupe de sections racine.

- ou -

L'objet ConfigurationSectionGroup a un emplacement.

Exemples

L'exemple de code suivant montre comment utiliser la méthode 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

Remarques

La ForceDeclaration méthode force cette ConfigurationSectionGroup déclaration à être écrite dans le fichier si force a la valeur true. Si force a la valeur false, cette action peut être ignorée si l’objet ConfigurationSectionGroup est requis par le système.

La ForceDeclaration méthode peut forcer l’écriture d’un ConfigurationSectionGroup objet dans un fichier de configuration, même si elle n’est pas obligatoire, car elle est déjà déclarée dans un fichier parent. En outre, il peut supprimer un groupe d’un fichier de configuration si le groupe n’est pas requis.

Vous pouvez utiliser la ForceDeclaration méthode pour rendre un fichier de configuration plus portable d’un ordinateur à un autre, sans vous soucier de savoir si la déclaration de groupe existe déjà.

Voir aussi

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection