Программный продукт «QP8.Framework» (стр. 16 )

}

return Json(result, JsonRequestBehavior. AllowGet);

}

}

и роута для него:

routes. MapRoute(

name: "TestValidation",

url: "RemoteValidation/{validatorKey}",

defaults: new { controller = "TestValidation", action = "Validate" }

);

Шаблон, страница, объект, формат

Внимание: объекты ветви «Шаблон» являются устаревшими (не рекомендуется использовать для разработки новых Систем; используются для сопровождения Систем, основанных на предыдущих версиях продукта).

Добавление нового шаблона возможно с помощью:

ГПИ бэкэнда (сущность «Сайт» → сущность «Шаблон» → список шаблонов → команда «Добавить новый шаблон»); Команды «Новый шаблон» контекстного меню, вызванного для сущности «Шаблон».

Контекстное меню, вызванное для определенного шаблона, содержит команды:

«Удалить». Команда удаляет шаблон после ее подтверждения; «Свойства». Команда открывает вкладку со свойствами шаблона.

Ветвь иерархии объектов QP служит для организации кода для веб-сайта с использованием бекэнда.

Название	Описание
Шаблон (Template)	Предназначен для объединения страниц, имеющих одинаковое или похожее оформление и для хранения общих настроек страниц и объектов, которые он содержит. Также имеет собственный код, который выполняется в самом начале выполнения страницы. Обычно содержит вызовы одного или нескольких объектов шаблона.
Страница (Page)	Веб-страница (ASP или ASPX), которая будет создана в результате процесса сборки.
Объект (Object)	Минимальный элемент, из набора которых собираются страницы. В сборке каждый объект собирается в пользовательский элемент управления (ASCX). С точки зрения сборки шаблон также является обычным элементом управления (ASCX), при этом он вызывается первым. Отличие страниц друг от друга определяется набором объектов, которые они используют. Объекты могут быть объектами страницы или шаблона. Разница между ними в области видимости: объекты страницы можно вызвать только на данной странице, объекты шаблона – на любой странице данного шаблона, а также с помощью специального формата вызова из других шаблонов. Объект страницы может переопределить объект шаблона. Это означает, что у них будут одинаковые имена и при вызове объекта по имени будет вызван объект страницы, а не объект шаблона.
Формат (Format)	Каждый объект может иметь несколько модификаций (форматов), которые вызываются пользовательским кодом в зависимости от условий. Каждый объект должен иметь минимум один формат. Основная часть пользовательского кода содержится именно в форматах (и небольшая часть в шаблонах). Формат, созданный первым, становится форматом по умолчанию.

Концепция разделения кода аналогична . В шаблоне и формате допускается задание:

Название	Описание
Presentation	Содержит разметку
Code Behind	Содержит логику отображения

Объекты можно вызывать как из Presentation, так и из Code Behind, но синтаксис вызовов будет различаться.

В ASP-сборке разделение кода отсутствует.

Шаблон

Шаблоны и объекты, которые они содержат, определяют внешний вид и разметку страниц сайта. Управление шаблонами осуществляется в бекэнде в разделе «Шаблоны» (Templates) сайта.

В ГПИ бэкенда доступны следующие функции управления шаблонами:

создание нового шаблона, сборка шаблона, изменение свойств шаблона, удаление шаблона.

Создание шаблона

Создание шаблона выполняется одним из следующих способов:

выбрать раздел «Шаблоны», нажать «Добавить новый шаблон» (New Template); в контекстном меню раздела «Шаблоны» выбрать пункт «Новый шаблон» (New Template).

Свойства шаблона

Собственные свойства

Название	Описание
Имя (Name)	Алфавитно-цифровое имя шаблона. Используется в ГПИ. Название должно быть уникальным в пределах сайта. Также оно не должно совпадать с названием какого-либо объекта этого шаблона, чтобы обеспечить корректность вызовов.
Имя. NET-класса (.NET Class Name)	Используется для создания. NET-класса. Если значение поля «Название шаблона» содержит только английские буквы, цифры и пробелы, то значение данного свойства будет сгенерировано автоматически. Для ASP-сборки поле отсутствует.
Описание (Description)	Произвольное описание шаблона.
Язык. NET (.NET Language)	Выбор языка для разработки Code Behind. Доступны: C# (используется по умолчанию), . Для ASP-сборки поле отсутствует. Примечание: объекты шаблона наследуют значение этого поля.
Имя папки (Folder name)	Выбор отдельной директории для данных шаблона. Путь задаётся относительно корневой директории веб-сайта. Если директория не существует, она создается.
Максимальное число хранимых версий форматов (Max Number of Format Stored Versions)	Количество версий для форматов шаблона.
Посылать заголовок No-Cache (Send No-Cache header)	Указатель, требуется ли передавать значение no-cache в HTTP-заголовках.
Формат (Format)	Используется для генерации пользовательского элемента управления шаблоном, который будет загружаться первым на странице. Содержит поля ввода кода для: Presentation, Code Behind.

Групповые свойства

Относятся в большей степени к объектам QP, для которых шаблон является контейнером (страницы, объекты).

Свойство ViewState

