ConfigurationSectionGroup.ForceDeclaration メソッド

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v8.0.0

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

オーバーロード

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

ForceDeclaration()

ソース:

ConfigurationSectionGroup.cs

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

public:
 void ForceDeclaration();

public void ForceDeclaration ();

member this.ForceDeclaration : unit -> unit

Public Sub ForceDeclaration ()

例

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

注釈

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

こちらもご覧ください

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection

ForceDeclaration(Boolean)

ソース:

ConfigurationSectionGroup.cs

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

public:
 void ForceDeclaration(bool force);

public void ForceDeclaration (bool force);

member this.ForceDeclaration : bool -> unit

Public Sub ForceDeclaration (force As Boolean)

パラメーター

force

Boolean

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

例外

InvalidOperationException

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

- または -

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

例

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

注釈

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

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

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

こちらもご覧ください

• ConfigurationSectionGroup
• ConfigurationSectionCollection
• ConfigurationSection