次の方法で共有

<section> 要素

  • [アーティクル]

構成セクション宣言が含まれています。

configuration
  <configSections>
    <section>

configuration
  <configSections>
    <sectionGroup>
      <section>

構文

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

必須属性

説明
name 構成セクションの名前を指定します。
type 構成ファイルからセクションを読み取る構成セクション ハンドラー クラスの名前を指定します。 型の値には、"完全修飾セクション ハンドラー クラス名, 単純アセンブリ名" という構文があります。 単純アセンブリ名は、 .dll ファイル拡張子のないルート ファイル名です。

省略可能な属性

次の属性は、ASP.NET アプリケーションにのみ適用されます。 構成システムでは、他のアプリケーションの種類に対してこれらの属性は無視されます。

説明
allowDefinition セクションを使用できる構成ファイルを指定します。 次のいずれかの値を使用します。

すべての場所
セクションをすべての構成ファイルで使用できるようにします。 既定値です。
MachineOnly
セクションを、コンピューターの構成ファイル (Machine.config) でのみ使用できるようにします。
MachineToApplication
セクションを、マシン構成ファイルまたはアプリケーション構成ファイルで使用できるようにします。
allowLocation セクションを <location> 要素内で使用できるようにするかどうかを決定します。 次のいずれかの値を使用します。

true
セクションを <location> 要素内で使用できるようにします。 既定値です。
false
セクションを <location> 要素内で使用できないようにします。

親要素

説明
<configSections> 要素 構成セクションと名前空間宣言が含まれています。
<sectionGroup> 要素 構成セクションの名前空間を定義します。

Note

<section> 要素は、<configSections> と <sectionGroup> の両方ではなくいずれかの子要素です。

子要素

なし

解説

構成セクションを宣言すると、基本的に構成ファイルの新しい要素が定義されます。 新しい要素には、構成セクション ハンドラー (つまり、IConfigurationSectionHandler インターフェイスを実装するクラス) によって読み取られる設定が格納されます。 定義するセクションの属性と子要素は、設定の読み取りに使用するセクション ハンドラーによって変わってきます。

Machine.config ファイルで構成セクション ハンドラーを宣言した場合は、allowDefinition 属性で特に指定されていない限り、そのコンピューター上の任意のアプリケーション構成ファイル内の構成セクションを使用できるようになります。

例

次の例は、構成セクションを定義し、そのセクションの設定を定義する方法を示しています。

<configuration>
  <configSections>
    <section name="sampleSection"
             type="System.Configuration.SingleTagSectionHandler"
             allowLocation="false" />
  </configSections>
  <sampleSection setting1="Value1"
                 setting2="value two"
                 setting3="third value" />
</configuration>

構成ファイル

この要素は、アプリケーション構成ファイル、マシン構成ファイル (Machine.config)、およびアプリケーション ディレクトリ レベルではない Web.config ファイルで使用できます。

関連項目