AppSettingsExpressionEditor クラス

定義

名前空間:

System.Web.UI.Design

アセンブリ:

System.Design.dll

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

public ref class AppSettingsExpressionEditor : System::Web::UI::Design::ExpressionEditor

public class AppSettingsExpressionEditor : System.Web.UI.Design.ExpressionEditor

type AppSettingsExpressionEditor = class
    inherit ExpressionEditor

Public Class AppSettingsExpressionEditor
Inherits ExpressionEditor

継承

Object

ExpressionEditor

AppSettingsExpressionEditor

例

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

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

   <FileName>web.config</FileName>
   <RelevantItems>
       <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
   </RelevantItems>
   

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

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

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

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

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

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

<!-- 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>

<!-- 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>

<FileName>ControlsUsingExpressions.aspx</FileName>
<RelevantItems>
    <Reference>System.Web.UI.Design.AppSettingExpressionEditor</Reference>
</RelevantItems>

注釈

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

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

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

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

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

コンストラクター

AppSettingsExpressionEditor()

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

プロパティ

ExpressionPrefix

式エディター実装でサポートされる式文字列を識別する式プレフィックスを取得します。 (継承元 ExpressionEditor)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
EvaluateExpression(String, Object, Type, IServiceProvider)	アプリケーション設定式文字列を評価し、コントロール プロパティのデザイン時の値を提供します。
GetExpressionEditorSheet(String, IServiceProvider)	アプリケーション設定式の式エディター シートを返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• AppSettings
• AppSettingsExpressionBuilder
• ExpressionEditorSheet
• ExpressionBuilder
• Expressions
• ExpressionEditorAttribute