Masterpage - клас ()

Головна сторінка функціонує як контейнер шаблону і сторінка злиття для сторінок вмісту ввеб-додатку ASP.NET. Головні сторінки забезпечують зручний спосіб для спільного використання структури і вмісту в наборі сторінок вмісту. Для опису розділів головної сторінки можна використовувати местозаполнітелі вмісту, які замінюються вмістом зі сторінок вмісту.

При використанні головної сторінки і пов'язаних з нею сторінок вмісту необхідні теги документа XHTML (такі, як html. Head і body) додаються тільки на головну сторінку. При цьому не створюються додаткові файли типу ASPX (сторінки ASP.NET) в якості окремих веб-сторінок. Сторінки вмісту описують вміст, який вставляється замість местозаполнітелей на головну сторінку.

Якщо під час виконання здійснюється HTTP-запит сторінки, то головна сторінка та сторінки вмісту об'єднуються в один клас з таким же ім'ям, як у сторінок вмісту. Скомпільований результат являє собою об'єднаний клас, що походить від класу Page.

Головна сторінка містить пряму розмітку, серверні і контейнерні елементи управління. Всі елементи розміщені на головній сторінці за межами елемента управління ContentPlaceHolder відображаються на всіх сторінках, які виходять при злитті головної сторінки і сторінок вмісту.

Всі сторінки вмісту, пов'язані з головною сторінкою, повинні посилатися на неї в атрибутах MasterPageFile своїх директив @ Page. Сторінка вмісту може містити тільки директиву @ Page і елементи управління Content. Весь текст, розмітка і серверні елементи управління сторінки повинні розташовуватися в елементах управління Content. Елементи управління ContentPlaceHolder головної сторінки, пов'язані з елементами управління Content. визначаються шляхом завдання властивості ContentPlaceHolderID елемента управління Content.

Під час виконання динамічний вміст з усіх елементів управління Content на запитуваної сторінці об'єднується з головною сторінкою в позиції пов'язаного елемента управління ContentPlaceHolder. Решта розмітка і елементи управління на головній сторінці залишаються без змін. Обробники подій можуть описуватися в головному класі і на сторінці вмісту. Додаткові відомості див. У розділі Події на головних сторінках і сторінках вмісту ASP.NET.

Клас MasterPage пов'язаний з файлами з розширенням MASTER. Ці файли компілюються під час виконання як об'єкти MasterPage і кешуються в пам'яті сервера.

Доступ сторінок вмісту до головної сторінки забезпечується за допомогою властивості Master базового класу Page. Властивість Master повертає екземпляр головної сторінки, який Типізуються як базовий клас MasterPage. Для доступу до елементів управління, властивостями і функцій головної сторінки властивість Master може бути приведено до об'єкта MasterPage. Ім'я класу головної сторінки описується з використанням атрибута ClassName директиви @ Master.

Директиви головної сторінки не переважають директив окремих сторінок вмісту.

Головні сторінки найбільш часто створюються декларативно. При програмному створенні головної сторінки вона відбувається прямо з класу MasterPage. Крім розширення класу MasterPage необхідно створити головний файл для візуального відображення інтерфейсу користувача, пов'язаного з класами, викликаними в вихідному файлі.

Якщо головна сторінка створюється шляхом первісного створення нового класу, то повинні бути включені всі простори імен, які потрібні для класів, які використовуються сторінкою.

Додаткові відомості про головних сторінках містяться в розділі Загальні відомості про головних сторінках ASP.NET.

Схожі статті