ConfigurationManager.AppSettings プロパティ

.NET Framework クラス ライブラリ リファレンス

ConfigurationManager.AppSettings プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のアプリケーションの既定構成の AppSettingsSection データを取得します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public Shared ReadOnly Property
 AppSettings As NameValueCollection

Visual Basic (使用法)

Dim value As NameValueCollection

value = ConfigurationManager.AppSettings

C#

public static NameValueCollection AppSettings
 { get; }

C++

public:
static property NameValueCollection^ AppSettings {
    NameValueCollection^ get ();
}

J#

/** @property */
public static NameValueCollection get_AppSettings
 ()

JScript

public static function get
 AppSettings () : NameValueCollection

プロパティ値
現在のアプリケーションの既定構成の、AppSettingsSection オブジェクトの内容を格納する NameValueCollection オブジェクトを返します。

例外

例外の種類	条件
ConfigurationErrorsException	アプリケーション設定データを格納した NameValueCollection オブジェクトを取得できませんでした。

解説

AppSettingsSection オブジェクトには、構成ファイルの appSettings セクションの内容が格納されます。

使用例

AppSettings プロパティを使用して、名前付きアプリケーション設定を取得する方法を次のコード例に示します。

Visual Basic

' Get appSettings.
Shared Sub GetAppSettings()
   ' Get the appSettings.
     Dim appSettings As NameValueCollection
 = _
     ConfigurationManager.AppSettings
   
   ' Get the collection enumerator.
     Dim appSettingsEnum As IEnumerator = _
     appSettings.Keys.GetEnumerator()
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Dim i As Integer = 0
   While appSettingsEnum.MoveNext()
      Dim key As String
 = appSettings.Keys(i)
         Console.WriteLine("Name: {0} Value: {1}",
 _
         key, appSettings(key))
      i += 1
   End While
End Sub 'GetAppSettings
 

C#

// Get appSettings.
static void GetAppSettings()
{
    // Get the appSettings.
    NameValueCollection appSettings =
         ConfigurationManager.AppSettings;
    
    // Get the collection enumerator.
    IEnumerator appSettingsEnum =
        appSettings.Keys.GetEnumerator();

    // Loop through the collection and
    // display the appSettings key, value pairs.
    int i = 0;
    Console.WriteLine("App settings.");
    while (appSettingsEnum.MoveNext())
    {
        string key = appSettings.Keys[i];
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key]);
        i += 1;
    }

}

プラットフォーム

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

参照

関連項目
ConfigurationManager クラス
ConfigurationManager メンバ
System.Configuration 名前空間
AppSettingsSection クラス
NameValueCollection
その他の技術情報
appSettings 要素 (全般設定スキーマ)