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 クラス」を含む用語の索引
AppSettingsExpressionBuilder クラスのページへのリンク

AppSettingsExpressionBuilder クラスとは？わかりやすく解説