appSettings の add 要素 (全般設定スキーマ)

[アーティクル]
08/09/2011

カスタムアプリケーション設定を、名前と値のペアとしてアプリケーション設定のコレクションに追加します。

<add
   key="String name"
   value="String value"
/>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性	説明
key	必須の String 属性です。アプリケーション設定の名前を指定します。この属性はコレクションキーです。
value	必須の String 属性です。アプリケーション設定の値を指定します。
継承された属性	省略可能な属性です。すべてのセクション要素が継承する属性です。詳細については、「セクションの要素によって継承される全般属性」を参照してください。

key

必須の String 属性です。

アプリケーション設定の名前を指定します。この属性はコレクションキーです。

value

必須の String 属性です。

アプリケーション設定の値を指定します。

継承された属性

省略可能な属性です。

すべてのセクション要素が継承する属性です。詳細については、「セクションの要素によって継承される全般属性」を参照してください。

子要素

なし。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。
system.web	構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。
appSettings	ファイルパス、XML Web サービスの URL、またはアプリケーションの .ini ファイルに保存されている任意の情報などの、カスタムアプリケーション設定を格納します。

解説

add 要素は、カスタムアプリケーション設定を、appSettings 要素内の継承したアプリケーション設定のコレクションに名前と値のペアとして追加します。

重要
キーは一意である必要があります。同じキーを持つ複数のエントリを追加した場合は、最後のエントリのみが保持されます。

appSettings 要素には、ファイルパス、XML Web サービスの URL、またはアプリケーションの .ini ファイルに保存されている任意の情報などの、カスタムアプリケーションの構成情報が格納されます。 appSettings 要素で指定されたキーと値のペアには、コードで ConfigurationSettings クラスを使用してアクセスできます。クラスの例では、appSettings にプログラムによってアクセスする方法を示しています。

既定の構成

次の既定の appSettings 要素は、.NET Framework Version 1.0 および 1.1 の Machine.config ファイルで構成されます。

<appSettings>
        <add key="XML File Name" value="myXmlFileName.xml" /> 
    </appSettings>

使用例

file 属性で指定した構成ファイルには、ルートノードとして、configuration の代わりに appSettings が含まれている必要があります。 file 属性で指定した構成ファイルでは、正しいコードは次のようになります。

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>

構成ファイルでカスタムアプリケーション設定を定義する方法を次のコード例に示します。

<configuration>
    <appSettings>
        <add key="Application Name" value="MyApplication" />
    </appSettings>
</configuration>

要素情報

構成セクションハンドラー	AppSettingsSection
構成メンバー	Add
構成できる場所	Machine.config ルートレベルの Web.config アプリケーションレベルの Web.config 仮想ディレクトリレベルまたは物理ディレクトリレベルの Web.config
要件	Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 .NET Framework Version 1.0、1.1、または 2.0 Microsoft Visual Studio 2003 または Visual Studio 2005