<configuration> の <appSettings> 要素

  • [アーティクル]

カスタム アプリケーション設定が格納されます。 これは、.NET Framework によって提供される定義済みの構成セクションです。

configuration
  <appSettings>

構文

<appSettings>
  <!-- Elements to add, clear, or remove configuration settings -->
</appSettings>

属性

説明
file 省略可能な属性です。

カスタム アプリケーション構成設定が格納された外部ファイルへの相対パスを指定します。 指定したファイルには、<add>、<remove>、<clear> の各要素で指定したものと同じ種類の設定が格納されており、これらの要素と同じキーと値のペアの形式を使用します。

指定するパスは、メイン構成ファイルに対する相対パスです。 Windows フォーム アプリケーションの場合、これはアプリケーション構成ファイルの場所ではなく、バイナリ フォルダー ( /bin/debug など) です。 Web フォーム アプリケーションの場合、このパスは web.config ファイルが配置されているアプリケーション ルートに対する相対パスです。

指定したファイルが見つからない場合、ランタイムではこの属性が無視されます。

親要素

説明
<configuration> 要素 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。

子要素

説明
<add> カスタム アプリケーション設定を追加します。
<clear> 以前に定義したアプリケーション設定をすべてクリアします。
<remove> 以前に定義したアプリケーション設定を削除します。

解説

<appSettings> 要素には、データベース接続文字列、ファイル パス、XML Web サービス URL、またはアプリケーションのその他のカスタム構成情報など、カスタム アプリケーション構成情報が格納されます。 <appSettings> 要素で指定されたキーと値のペアは、ConfigurationSettings クラスを使用してコードでアクセスされます。

Web.config とアプリケーション構成ファイルの <appSettings> 要素では、file 属性を使用できます。 この属性では、追加の設定や、<appSettings> 要素で指定された設定のオーバーライドを行う構成ファイルを指定します。 file 属性は、アプリケーション構成ファイルで指定されたプロジェクト設定をユーザーがオーバーライドする必要がある場合など、ソース管理チームの開発シナリオで使用できます。

file 属性で指定される構成ファイルには、<configuration> ではなく、<appSettings> のルート ノードが必要です。

例

次の例は、カスタム アプリケーション設定を定義する外部アプリケーション設定ファイル (custom.config) を示しています。

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
  <add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>

次の例は、外部設定ファイルで設定を使用して、独自のアプリケーション設定を設定するアプリケーション構成ファイルを示しています。

<configuration>
  <appSettings file="custom.config">
    <add key="ApplicationName" value="MyApplication" />
  </appSettings>
</configuration>

構成ファイル

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

関連項目