appSettings の add 要素 (全般設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
カスタム アプリケーション設定を、名前と値のペアとしてアプリケーション設定のコレクションに追加します。
<add
key="String name"
value="String value"
/>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
key |
必須の String 属性です。 アプリケーション設定の名前を指定します。 この属性はコレクション キーです。 |
value |
必須の String 属性です。 アプリケーション設定の値を指定します。 |
継承される属性 |
省略可能な属性です。 すべてのセクション要素が継承する属性です。 詳細については、「セクションの要素によって継承される全般属性」を参照してください。 |
子要素
なし。
親要素
要素 |
Description |
|---|---|
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>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
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 |
参照
Reference
appSettings の clear 要素 (全般設定スキーマ)
appSettings の remove 要素 (全般設定スキーマ)