ConfigurationSection を使用して、カスタムのセクション型を実装します。ConfigurationSection クラスを拡張して、カスタム ハンドリングを提供し、さらにカスタム構成セクションにプログラムからアクセスできるようにします。

セクションは、その処理型を configSections のエントリに登録します。

次の例に示す構成ファイルの抜粋を参照してください。

実装時の注意 プログラム コーディング モデルまたは宣言 (属性付き) コーディング モデルを使用して、カスタム構成セクションを作成できます。

• プログラム モデル。このモデルでは、セクション属性ごとにプロパティを作成し、その値の取得と設定の両方、またはそのいずれかを行い、その値を基になる ConfigurationElement 基本クラスの内部プロパティ バッグに追加する必要があります。

• 宣言モデル。属性付きモデルとも呼ばれる、このより単純なモデルを使用すると、セクション属性をプロパティを使用して定義し、属性で装飾できます。これらの属性は、ASP.NET 構成システムに対して、プロパティの型およびその既定値について指示します。リフレクションによって取得したこの情報を使用して、ASP.NET 構成システムはセクション プロパティ オブジェクトを作成し、必要な初期化を実行します。

Configuration は、構成ファイルの編集をプログラムから行うことができるようにするクラスです。次に示す方法で、これらのファイルへの読み取りアクセスまたは書き込みアクセスができます。

• 読み取り。構成情報を読み取るには、GetSection または GetSectionGroup を使用します。読み取りを行うユーザーまたはプロセスに、次のアクセス許可が必要です。

  • 現在の構成階層レベルの構成ファイルに対する読み取りアクセス許可。

  • すべての親構成ファイルに対する読み取りアクセス許可。

アプリケーションが独自の構成に対する読み取り専用アクセスを行う必要がある場合は、GetSection のオーバーロード メソッドを使用することをお勧めします (Web アプリケーションの場合)。クライアント アプリケーションの場合は、GetSection メソッドを使用します。 これらのメソッドにより、現在のアプリケーションのキャッシュされた構成値にアクセスできます。こちらの方が、Configuration クラスよりもパフォーマンスが優れています。

• 書き込み。構成情報を書き込むには、Save メソッドの 1 つを使用します。書き込みを行うユーザーまたはプロセスに、次のアクセス許可が必要です。

  • 現在の構成階層レベルの構成ファイルおよびディレクトリに対する書き込みアクセス許可。

  • すべての構成ファイルに対する読み取りアクセス許可。

Topic	Location
方法 : ConfigurationSection を使用してカスタム構成セクションを作成します。	dv_vwdcon
方法 : ConfigurationSection を使用してカスタム構成セクションを作成する	ASP .NET Web アプリケーションの構成
方法 : ConfigurationSection を使用してカスタム構成セクションを作成する	Visual Studio ASP .NET での Web アプリケーションの作成
方法 : IConfigurationSectionHandler を使用してカスタム構成セクションを作成します。	dv_vwdcon
方法 : IConfigurationSectionHandler を使用してカスタム構成セクションを作成する	ASP .NET Web アプリケーションの構成
方法 : IConfigurationSectionHandler を使用してカスタム構成セクションを作成する	Visual Studio ASP .NET での Web アプリケーションの作成

プログラムによってカスタム セクションを実装する方法を次のコード例に示します。

属性モデルを使用して実装されたカスタム セクションを実装および使用する方法を示す完全な例については、ConfigurationElement のトピックを参照してください。

これは、前の例に適用されている構成ファイルの抜粋です。

<?xml version="1.0" encoding="utf-8"?>

<configuration>

<configSections>

<section name="CustomSection" type="Samples.AspNet, CustomConfigurationSection, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" allowDefinition="Everywhere" allowExeDefinition="MachineToApplication" restartOnExternalChanges="true" />

</configSections>

<CustomSection fileName="default.txt" maxUsers="1000" maxIdleTime="00:15:00" />

</configuration>

System.Object
   System.Configuration.ConfigurationElement
    System.Configuration.ConfigurationSection
       派生クラス

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

.NET Framework

サポート対象 : 2.0