Название	Описание
Разрешить ViewState (Enable ViewState)	Указатель, требуется ли использовать механизм ViewState для элемента управления шаблоном. По умолчанию опция включена по всей иерархии.
Применить к существующим страницам и объектам (Apply To Existing Pages and Objects)	Опция используется, чтобы изменить настройки по всей иерархии. Отключить ViewState также возможно на уровне страниц и объектов. Примечание: отключение ViewState на верхнем уровне иерархии блокирует все нижние уровни независимо от их собственных настроек.

Связывание с данными (Data Binding)

Название	Описание
Отключить автоматическое связывание с данными (Disable Auto Data Binding)	По умолчанию опция выключена для всей иерархии. Изменение опции отключает вызов метода DataBind для элемента управления шаблоном.
Применить к существующим объектам (Apply To Existing Objects)	Опция используется, чтобы изменить настройки по всей иерархии. Отключить связывание с данными также можно на уровне объектов.

Наследование

«Наследование страниц» (Pages Inheritance) и «Наследование контролов» (Controls Inheritance) – набор свойств, обеспечивающий расширение функциональных возможностей страниц и элементов управления QP. Предполагается, что разработчик напишет свою. NET-сборку (которую затем поместит в директорию bin веб-сайта), а в ней он унаследует свои классы от базовых классов QP:

«Страница» – от класса QPage, «Шаблон» – от класса QUserControl, Объект типа «Generic» – от класса QUserControl, Объект типа «Publishing Container» – от класса QPublishControl.

Для того, чтобы в дальнейшем использовать новые классы, при сборке необходимо указать имена этих классов. Настройки наследования уровня шаблона могут быть переопределены на уровне страницы или уровне объекта.

Кроме того, при использовании собственных классов обычно бывает необходимо добавить свои пространства имён, что может быть достигнуто с помощью опции «Дополнительные пространства имён» (Additional Namespaces).

Стоит отметить, что необязательно наследовать все классы: для большинства задач хватает только нового класса для страниц.

Региональные и языковые настройки (Regional and Language Settings)

Название	Описание
Набор символов (Charset)	Выбор набора допустимых символов, которые могут использоваться на страницах шаблона. Влияет на процесс сборки: в БД код и данные контентов хранятся в UTF-8, а при генерации файлов используется выбранный пользователем набор символов. Рекомендуется использовать UTF-8.
Локализация (Locale)	Выбор правил форматирования для чисел, дат, денежных величин.

Сборка шаблона

Сборка осуществляется из свойств шаблона и его объектов:

если шаблон пустой (нет страниц), то собираются все объекты шаблона; если в шаблоне есть страницы, то проводится сборка страниц шаблона (по алгоритму сборки нескольких страниц).

Также выполняется сборка уведомлений шаблона.

Для сборки шаблона в списке шаблонов следует выбрать требуемый шаблон, нажать «Собрать».

Изменение свойств шаблона

Изменение свойств шаблона выполняется одним из следующих способов:

в контекстном меню шаблона выбрать пункт «Свойства» (Properties), в списке шаблонов выбрать требуемый шаблон и нажать кнопку «Свойства» (Properties).

Удаление шаблона

Удаление шаблона выполняется одним из следующих способов:

в контекстном меню шаблона выбрать пункт «Удалить» (Remove), в списке шаблонов выбрать требуемый шаблон и нажать кнопку «Удалить» (Remove). Страница

Свойства страницы

Общие свойства (Basic parameters)

Название	Описание
Имя (Name)	Имя страницы.
Имя файла (File Name)	Имя файла со страницей.
Описание (Description)	Описание страницы.
Пользовательский класс (Custom class)	Имя пользовательского класса.
Имя папки (Folder Name)	Позволяет задать отдельную директорию для данных страницы. Путь задаётся относительно корневой директории веб-сайта. Если директория не существует, она создается.

Свойства ViewState

Название	Описание
Разрешить ViewState (Enable ViewState)	Указатель, требуется ли использовать механизм ViewState для страницы.
Применить к существующим объектам (Apply to existing objects)	Опция используется, чтобы изменить настройки по всей иерархии. Отключить ViewState также возможно на уровне страниц и объектов. Примечание: отключение ViewState на верхнем уровне иерархии блокирует все нижние уровни независимо от их собственных настроек.

Кэширование

Название	Описание
Посылать заголовок No-Cache (Send No-Cache header)	Указатель, требуется ли передавать значение no-cache в HTTP-заголовках.
Посылать заголовок Last-Modified (Send Last-Modified header)	Указатель, требуется ли передавать значение Last-Modified в HTTP-заголовках.
Кэширование на proxy (Proxy caching)	Указатель, что следует выполнять кэширование на прокси-сервере.
Кэширование в браузере (Browser Caching)	Указатель, что следует выполнять кэширование в браузере.
Истекает через (ч.)	Срок годности данных в кэше.

Региональные и языковые настройки (Regional and Language Settings)

Название	Описание
Набор символов (Charset)	Выбор набора допустимых символов, которые могут использоваться на страницах шаблона. Влияет на процесс сборки: в БД код и данные контентов хранятся в UTF-8, а при генерации файлов используется выбранный пользователем набор символов. Рекомендуется использовать UTF-8.
Локализация (Locale)	Выбор правил форматирования для чисел, дат, денежных величин.

Сборка страницы

Сборка требуемого набора страниц осуществляется кнопкой «Собрать» (Assemble).