AppSettingsExpressionBuilderとは何？わかりやすく解説 Weblio辞書

.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

public class AppSettingsExpressionBuilder :
 ExpressionBuilder

C++

public ref class AppSettingsExpressionBuilder
 : public ExpressionBuilder

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>

<%@ 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) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.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

public AppSettingsExpressionBuilder ()

C++

public:
AppSettingsExpressionBuilder ()

public AppSettingsExpressionBuilder ()

JScript

public function AppSettingsExpressionBuilder
 ()

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

AppSettingsExpressionBuilder プロパティ

パブリックプロパティパブリックプロパティ

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

参照

その他の技術情報

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 から継承されます。)

参照

その他の技術情報

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 から継承されます。)