ConfigurationSectionGroup.ForceDeclaration Method

Definition

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.Forces the declaration for this ConfigurationSectionGroup object.

Overloads

ForceDeclaration()

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.Forces the declaration for this ConfigurationSectionGroup object.

ForceDeclaration(Boolean)

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.Forces the declaration for this ConfigurationSectionGroup object.

ForceDeclaration()

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.Forces the declaration for this ConfigurationSectionGroup object.

public:
 void ForceDeclaration();
public void ForceDeclaration ();
member this.ForceDeclaration : unit -> unit
Public Sub ForceDeclaration ()

Examples

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo ForceDeclaration.The following code example shows how to use the ForceDeclaration method.

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

Remarks

Il metodo ForceDeclaration può forzare la scrittura di un oggetto ConfigurationSectionGroup in un file di configurazione, anche se non è necessario perché è già dichiarato in un file padre.The ForceDeclaration method can force a ConfigurationSectionGroup object to be written to a configuration file, even if it is not required because it is already declared in a parent file.

See also

ForceDeclaration(Boolean)

Impone la dichiarazione per questo oggetto ConfigurationSectionGroup.Forces the declaration for this ConfigurationSectionGroup object.

public:
 void ForceDeclaration(bool force);
public:
 void ForceDeclaration(bool require);
public void ForceDeclaration (bool force);
public void ForceDeclaration (bool require);
member this.ForceDeclaration : bool -> unit
member this.ForceDeclaration : bool -> unit
Public Sub ForceDeclaration (force As Boolean)
Public Sub ForceDeclaration (require As Boolean)

Parameters

forcerequire
Boolean

true se è necessario scrivere l'oggetto ConfigurationSectionGroup nel file; in caso contrario, false.true if the ConfigurationSectionGroup object must be written to the file; otherwise, false.

Exceptions

L'oggetto ConfigurationSectionGroup corrisponde al gruppo di sezioni di primo livello.The ConfigurationSectionGroup object is the root section group.

-oppure--or- Per l'oggetto ConfigurationSectionGroup è disponibile un percorso.The ConfigurationSectionGroup object has a location.

Examples

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo ForceDeclaration.The following code example shows how to use the ForceDeclaration method.

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

Remarks

Il metodo ForceDeclaration impone la scrittura nel file di questa dichiarazione ConfigurationSectionGroup se force è true.The ForceDeclaration method forces this ConfigurationSectionGroup declaration to be written to the file if force is true. Se force è false, questa azione potrebbe essere ignorata se l'oggetto ConfigurationSectionGroup è richiesto dal sistema.If force is false, this action might be ignored if the ConfigurationSectionGroup object is required by the system.

Il metodo ForceDeclaration può forzare la scrittura di un oggetto ConfigurationSectionGroup in un file di configurazione, anche se non è necessario perché è già dichiarato in un file padre.The ForceDeclaration method can force a ConfigurationSectionGroup object to be written to a configuration file, even if it is not required because it is already declared in a parent file. Inoltre, può rimuovere un gruppo da un file di configurazione se il gruppo non è necessario.Also, it can remove a group from a configuration file if the group is not required.

Potrebbe essere necessario utilizzare il metodo ForceDeclaration per rendere più portabile un file di configurazione da un computer a un altro, senza doversi preoccupare se la dichiarazione di gruppo esiste già.You might want to use the ForceDeclaration method to make a configuration file more portable from one computer to another, without worrying about whether the group declaration already exists.

See also

Applies to