AppSettingsExpressionBuilder

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

AppSettingsExpressionBuilder クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

宣言式に指定された値を Web.config ファイルの <appSettings> セクションから取得します。

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

Visual Basic (宣言)

Public Class AppSettingsExpressionBuilder
    Inherits ExpressionBuilder

Visual Basic (使用法)

Dim instance As AppSettingsExpressionBuilder

C#

public class AppSettingsExpressionBuilder :
 ExpressionBuilder

C++

public ref class AppSettingsExpressionBuilder
 : public ExpressionBuilder

J#

public class AppSettingsExpressionBuilder extends
 ExpressionBuilder

JScript

public class AppSettingsExpressionBuilder extends
 ExpressionBuilder

解説

AppSettingsExpressionBuilder クラスは、Web.config ファイルの <appSettings> セクションの値へのアクセスを提供します。Web.config ファイルの <appSettings> セクションには、アプリケーション固有のキー/値ペアが含まれています。

アプリケーション値は、形式

<%$ AppSettings: appSettingsKey %>

の式をコントロール宣言のプロパティに割り当てることによって取得されます。式のコロン (:) の前の部分は取得する式の種類を表し、コロンの後の部分はキーを表します。前述の式は、Web.config ファイルから次の値を取得します。

<appSettings>

<add key="appSettingsKey" value="appSettingsValue"/>

</appSettings>

ページ パーサーは、プレフィックスが AppSettings の式を見つけると、AppSettingsExpressionBuilder クラスのインスタンスを作成して、その式を処理します。

コンパイルされるページにこの式がある場合、AppSettingsExpressionBuilder オブジェクトは指定した値を Web.config ファイルから取得するコードを生成します。このコードは、生成されたページ クラスの実行中に実行されます。コンパイルされないページにこの式がある場合、AppSettingsExpressionBuilder オブジェクトはページの解析および実行時に Web.config ファイルの値を返します。

使用例

アプリケーション設定値をコンパイルされないページから取得する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" CompilationMode="Never"
 %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
<head runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat=server
 
        Text="<%$ AppSettings: thisSeason %>"
 /> Sale!
    </div>
    </form>
</body>
</html>

C#

<%@ Page Language="C#" CompilationMode="Never" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
<head runat="server">
    <title>Noncompiled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Welcome to the 
        <asp:Literal ID="Literal1" runat=server 
        Text="<%$ AppSettings: thisSeason %>" /> Sale!
    </div>
    </form>
</body>
</html>

このコードは、Web.config ファイルから次の式を取得します。

<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">

<appSettings>

<add key="thisSeason" value="Fall"/>

</appSettings>

</configuration>

.NET Framework のセキュリティ

• AspNetHostingPermission  値の取得に使用します。Minimal (関連する列挙体)

継承階層

System.Object
   System.Web.Compilation.ExpressionBuilder
    System.Web.Compilation.AppSettingsExpressionBuilder

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
AppSettingsExpressionBuilder メンバ
System.Web.Compilation 名前空間
AppSettingsExpressionEditor
ConfigurationManager
AppSettings
CompilationMode
その他の技術情報
ASP.NET 式の概要

AppSettingsExpressionBuilder コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

AppSettingsExpressionBuilder クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New AppSettingsExpressionBuilder

C#

public AppSettingsExpressionBuilder ()

C++

public:
AppSettingsExpressionBuilder ()

J#

public AppSettingsExpressionBuilder ()

JScript

public function AppSettingsExpressionBuilder
 ()

プラットフォーム

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

参照

関連項目
AppSettingsExpressionBuilder クラス
AppSettingsExpressionBuilder メンバ
System.Web.Compilation 名前空間
その他の技術情報
ASP.NET 式の概要

AppSettingsExpressionBuilder プロパティ

パブリック プロパティ

	名前	説明
	SupportsEvaluate	オーバーライドされます。 コンパイルされないページで式を評価できるかどうかを示す値を取得します。

参照

関連項目

AppSettingsExpressionBuilder クラス
System.Web.Compilation 名前空間
AppSettingsExpressionEditor
ConfigurationManager
AppSettings
CompilationMode

その他の技術情報

ASP.NET 式の概要

AppSettingsExpressionBuilder メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	EvaluateExpression	オーバーライドされます。 Web.config ファイルの <appSettings> セクションの値を返します。
	GetAppSetting	オーバーロードされます。 Web.config ファイルの <appSettings> セクションの値を返します。
	GetCodeExpression	オーバーライドされます。 生成されたページ クラスでプロパティの割り当てに使用されるコード式を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ParseExpression	派生クラスでオーバーライドされた場合は、解析された式を表すオブジェクトを返します。 ( ExpressionBuilder から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

AppSettingsExpressionBuilder クラス
System.Web.Compilation 名前空間
AppSettingsExpressionEditor
ConfigurationManager
AppSettings
CompilationMode

その他の技術情報

ASP.NET 式の概要

AppSettingsExpressionBuilder メンバ

宣言式に指定された値を Web.config ファイルの <appSettings> セクションから取得します。

AppSettingsExpressionBuilder データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	AppSettingsExpressionBuilder	AppSettingsExpressionBuilder クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	SupportsEvaluate	オーバーライドされます。 コンパイルされないページで式を評価できるかどうかを示す値を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	EvaluateExpression	オーバーライドされます。 Web.config ファイルの <appSettings> セクションの値を返します。
	GetAppSetting	オーバーロードされます。 Web.config ファイルの <appSettings> セクションの値を返します。
	GetCodeExpression	オーバーライドされます。 生成されたページ クラスでプロパティの割り当てに使用されるコード式を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ParseExpression	派生クラスでオーバーライドされた場合は、解析された式を表すオブジェクトを返します。 (ExpressionBuilder から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

AppSettingsExpressionBuilder クラス
System.Web.Compilation 名前空間
AppSettingsExpressionEditor
ConfigurationManager
AppSettings
CompilationMode

その他の技術情報

ASP.NET 式の概要