ExpressionEditorSheet クラス

  • リファレンス

定義

名前空間:
System.Web.UI.Design
アセンブリ:
System.Design.dll

カスタム式のデザイン時エディター シートを表します。 このクラスは継承できません。

public ref class ExpressionEditorSheet abstract
public abstract class ExpressionEditorSheet
type ExpressionEditorSheet = class
Public MustInherit Class ExpressionEditorSheet
継承
Object
ExpressionEditorSheet
派生

注釈

カスタム式エディター シートを使用すると、開発者はデザイン時にカスタム式のプロパティを設定できます。 コントロール プロパティの値は、式文字列を使用して設定できます。式文字列は、実行時に式ビルダーによって評価され、デザイン時には式エディターによって評価されます。

デザイン時プロパティ グリッドでコントロールの Expressions プロパティを参照すると、ビジュアル デザイナーによってダイアログ ボックスが表示され、コントロール プロパティの値を指定する式が設定されます。 式のプレフィックスの一覧に基づいて式の種類を選択できます。 一覧から式プレフィックスを選択すると、ビジュアル デザイナーは、関連付けられた ExpressionEditor オブジェクトと ExpressionEditorSheet オブジェクトを使用して、その型の式の構文に基づいて式文字列を評価および変換します。 ビジュアル デザイナーは、式エディター シートのプロパティを使用して、カスタム式文字列に結合する 1 つ以上の文字列の入力を求めます。

通常、デザイン時に新しい式の型を指定するには、一意の式プレフィックスを定義し、カスタム ExpressionBuilder と ExpressionEditor 実装を提供します。 必要に応じて、式の形成に使用されるプロパティを定義するカスタム ExpressionEditorSheet 実装を提供できます。 式プレフィックスを式ビルダーと式エディターに関連付けるには、属性と属性をExpressionPrefixAttributeカスタム ExpressionBuilder クラスに適用ExpressionEditorAttributeし、Web 構成ファイルの 要素で式ビルダーのexpressionBuilders式プレフィックスを構成します。

メソッドの既定の GetExpressionEditorSheet 実装では、1 つの入力文字列を使用して式を形成する基本的なエディター シートが返されます。 から ExpressionEditor 派生したカスタム式エディターは、 メソッドを GetExpressionEditorSheet オーバーライドして、カスタム エディター シートの実装を返すことができます。 通常、カスタム エディター シートには、式文字列の作成に使用される複数のプロパティが含まれています。 メソッドは GetExpression 、現在の式プロパティに基づいて結果の式文字列を返します。

たとえば、 クラスは ResourceExpressionEditor クラスから ExpressionEditor 派生し、デザイン時にリソース文字列参照をコントロール プロパティに評価および関連付ける実装を提供します。 クラスは ResourceExpressionBuilder 、式プレフィックス Resources と実装に ResourceExpressionEditor 関連付けられます。 メソッドは GetExpressionEditorSheet を ResourceExpressionEditorSheet返します。これは、リソース参照式を形成する個々のプロパティを定義します。

クラスから継承する場合は、次の ExpressionEditorSheet メンバーをオーバーライドする必要があります。

  • GetExpressionEditorSheetカスタム エディター シートの実装を返すメソッド。

  • ExpressionEditorSheet式エディター シート実装用のカスタム初期化アクションを実装するコンストラクター。

注意 (実装者)

コントロール プロパティ値の新しい式の種類を定義し、複数の式プロパティ値に基づいて式文字列を作成する場合は、 クラスから ExpressionEditorSheet カスタム式エディター シートを派生させます。 派生クラスの実装には、次のものが含まれている必要があります。

  • デザイン時に設定できる式文字列内の各個別の値のパブリック プロパティ。

  • エディター シートの GetExpression() プロパティ値からカスタム式文字列を形成する メソッドの実装。

  • 必要に応じて、エディター シートのプロパティの初期値を設定するコンストラクターの実装。

関連付けられたカスタム式エディター クラスは、 メソッドに派生エディター シートのインスタンスを GetExpressionEditorSheet(String, IServiceProvider) 作成し、そのインスタンスをコントロール プロパティに設定された現在の式文字列で初期化し、そのインスタンスをビジュアル デザイナーに返します。 ビジュアル デザイナーを使用すると、式シートのプロパティを設定し、 メソッドを GetExpression() 呼び出して、入力式シートのプロパティ値から式文字列を形成できます。

コンストラクター

ExpressionEditorSheet(IServiceProvider)

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

プロパティ

IsValid

式文字列が有効かどうかを示す値を取得します。
ServiceProvider

式エディター シートによって使用されるサービス プロバイダー実装を取得します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetExpression()

派生クラスでオーバーライドされると、式エディター シートのプロパティ値によって作成される式文字列を返します。
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

適用対象

こちらもご覧ください