Поделиться через

Элементы управления редактора для свойств типа поля

  • Статья

Дата последнего изменения: 30 сентября 2009 г.

Применимо к: SharePoint Foundation 2010

Элемент управления редактора для переменных свойств типа поля можно использовать в качестве альтернативы Элемент PropertySchema (Field Types) для отображения свойств поля на страницах Создать столбец сайта, Изменить столбец сайта, Создать столбец и Изменить столбец. Обзор двух вариантов и описание этих методов см. в разделе Отображение свойств настраиваемого типа поля.

Создание элемента управления редактора

Элемент управления редактора определяется в ASCX-файле каталога %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates и в файле фонового кода, которые скомпилированы в одну сборку в виде класса настраиваемого поля. Кроме отображения свойств поля элемент управления редактора также поддерживает создателей столбцов, задающих свойство со специальными функциями (например, со сложной вычислительной логикой, подстановкой значений из источников данных и пользовательской проверкой данных).

Примечание.   Для именования классов элементов управления редактора рекомендуется использовать следующую схему:

имя_типа_поляFieldEditor,

например TargetDateFieldEditor или RegularExpressionFieldEditor. В соответствии с этой схемой ASCX-файл будет называться имя_типа_поляFieldEditor.ascx и будет наследоваться от класса фонового кода имя_типа_поляFieldEditor.

Интерфейс IFieldEditor

Чтобы использоваться в качестве пользовательского элемента управления редактора поля, класс фонового кода должен соответствовать следующим требованиям:

  • Наследоваться от класса UserControl или класса, производного от этого класса.

  • Реализовывать интерфейс IFieldEditor.

Интерфейс IFieldEditor содержит следующие свойства и методы. Щелкните их названия, чтобы получить дополнительные сведения о реализации соответствующего элемента.

  • DisplayAsNewSection.   Это свойство позволяет определить, должен ли элемент управления отображаться в разделе Дополнительные параметры столбца страниц Создать столбец сайта, Изменить столбец сайта, Создать столбец и Изменить столбец или отдельно в новом разделе.

  • OnSaveChange.   Этот метод используется для проверки и сохранения изменений свойств поля или столбца, внесенных создателем или редактором столбца.

  • InitializeWithField.   Этот метод используется для инициализации элемента управления редактора со значениями по умолчанию или с текущими значениями свойств поля (столбца).

См. также

Концепции

Типы настраиваемых полей

Инструкции. Создание настраиваемого класса поля

Практическое руководство. Создание определения настраиваемого типа поля