AppSettingsExpressionEditor クラス

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

AppSettingsExpressionEditor クラス

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

デザイン時に構成ファイルのアプリケーション設定式を評価および編集するためのプロパティとメソッドを提供します。

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

Visual Basic (宣言)

Public Class AppSettingsExpressionEditor
    Inherits ExpressionEditor

Visual Basic (使用法)

Dim instance As AppSettingsExpressionEditor

C#

public class AppSettingsExpressionEditor :
 ExpressionEditor

C++

public ref class AppSettingsExpressionEditor
 : public ExpressionEditor

J#

public class AppSettingsExpressionEditor extends
 ExpressionEditor

JScript

public class AppSettingsExpressionEditor extends
 ExpressionEditor

解説

AppSettingsExpressionEditor クラスは ExpressionEditor クラスから派生し、デザイン時にアプリケーション設定参照を評価したりコントロール プロパティに関連付けたりするための実装を提供します。たとえば、コントロール プロパティの値をアプリケーション設定式 AppSettings:mySettingKeyName にバインドできます。これは、コントロール プロパティ値が Web 構成 ファイルの appSettings セクションの mySettingKeyName 値を使用して設定されることを示しています。

Visual Studio 2005 などのビジュアル デザイナでは、AppSettingsExpressionEditor クラスを使用して appSettings 構成セクションからアプリケーション設定を選択し、選択された式を評価してデザイン時の描画を行います。

デザイン時プロパティ グリッド内のコントロールの Expressions プロパティを表示するとき、ビジュアル デザイナは、コントロール プロパティの実行時の値を提供する式を設定するためのダイアログ ボックスを表示します。式の型は、式プレフィックスの一覧に基づいて選択できます。AppSettings 式プレフィックスを一覧から選択すると、ビジュアル デザイナ ホストは、対応する ExpressionEditorSheet オブジェクトを使用して、appSettings 式のデザイン時編集機能を提供します。さらに、AppSettingsExpressionEditor メソッドを使用して、アプリケーション設定式の構文に基づいて、式文字列の評価および変換を行います。ビジュアル デザイナ ホストは、評価された式の結果を使用して、デザイン サーフェイス上に描画されるコントロールのプロパティ値を割り当てます。

AppSettingsExpressionEditor オブジェクトの ExpressionPrefix プロパティは、文字列 AppSettings を返します。AppSettingsExpressionBuilder クラスは、式のプレフィックスである AppSettings および AppSettingsExpressionEditor 実装と関連付けられています。

EvaluateExpression メソッドは、入力アプリケーション設定式文字列を評価します。GetExpressionEditorSheet メソッドは、アプリケーション設定式の入力と選択に使用される ExpressionEditorSheet 実装を返します。

使用例

AppSettingsExpressionEditor オブジェクトを使用して HyperLink コントロールの NavigateUrl プロパティをアプリケーション設定式にバインドする方法を次のコード例に示します。

1. Web フォーム プロジェクトで、web.config ファイルの <appSettings> セクションに MyHyperLinkSetting を追加します。

   <appSettings>
       <add key="MyHyperLinkSetting"
    value="http://www.microsoft.com" />
   </appSettings>
   

2. Web フォーム ページで、HyperLink コントロールを追加します。

3. Hyperlink コントロールのプロパティで、[Expressions] をクリックし、省略記号ボタン ([...]) をクリックします。

   [<Hyperlinkname>式] ダイアログ ボックスが表示されます。

4. [バインド可能プロパティ] の [NavigateUrl] をクリックし、[式の型] の一覧で [AppSettings] をクリックしてから、[式のプロパティ] の [AppSetting] ボックスに「MyHyperLinkSetting」と入力します。

ビジュアル デザイナは、AppSettingsExpressionEditor を使用して、NavigateUrl プロパティの式を割り当てます。

次の aspx ソースに、アプリケーション設定式を使用して設定したプロパティ値の例を示します。

Visual Basic

<!-- Define a hyperlink that maps the NavigateUrl property
 to the
     MyHyperLinkSetting value in the Web.Config appSettings section.
 -->
<asp:HyperLink runat="server" ID="HyperLink1"
 
     NavigateUrl="<%$ AppSettings:MyHyperLinkSetting %>">
     HyperLink using an AppSetting expression
</asp:HyperLink>

C#

<!-- Define a hyperlink that maps the NavigateUrl property to the
     MyHyperLinkSetting value in the Web.Config appSettings section.
 -->
<asp:HyperLink runat="server" ID="HyperLink1" 
     NavigateUrl="<%$ AppSettings:MyHyperLinkSetting %>">
     HyperLink using an AppSetting expression
</asp:HyperLink>

継承階層

System.Object
   System.Web.UI.Design.ExpressionEditor
    System.Web.UI.Design.AppSettingsExpressionEditor

スレッド セーフ

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

プラットフォーム

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

参照

関連項目
AppSettingsExpressionEditor メンバ
System.Web.UI.Design 名前空間
Configuration.AppSettings
System.Web.Compilation.AppSettingsExpressionBuilder
System.Web.UI.Design.ExpressionEditorSheet
System.Web.Compilation.ExpressionBuilder
HtmlControlDesigner.Expressions
System.Web.Compilation.ExpressionEditorAttribute
その他の技術情報
appSettings 要素 (全般設定スキーマ)