ExpressionEditor.GetExpressionEditorSheet(String, IServiceProvider) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
回傳與當前表達式編輯器相關聯的表達式編輯器工作表。
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,定義構成資源參考表達式的個別屬性。
給繼承者的注意事項
通常,在設計時提供新的表達式類型時,你會定義一個獨特的表達式前綴,並提供自訂 ExpressionBuilder 與 ExpressionEditor 實作。 你也可以選擇提供自訂 ExpressionEditorSheet 實作,定義用來形成表達式的屬性。 即使設定檔定義了前綴,你也應該套用一個 ExpressionPrefixAttribute 物件和一個 ExpressionEditorAttribute 物件。
覆寫該 GetExpressionEditorSheet(String, IServiceProvider) 方法,回傳一個定義自訂表達式中多個屬性設計時輸入的表達式編輯器表。 當你選擇控制屬性和表達式編輯器類型時,視覺設計器會呼叫該 GetExpressionEditorSheet(String, IServiceProvider) 方法,然後提供目前為控制屬性設定的表達式字串。 用 expression 來設定表達式屬性的初始值。 可初始 serviceProvider 化自訂表達表建構器,並存取設計主機所提供的服務。 例如,呼叫 GetService(Type) 該方法,並以 IWebApplication 存取透過視覺設計器提供的專案項目、文件或設定檔細節的類型。