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.ExpressionEditorSheetPublic Overridable Function GetExpressionEditorSheet (expression As String, serviceProvider As IServiceProvider) As ExpressionEditorSheetПараметры
- expression
- String
Набор строк выражений для свойства элемента управления, используемый для инициализации таблицы редактора выражений.
- serviceProvider
- IServiceProvider
Реализация поставщика службы, предоставленная узелом конструктора, используемым для получения дополнительных служб времени разработки.
Возвращаемое значение
Объект ExpressionEditorSheet, определяющий настраиваемые свойства выражения.
Комментарии
Метод GetExpressionEditorSheet возвращает реализацию ExpressionEditorSheet , которая определяет строки, объединенные для формирования пользовательского выражения. Визуальный конструктор использует лист редактора выражений для запроса одной или нескольких строк, которые объединяются в пользовательское выражение. Метод базового класса возвращает лист редактора выражений по умолчанию, который использует одну входную строку для формирования выражения. Лист редактора выражений определяет сетку свойств для выражения. Таким образом, свойства, предоставляемые редактором выражений, становятся свойствами, которые можно определить для выражения в диалоговом окне.
Классы, ExpressionEditor производные от класса, при необходимости могут переопределить GetExpressionEditorSheet метод для предоставления листа редактора пользовательских выражений. Пользовательский лист редактора выражений может разрешить ввод во время разработки для нескольких свойств, которые объединяются вместе для формирования строки выражения.
Например, ResourceExpressionEditor класс является производным от ExpressionEditor класса и предоставляет реализацию для оценки и связывания ссылки на строку ресурса со свойством элемента управления во время разработки. Класс ResourceExpressionBuilder связан с префиксом Resources выражения и реализацией ResourceExpressionEditor . Метод ResourceExpressionEditor.GetExpressionEditorSheet возвращает значение ResourceExpressionEditorSheet, которое определяет отдельные свойства, формирующее выражение ссылки на ресурсы.
Примечания для тех, кто наследует этот метод
Как правило, для предоставления нового типа выражения во время разработки вы определяете уникальный префикс выражения и предоставляете пользовательские ExpressionBuilder и ExpressionEditor реализации. При необходимости можно предоставить пользовательскую ExpressionEditorSheet реализацию, которая определяет свойства, используемые для формирования выражения. Несмотря на то, что файл конфигурации определяет префикс, следует также применить ExpressionPrefixAttribute объект и ExpressionEditorAttribute объект.
Переопределите GetExpressionEditorSheet(String, IServiceProvider) метод, чтобы вернуть лист редактора выражений, который определяет входные данные времени разработки для нескольких свойств в пользовательском выражении. При выборе свойства элемента управления и типа редактора выражений визуальный конструктор вызывает GetExpressionEditorSheet(String, IServiceProvider) метод, а затем предоставляет текущую строку выражения, заданную для свойства элемента управления. Используется expression для задания начальных значений свойств выражения. Используется serviceProvider для инициализации конструктора настраиваемого листа выражений и доступа к службам, предоставляемым узлом конструктора. Например, вызовите GetService(Type) метод с типом IWebApplication для доступа к элементам проекта, документам или сведениям о файле конфигурации, предоставляемым в визуальном конструкторе.