ConfigurationSectionGroup.ForceDeclaration Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.

Overload

ForceDeclaration()	Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.
ForceDeclaration(Boolean)	Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.

ForceDeclaration()

Source:

ConfigurationSectionGroup.cs

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo 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

Commenti

Il ForceDeclaration metodo può forzare la scrittura di un ConfigurationSectionGroup oggetto in un file di configurazione, anche se non è necessario perché è già dichiarato in un file padre.

Vedi anche

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

Source:

ConfigurationSectionGroup.cs

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

Parametri

force

Boolean

true se è necessario scrivere l'oggetto ConfigurationSectionGroup nel file; in caso contrario, false.

Eccezioni

InvalidOperationException

L'oggetto ConfigurationSectionGroup corrisponde al gruppo di sezioni di primo livello.

-oppure-

Per l'oggetto ConfigurationSectionGroup è disponibile un percorso.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo 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

Commenti

Il ForceDeclaration metodo forza la scrittura di questa ConfigurationSectionGroup dichiarazione nel file se force è true. Se force è false, questa azione potrebbe essere ignorata se l'oggetto ConfigurationSectionGroup è richiesto dal sistema.

Il ForceDeclaration metodo può forzare la scrittura di un ConfigurationSectionGroup oggetto in un file di configurazione, anche se non è necessario perché è già dichiarato in un file padre. Inoltre, può rimuovere un gruppo da un file di configurazione se il gruppo non è necessario.

È possibile usare il ForceDeclaration metodo per rendere un file di configurazione più portabile da un computer a un altro, senza doversi preoccupare se la dichiarazione di gruppo esiste già.

Vedi anche

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection