ConfigurationSectionGroup.ForceDeclaration Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Fuerza la declaración de este objeto ConfigurationSectionGroup.

Sobrecargas

ForceDeclaration()	Fuerza la declaración de este objeto ConfigurationSectionGroup.
ForceDeclaration(Boolean)	Fuerza la declaración de este objeto ConfigurationSectionGroup.

ForceDeclaration()

Source:

ConfigurationSectionGroup.cs

Fuerza la declaración de este objeto ConfigurationSectionGroup.

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

Ejemplos

En el ejemplo de código siguiente, se muestra cómo se utiliza el método 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

Comentarios

El ForceDeclaration método puede forzar que un ConfigurationSectionGroup objeto se escriba en un archivo de configuración, aunque no sea necesario porque ya está declarado en un archivo primario.

Consulte también

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

Source:

ConfigurationSectionGroup.cs

Fuerza la declaración de este objeto ConfigurationSectionGroup.

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

Parámetros

force

Boolean

Es true si se debe escribir el objeto ConfigurationSectionGroup en el archivo; en caso contrario, es false.

Excepciones

InvalidOperationException

El objeto ConfigurationSectionGroup es el grupo de sección raíz.

o bien

El objeto ConfigurationSectionGroup tiene una ubicación.

Ejemplos

En el ejemplo de código siguiente, se muestra cómo se utiliza el método 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

Comentarios

El ForceDeclaration método obliga a que esta ConfigurationSectionGroup declaración se escriba en el archivo si force es true. Si force es false, esta acción puede omitirse si el sistema requiere el ConfigurationSectionGroup objeto .

El ForceDeclaration método puede forzar que un ConfigurationSectionGroup objeto se escriba en un archivo de configuración, aunque no sea necesario porque ya está declarado en un archivo primario. Además, puede quitar un grupo de un archivo de configuración si no es necesario.

Es posible que desee usar el ForceDeclaration método para que un archivo de configuración sea más portátil de un equipo a otro, sin preocuparse de si la declaración de grupo ya existe.

Consulte también

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection