ExpressionEditor.GetExpressionEditorSheet(String, IServiceProvider) メソッド

定義

現在の式エディターに関連付けられている式エディター シートを返します。

public:
 virtual System::Web::UI::Design::ExpressionEditorSheet ^ GetExpressionEditorSheet(System::String ^ expression, IServiceProvider ^ serviceProvider);
public virtual System.Web.UI.Design.ExpressionEditorSheet GetExpressionEditorSheet (string expression, IServiceProvider serviceProvider);
abstract member GetExpressionEditorSheet : string * IServiceProvider -> System.Web.UI.Design.ExpressionEditorSheet
override this.GetExpressionEditorSheet : string * IServiceProvider -> System.Web.UI.Design.ExpressionEditorSheet
Public Overridable Function GetExpressionEditorSheet (expression As String, serviceProvider As IServiceProvider) As ExpressionEditorSheet

パラメーター

expression
String

式エディター シートを初期化するために使用する、コントロール プロパティに設定される式文字列。

serviceProvider
IServiceProvider

デザイナー ホストによって提供されるサービス プロバイダーの実装。追加のデザイン時サービスを取得するときに使用されます。

戻り値

ExpressionEditorSheet

カスタム式のプロパティを定義する ExpressionEditorSheet

注釈

このメソッドは GetExpressionEditorSheetExpressionEditorSheet 組み合わせてカスタム式を形成する文字列を定義する実装を返します。 ビジュアル デザイナーは、式エディター シートを使用して、カスタム式に結合する 1 つ以上の文字列の入力を求めます。 基本クラス メソッドは、1 つの入力文字列を使用して式を形成する既定の式エディター シートを返します。 式エディター シートは、式のプロパティ グリッドを定義します。 したがって、式エディターが公開するプロパティは、ダイアログ ボックスの式に対して定義できるプロパティになります。

必要に応じて、クラスから派生する ExpressionEditor クラスは、メソッドを GetExpressionEditorSheet オーバーライドして、カスタム式エディター シートを提供できます。 カスタム式エディター シートでは、複数のプロパティに対するデザイン時の入力を許可できます。これらは組み合わせて式文字列を形成します。

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

注意 (継承者)

通常、デザイン時に新しい式の型を指定するには、一意の式プレフィックスを定義し、カスタム ExpressionBuilderExpressionEditor 実装を指定します。 必要に応じて、式の形成に使用されるプロパティを定義するカスタム ExpressionEditorSheet 実装を提供できます。 構成ファイルはプレフィックスを定義しますが、オブジェクトとオブジェクトも適用 ExpressionPrefixAttribute する ExpressionEditorAttribute 必要があります。

メソッドを GetExpressionEditorSheet(String, IServiceProvider) オーバーライドして、カスタム式の複数のプロパティのデザイン時入力を定義する式エディター シートを返します。 コントロール プロパティと式エディターの種類を選択すると、ビジュアル デザイナーによってメソッドが GetExpressionEditorSheet(String, IServiceProvider) 呼び出され、コントロール プロパティに設定されている現在の式文字列が提供されます。 式プロパティの初期値を設定するために使用 expression します。 カスタム式シート コンストラクターを初期化し、デザイナー ホストによって提供されるサービスにアクセスするために使用 serviceProvider します。 たとえば、ビジュアル デザイナーを GetService(Type) 通じて提供されるプロジェクト項目、ドキュメント、または構成ファイルの詳細にアクセスする型を持つ IWebApplication メソッドを呼び出します。

適用対象

こちらもご覧ください