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 要素 (全般設定スキーマ)

AppSettingsExpressionEditor コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New AppSettingsExpressionEditor

C#

public AppSettingsExpressionEditor ()

C++

public:
AppSettingsExpressionEditor ()

J#

public AppSettingsExpressionEditor ()

JScript

public function AppSettingsExpressionEditor
 ()

解説

AppSettingsExpressionEditor クラスのインスタンスは、ExpressionPrefix プロパティが AppSettings に設定された基本クラスによって構成されます。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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 クラス
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 要素 (全般設定スキーマ)

AppSettingsExpressionEditor プロパティ

パブリック プロパティ

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

参照

関連項目

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 要素 (全般設定スキーマ)

AppSettingsExpressionEditor メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	EvaluateExpression	オーバーライドされます。 アプリケーション設定式文字列を評価し、コントロール プロパティのデザイン時の値を提供します。
	GetExpressionEditor	オーバーロードされます。 式プレフィックスまたは式ビルダに関連付けられている ExpressionEditor 実装を返します。 ( ExpressionEditor から継承されます。)
	GetExpressionEditorSheet	オーバーライドされます。 アプリケーション設定式の式エディタ シートを返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

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 要素 (全般設定スキーマ)

AppSettingsExpressionEditor メンバ

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

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

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

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

パブリック プロパティ

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

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	EvaluateExpression	オーバーライドされます。 アプリケーション設定式文字列を評価し、コントロール プロパティのデザイン時の値を提供します。
	GetExpressionEditor	オーバーロードされます。 式プレフィックスまたは式ビルダに関連付けられている ExpressionEditor 実装を返します。 (ExpressionEditor から継承されます。)
	GetExpressionEditorSheet	オーバーライドされます。 アプリケーション設定式の式エディタ シートを返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

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 要素 (全般設定スキーマ)