WebConfigurationManager.AppSettings プロパティ

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

WebConfigurationManager.AppSettings プロパティ

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

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

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

Visual Basic (宣言)

Public Shared ReadOnly Property
 AppSettings As NameValueCollection

Visual Basic (使用法)

Dim value As NameValueCollection

value = WebConfigurationManager.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

プロパティ値
現在の Web アプリケーションの既定の構成の AppSettingsSection オブジェクトを格納している NameValueCollection オブジェクト。

例外

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

解説

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

使用例

AppSettings メソッドを使用して構成情報にアクセスする方法を次のコード例に示します。

Visual Basic

' Show the use of AppSettings. 
' It gets the section from the configuration 
' file located at the application current level. 
Shared Sub GetAppSettings()
   
   ' Get the appSettings key,value pairs collection.
     Dim appSettings As NameValueCollection
 = _
     WebConfigurationManager.AppSettings
   
   ' Get the collection enumerator.
     Dim appSettingsEnum As IEnumerator = _
     appSettings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the appSettings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display appSettings]")
   While appSettingsEnum.MoveNext()
      Dim key As String
 = appSettings.AllKeys(i)
         Console.WriteLine("Key: {0} Value: {1}",
 _
         key, appSettings(key))
      i += 1
   End While
   
   Console.WriteLine()
End Sub 'GetAppSettings

C#

// Show the use of AppSettings. 
// It gets the section from the configuration 
// file located at the application current level. 
static void GetAppSettings()
{

    // Get the appSettings key,value pairs collection.
    NameValueCollection appSettings =
        WebConfigurationManager.AppSettings
        as NameValueCollection;

    // Get the collection enumerator.
    IEnumerator appSettingsEnum =
        appSettings.GetEnumerator();

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

    Console.WriteLine();
}

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

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