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 定義自訂表達式屬性的

備註

GetExpressionEditorSheet 方法會回傳一個 ExpressionEditorSheet 實作,定義組合成自訂表達式的字串。 視覺設計器使用表達式編輯器表來提示一個或多個字串,這些字串組合成自訂表達式。 基底類別方法會回傳一個預設的表達式編輯器表,該表單使用單一輸入字串來形成表達式。 表達式編輯器表定義了該表達式的屬性網格。 因此,表達式編輯器所暴露的屬性會成為可在對話框中定義的表達式屬性。

從該 ExpressionEditor 類別衍生的類別可選擇性地覆寫該 GetExpressionEditorSheet 方法,提供自訂的表達式編輯器表。 自訂表達式編輯器工作表可允許設計時輸入多個屬性,這些屬性會合併成表達字串。

例如,該 ResourceExpressionEditor 類別源自該 ExpressionEditor 類別,並提供一種實作,用於在設計時評估並關聯資源字串參考與控制屬性。 類別ResourceExpressionBuilder與表達式前綴ResourcesResourceExpressionEditor及實作相關聯。 該 ResourceExpressionEditor.GetExpressionEditorSheet 方法回傳一個 ResourceExpressionEditorSheet,定義構成資源參考表達式的個別屬性。

給繼承者的注意事項

通常,在設計時提供新的表達式類型時,你會定義一個獨特的表達式前綴,並提供自訂 ExpressionBuilderExpressionEditor 實作。 你也可以選擇提供自訂 ExpressionEditorSheet 實作,定義用來形成表達式的屬性。 即使設定檔定義了前綴,你也應該套用一個 ExpressionPrefixAttribute 物件和一個 ExpressionEditorAttribute 物件。

覆寫該 GetExpressionEditorSheet(String, IServiceProvider) 方法,回傳一個定義自訂表達式中多個屬性設計時輸入的表達式編輯器表。 當你選擇控制屬性和表達式編輯器類型時,視覺設計器會呼叫該 GetExpressionEditorSheet(String, IServiceProvider) 方法,然後提供目前為控制屬性設定的表達式字串。 用 expression 來設定表達式屬性的初始值。 可初始 serviceProvider 化自訂表達表建構器,並存取設計主機所提供的服務。 例如,呼叫 GetService(Type) 該方法,並以 IWebApplication 存取透過視覺設計器提供的專案項目、文件或設定檔細節的類型。

適用於

另請參閱