ConfigurationSectionGroup.ForceDeclaration メソッド

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v8.0.0

この ConfigurationSectionGroup オブジェクトの宣言を強制的に行います。

オーバーロード

ForceDeclaration()	この ConfigurationSectionGroup オブジェクトの宣言を強制的に行います。
ForceDeclaration(Boolean)	この ConfigurationSectionGroup オブジェクトの宣言を強制的に行います。

ForceDeclaration()

ソース:

ConfigurationSectionGroup.cs

この ConfigurationSectionGroup オブジェクトの宣言を強制的に行います。

C#

public void ForceDeclaration ();

例

ForceDeclaration メソッドを使用するコード例を次に示します。

C#

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);
}

注釈

メソッドは ForceDeclaration 、親ファイルで ConfigurationSectionGroup 既に宣言されているため、必要ない場合でも、オブジェクトを強制的に構成ファイルに書き込むことができます。

こちらもご覧ください

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

ソース:

ConfigurationSectionGroup.cs

この ConfigurationSectionGroup オブジェクトの宣言を強制的に行います。

C#

public void ForceDeclaration (bool force);

パラメーター

force

Boolean

ConfigurationSectionGroup オブジェクトをファイルに書き込む必要がある場合は true。それ以外の場合は false。

例外

InvalidOperationException

ConfigurationSectionGroup オブジェクトがルート セクション グループです。

- または -

ConfigurationSectionGroup オブジェクトに位置があります。

例

ForceDeclaration メソッドを使用するコード例を次に示します。

C#

static void ForceDeclaration(
    ConfigurationSectionGroup sectionGroup,
    bool force)
{
    sectionGroup.ForceDeclaration(force);

    Console.WriteLine(
        "Forced declaration for the group: {0} is {1}",
        sectionGroup.Name, force.ToString());
}

注釈

メソッドはForceDeclaration、 が trueの場合forceに、このConfigurationSectionGroup宣言を強制的にファイルに書き込みます。 が falseの場合force、オブジェクトがシステムで必要な場合、ConfigurationSectionGroupこのアクションは無視される可能性があります。

メソッドは ForceDeclaration 、親ファイルで ConfigurationSectionGroup 既に宣言されているため、必要ない場合でも、オブジェクトを強制的に構成ファイルに書き込むことができます。 また、グループが不要な場合は、構成ファイルからグループを削除することもできます。

グループ宣言が既に存在するかどうかを気にせずに、 メソッドを使用 ForceDeclaration して、構成ファイルをあるコンピューターから別のコンピューターに移植しやすくすることができます。

こちらもご覧ください

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection