ConfigurationSectionGroup.ForceDeclaration Metoda

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Wymusza deklarację dla tego ConfigurationSectionGroup obiektu.

Przeciążenia

ForceDeclaration()	Wymusza deklarację dla tego ConfigurationSectionGroup obiektu.
ForceDeclaration(Boolean)	Wymusza deklarację dla tego ConfigurationSectionGroup obiektu.

ForceDeclaration()

Źródło:

ConfigurationSectionGroup.cs

Wymusza deklarację dla tego ConfigurationSectionGroup obiektu.

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ForceDeclaration metody .

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

Uwagi

Metoda ForceDeclaration może wymusić ConfigurationSectionGroup zapisanie obiektu w pliku konfiguracji, nawet jeśli nie jest to wymagane, ponieważ jest on już zadeklarowany w pliku nadrzędnym.

Zobacz też

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

Źródło:

ConfigurationSectionGroup.cs

Wymusza deklarację dla tego ConfigurationSectionGroup obiektu.

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

Parametry

force

Boolean

trueConfigurationSectionGroup jeśli obiekt musi być zapisany w pliku; w przeciwnym razie . false

Wyjątki

InvalidOperationException

Obiekt ConfigurationSectionGroup jest główną grupą sekcji.

-lub-

Obiekt ConfigurationSectionGroup ma lokalizację.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ForceDeclaration metody .

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

Uwagi

Metoda ForceDeclaration wymusza zapisanie tej ConfigurationSectionGroup deklaracji w pliku, jeśli force ma wartość true. Jeśli force wartość to false, ta akcja może zostać zignorowana, jeśli ConfigurationSectionGroup obiekt jest wymagany przez system.

Metoda ForceDeclaration może wymusić ConfigurationSectionGroup zapisanie obiektu w pliku konfiguracji, nawet jeśli nie jest to wymagane, ponieważ jest on już zadeklarowany w pliku nadrzędnym. Ponadto może usunąć grupę z pliku konfiguracji, jeśli grupa nie jest wymagana.

Możesz użyć ForceDeclaration metody , aby plik konfiguracji był bardziej przenośny z jednego komputera do innego, nie martwiąc się, czy deklaracja grupy już istnieje.

Zobacz też

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection