ResourceExpressionEditor クラス

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

ResourceExpressionEditor クラス

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

デザイン時にリソース式の評価と編集を行うためのプロパティとメソッドを提供します。

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

Visual Basic (宣言)

Public Class ResourceExpressionEditor
    Inherits ExpressionEditor

Visual Basic (使用法)

Dim instance As ResourceExpressionEditor

C#

public class ResourceExpressionEditor : ExpressionEditor

C++

public ref class ResourceExpressionEditor :
 public ExpressionEditor

J#

public class ResourceExpressionEditor extends
 ExpressionEditor

JScript

public class ResourceExpressionEditor extends
 ExpressionEditor

解説

ResourceExpressionEditor クラスは ExpressionEditor クラスから派生し、デザイン時にリソース参照を評価したりコントロール プロパティに関連付けたりするための実装を提供します。たとえば、コントロール プロパティの値をリソース式 Resources:submitText にバインドできます。これは、コントロール プロパティ値が submitText という名前のリソースを使用して設定されることを示しています。

Visual Studio 2005 などのビジュアル デザイナ ホストでは、ResourceExpressionEditor クラスを使用してリソース式のリソース クラス、キー、およびデザイナの既定値を指定し、選択したリソース式を評価してデザイン時の描画を行います。

デザイン時のプロパティ グリッドでコントロールの Expressions プロパティを参照すると、ビジュアル デザイナでは、コントロール プロパティの実行時の値を提供する式を設定するためのダイアログ ボックスが表示されます。式の型は、式プレフィックスの一覧に基づいて選択できます。リソース の式プレフィックスを一覧から選択すると、ビジュアル デザイナは、リソース式の構文に基づいて式を設定、評価、および変換するために、ResourceExpressionEditor のメソッドを使用します。ビジュアル デザイナは、評価された式の結果を使用して、デザイン サーフェイス上に描画されるコントロールのプロパティ値を割り当てます。

ResourceExpressionBuilder の基本 ExpressionBuilder.ExpressionPrefix プロパティは、文字列 Resources を返します。ResourceExpressionBuilder クラスは、式のプレフィックスである Resources および ResourceExpressionEditor 実装と関連付けられています。

EvaluateExpression メソッドは、入力リソース式を評価します。GetExpressionEditorSheet メソッドは、リソース名、クラス、およびデザイナの既定値を選択したり、選択したリソース値からリソース式を作成したりするために使用する ExpressionEditorSheet 実装を返します。

使用例

ResourceExpressionEditor クラスを使用して HyperLink コントロールの Text プロパティをリソース式にバインドするコード例を次に示します。

1. Web フォーム プロジェクトで、Strings.resx という名前の新しいリソース ファイルを App_LocalResources ディレクトリに追加します。

2. myLinkText という名前の文字列を Strings.resx リソース ファイルに追加し、HyperLink コントロールのテキストに値を設定します。

   たとえば、myLinkText 文字列値を This is a good link に設定します。

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

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

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

5. [バインド可能プロパティ] の [Text] をクリックし、[式の型] の一覧で、[Resources] を入力します。

   ResourceExpressionEditorSheet クラスで定義されるリソース式のプロパティが表示されます。

6. [式のプロパティ] の [className] を Strings に設定します。これはコンパイルされた Strings.resx リソース ファイルのクラス名です。次に、[ResourceKey] を myLinkText に設定します。これは Strings.resx の文字列の名前です。

ビジュアル デザイナは、ResourceExpressionEditor を使用して、Text プロパティのリソース式を割り当てます。リソース式を使用して設定したプロパティ値の例を次の aspx ソースに示します。

Visual Basic

<!-- Define a hyperlink that maps the Text property to
 the
     myLinkText string value in the Strings.resx
 resource file. -->
<asp:HyperLink runat="server" ID="HyperLink2"
 
     Text="<%$ Resources:Strings, myLinkText%>"
     NavigateUrl="http://www.microsoft.com"></asp:HyperLink>

C#

<!-- Define a hyperlink that maps the Text property to the
     myLinkText string value in the Strings.resx
 resource file. -->
<asp:HyperLink runat="server" ID="HyperLink2" 
     Text="<%$ Resources:Strings, myLinkText %>"
     NavigateUrl="http://www.microsoft.com"></asp:HyperLink>

継承階層

System.Object
   System.Web.UI.Design.ExpressionEditor
    System.Web.UI.Design.ResourceExpressionEditor

スレッド セーフ

この型の 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

参照

関連項目
ResourceExpressionEditor メンバ
System.Web.UI.Design 名前空間
ResourceExpressionEditorSheet
ResourceExpressionBuilder
HtmlControlDesigner.Expressions プロパティ