Формы списка
Дата последнего изменения: 8 апреля 2010 г.
Применимо к: SharePoint Foundation 2010
В этой статье
Проверка данных
Настройка действий между полями
Содержание:
Microsoft SharePoint Foundation 2010 предоставляет мощную инфраструктуру форм, позволяющую настраивать существующие формы и элементы управления отображением полей. Формы SharePoint основаны на элементах управления .NET Framework, так что можно использовать или расширять элементы управления полей SharePoint по умолчанию для создания более функциональных форм, повышающих удобство работы с данными SharePoint.
Поля, используемые в формах, также являются элементами управления Microsoft ASP.NET. Можно создать пользовательские поля, расширяющие отображение полей, но наследующие функциональные возможности полей по умолчанию. В SharePoint Foundation используются шаблоны ASP.NET для создания статического HTML-кода, используемого для макета форм и элементов управления полей. Можно настроить существующие шаблоны элементов управления SharePoint или создать новые шаблоны и настроить элементы управления для использования новых шаблонов.
В настройку форм SharePoint включены следующие задачи.
Расширение полей путем создания пользовательских типов полей в файле FldTypes*.xml или пользовательских определений полей в файле Schema.xml. Определения полей задают способ отображения полей в зависимости от режима, другими словами, от того, предназначена ли форма для отображения, изменения или создания элемента списка. Дополнительные сведения о расширении определений полей см. в разделе Типы настраиваемых полей.
Расширение собственных элементов управления полей SharePoint Foundation для отображения полей и проверки данных. Можно создать код программной части, наследующий от элементов управления SharePoint и содержащий определенную логику, необходимую для пользовательских полей формы.
Создание или настройка шаблонов элементов управления для макета страниц форм. Можно определить шаблоны элементов управления, переопределяющие собственные элементы управления.
Примечание |
---|
При создании пользовательских шаблонов отображения форм в среде Microsoft Visual Studio IDE, например путем копирования и вставки кода из файла DefaultFormTemplates.ascx по умолчанию, допустимый код может приводить к ошибкам, которые можно безопасно пропускать. |
Проверка данных
Чтобы проверить правильный тип данных, ранг и т.д., можно предоставить клиентский скрипт для поля для выполнения проверки данных пользователя, или форма может использовать серверный код для выполнения проверки на основе данных на сервере. Можно добавить логику проверки в серверный код следующим образом.
Переопределите метод GetValidatedString в настраиваемом типе поля, который наследуется от Microsoft.SharePoint.SPField (или от другого класса поля, который наследуется от SPField, например SPFieldText). Этот подход обеспечивает проверку данных на уровне объектной модели, затрагивая случаи, в которых пользователи отправляют данные посредством форм, а также случаи, в которых они добавляют или изменяют данные поля прямо через объектную модель.
Переопределите метод Validate, чтобы реализовать логику проверки и установить сообщение об ошибке для ошибок проверки в настраиваемом элементе управления поля, наследующего от Microsoft.SharePoint.WebControls.BaseFieldControl или от особого для типа элемента управления, например TextField. Этот подход выполняется на уровне элемента управления поля и поддерживает только проверку в формах.
Настройка действий между полями
SharePoint Foundation не поддерживает действия между полями, например связывание нескольких полей, так чтобы ввод из одного поля запускал действие в другом поле или группе полей. Однако можно добавить настраиваемые элементы управления полей или элементы управления проверки к настраиваемым формам. В настраиваемых элементах управления доступ к другим элементам управления полей можно получить через свойство FieldControlCollection объекта Microsoft.SharePoint.SPFormContext, которое может быть возвращено через свойство SPContext.FormContext. Затем можно изменить поведение этих элементов управления посредством обратной передачи.
Содержание:
Принцип работы форм SharePoint
Элементы управления форм и полей
Страницы форм элементов списка
Создание настраиваемых шаблонов форм
Переопределение установленного по умолчанию шаблона элемента управления
Создание пользовательского элемента управления для формы