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

定義

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

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

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 。

注釈

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

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

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

注意 (継承者)

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

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

適用対象

こちらもご覧ください