MasterPage Класс

Определение

Пространство имен:: System.Web.UI

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class MasterPage : System::Web::UI::UserControl

public class MasterPage : System.Web.UI.UserControl

type MasterPage = class
    inherit UserControl

Public Class MasterPage
Inherits UserControl

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

Control

TemplateControl

UserControl
MasterPage

Примеры

В этом разделе содержатся четыре примера кода:

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

В следующем примере показано, как создать главную страницу декларативно и добавить в нее некоторое содержимое с помощью страницы содержимого. Первая веб-страница — это эталонная MasterPageSample_1.masterстраница.

<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
    </div>
    </form>
</body>
</html>

<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
    </div>
    </form>
</body>
</html>

В следующем примере представлена страница содержимого, связанная с MasterPageSample_1.master. Он содержит Content элемент управления и определяет ContentPlaceHolder элемент управления, с которым связано содержимое с помощью ContentPlaceHolderID свойства.

<%@ Page Language="C#" MasterPageFile="~/MasterPageSample_1cs.master" Title="Content Page"%>

<asp:content
    runat="server"
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>

<%@ Page Language="VB" MasterPageFile="~/MasterPageSample_1vb.master" Title="Content Page"%>

<asp:content
    runat="server"
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>

В следующем примере показано, как добавить свойство на главную страницу. Атрибут ClassName используется для имени главной страницы.

<%@ Master Language="C#" ClassName="MasterExample" %>

<script runat="server">
        public string SiteName
        {
            get { return "My Site Name"; }
        }
</script>

<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
        </asp:contentplaceholder>
    </div>
    </form>
</body>
</html>

<%@ Master Language="VB" ClassName="MasterExample" %>

<script runat="server">
  Public ReadOnly Property SiteName() As String
    Get
      Return "My Site Name"
    End Get
  End Property

</script>

<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
        </asp:contentplaceholder>
    </div>
    </form>
</body>
</html>

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

<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>

<script runat="server">
  protected void Page_Load(object sender, EventArgs e)
  {
    MasterExample m = (MasterExample)Page.Master;
    mylabel.Text = m.SiteName;
  }
</script>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
    Hello, Master Pages!
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>

<%@ Page Language="VB" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim m As MasterExample = CType(Page.Master, MasterPage)
    mylabel.Text = m.SiteName
  End Sub
</script>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
    Hello, Master Pages!
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>

Эталонная страница работает в качестве контейнера шаблона и страницы слияния для страниц содержимого в веб-приложении ASP.NET. Главные страницы предоставляют удобный способ совместного использования структуры и содержимого в наборе страниц контента. Заполнители контента используются для определения разделов главной страницы для замены содержимого на страницах содержимого.

При использовании главной страницы и связанных страниц содержимого необходимо добавить необходимые теги документов XHTML (напримерhtml, и headbody) только на эталонную страницу и больше не создавать другие .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 .

Замечание

Файлы с расширениями MASTER не обслуживаются в браузере.

Директивы, допустимые на главной странице, совпадают с теми, которые доступны в объекте UserControl . Они могут включать следующие атрибуты:

AutoEventWireup
ClassName
CodeFile
CompilerMode
CompilerOptions
Debug
Description
EnableTheming
EnableViewState
Explicit
Inherits
Language
LinePragmas
MasterPageFile
Src
Strict
WarningLevel

Директивы главной страницы не переопределяют директивы на отдельных страницах содержимого.

Главные страницы чаще всего создаются декларативно. Если вы хотите создать эталонную страницу программным способом, наследуйте его непосредственно от MasterPage класса. Помимо расширения MasterPage класса, необходимо создать master-файл для визуального отображения пользовательского интерфейса, связанного с классами, которые были вызваны в исходном файле.

Замечание

При создании главной страницы путем создания собственного класса сначала необходимо включить все пространства имен, необходимые для классов, используемых страницей.

Дополнительные сведения о главных страницах см. в ASP.NET главных страницах.

Конструкторы

Имя	Описание
MasterPage()	Создает новый экземпляр MasterPage класса.

Свойства

Имя	Описание
Adapter	Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control)
Application	Application Возвращает объект для текущего веб-запроса. (Унаследовано от UserControl)
AppRelativeTemplateSourceDirectory	Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control)
AppRelativeVirtualPath	Возвращает или задает путь относительного приложения, виртуального каталога к файлу, из которого элемент управления анализируется и компилируется. (Унаследовано от TemplateControl)
Attributes	Возвращает коллекцию всех пар атрибутов и значений, объявленных в теге пользовательского элемента управления в файле .aspx. (Унаследовано от UserControl)
AutoHandlers	Устаревшие.. Свойство AutoHandlers устарело в ASP.NET NET 2.0. Он используется созданными классами и не предназначен для использования в коде. (Унаследовано от TemplateControl)
BindingContainer	Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control)
Cache	Cache Возвращает объект, связанный с приложением, содержащим элемент управления пользователем. (Унаследовано от UserControl)
CachePolicy	Возвращает ссылку на коллекцию параметров кэширования для этого пользовательского элемента управления. (Унаследовано от UserControl)
ChildControlsCreated	Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control)
ClientID	Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control)
ClientIDMode	Возвращает или задает алгоритм, используемый для создания значения ClientID свойства. (Унаследовано от Control)
ClientIDSeparator	Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control)
ContentPlaceHolders	Возвращает список элементов управления, которые эталонная ContentPlaceHolder страница использует для определения различных регионов контента.
ContentTemplates	Возвращает список элементов управления содержимым, связанных с главной страницей.
Context	HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control)
Controls	ControlCollection Возвращает объект, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от Control)
DataItemContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control)
DataKeysContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control)
DesignMode	Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control)
EnableTheming	Возвращает или задает логическое значение, указывающее, применяются ли темы к элементу управления, производным TemplateControl от класса. (Унаследовано от TemplateControl)
EnableViewState	Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control)
Events	Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control)
HasChildViewState	Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control)
ID	Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control)
IdSeparator	Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control)
IsChildControlStateCleared	Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control)
IsPostBack	Возвращает значение, указывающее, загружается ли элемент управления пользователем в ответ на обратную передачу клиента или когда он загружается и обращается в первый раз. (Унаследовано от UserControl)
IsTrackingViewState	Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control)
IsViewStateEnabled	Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control)
LoadViewStateByID	Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control)
Master	Возвращает родительскую главную страницу текущего главного элемента в сценариях вложенных главных страниц.
MasterPageFile	Возвращает или задает имя главной страницы, содержащей текущее содержимое.
NamingContainer	Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control)
Page	Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control)
Parent	Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control)
RenderingCompatibility	Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control)
Request	HttpRequest Возвращает объект для текущего веб-запроса. (Унаследовано от UserControl)
Response	HttpResponse Возвращает объект для текущего веб-запроса. (Унаследовано от UserControl)
Server	HttpServerUtility Возвращает объект для текущего веб-запроса. (Унаследовано от UserControl)
Session	HttpSessionState Возвращает объект для текущего веб-запроса. (Унаследовано от UserControl)
Site	Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control)
SkinID	Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от Control)
SupportAutoEvents	Возвращает значение, указывающее, поддерживает ли TemplateControl элемент управления автоматические события. (Унаследовано от TemplateControl)
TemplateControl	Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control)
TemplateSourceDirectory	Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control)
Trace	TraceContext Возвращает объект для текущего веб-запроса. (Унаследовано от UserControl)
UniqueID	Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control)
ValidateRequestMode	Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control)
ViewState	Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control)
ViewStateIgnoresCase	Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control)
ViewStateMode	Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control)
Visible	Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде пользовательского интерфейса на странице. (Унаследовано от Control)

Методы

Имя	Описание
AddContentTemplate(String, ITemplate)	Добавляет элемент управления в Content ContentTemplates словарь.
AddedControl(Control, Int32)	Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control)
AddParsedSubObject(Object)	Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control)
ApplyStyleSheetSkin(Page)	Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)	Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control)
BuildProfileTree(String, Boolean)	Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control)
ClearCachedClientID()	Задает кэшированное ClientID значение `null`. (Унаследовано от Control)
ClearChildControlState()	Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildState()	Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildViewState()	Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearEffectiveClientIDMode()	ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control)
Construct()	Выполняет логику времени разработки. (Унаследовано от TemplateControl)
CreateChildControls()	Вызывается платформой страницы ASP.NET, чтобы уведомить серверные элементы управления, использующие реализацию на основе композиции, чтобы создать все дочерние элементы управления, содержащиеся в подготовке к публикации обратной или отрисовки. (Унаследовано от Control)
CreateControlCollection()	Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от Control)
CreateResourceBasedLiteralControl(Int32, Int32, Boolean)	Обращается к литеральным строкам, хранящимся в ресурсе. Метод CreateResourceBasedLiteralControl(Int32, Int32, Boolean) не предназначен для использования из кода. (Унаследовано от TemplateControl)
DataBind()	Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. (Унаследовано от Control)
DataBind(Boolean)	Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control)
DataBindChildren()	Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control)
DesignerInitialize()	Выполняет все шаги инициализации пользовательского элемента управления, необходимые конструкторам RAD. (Унаследовано от UserControl)
Dispose()	Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control)
EndRenderTracing(TextWriter, Object)	Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control)
EnsureChildControls()	Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control)
EnsureID()	Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Eval(String, String)	Вычисляет выражение привязки данных с помощью указанной строки формата для отображения результата. (Унаследовано от TemplateControl)
Eval(String)	Вычисляет выражение привязки данных. (Унаследовано от TemplateControl)
FindControl(String, Int32)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным `id` и целым числом, указанным в `pathOffset` параметре, который помогает в поиске. Эту версию FindControl метода не следует переопределять. (Унаследовано от Control)
FindControl(String)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным `id` параметром. (Унаследовано от Control)
Focus()	Задает фокус ввода элементу управления. (Унаследовано от Control)
FrameworkInitialize()	Инициализирует элемент управления, производный TemplateControl от класса. (Унаследовано от TemplateControl)
GetDesignModeState()	Возвращает данные во время разработки для элемента управления. (Унаследовано от Control)
GetGlobalResourceObject(String, String, Type, String)	Возвращает объект ресурса уровня приложения на основе указанных ClassKey и ResourceKey свойств, типа объекта и имени свойства ресурса. (Унаследовано от TemplateControl)
GetGlobalResourceObject(String, String)	Возвращает объект ресурса уровня приложения на основе указанных ClassKey и ResourceKey свойств. (Унаследовано от TemplateControl)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLocalResourceObject(String, Type, String)	Возвращает объект ресурса уровня страницы на основе указанного ResourceKey свойства, типа объекта и имени свойства. (Унаследовано от TemplateControl)
GetLocalResourceObject(String)	Возвращает объект ресурса уровня страницы на основе указанного ResourceKey свойства. (Унаследовано от TemplateControl)
GetRouteUrl(Object)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(String, Object)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetUniqueIDRelativeTo(Control)	Возвращает префиксированную часть UniqueID свойства указанного элемента управления. (Унаследовано от Control)
HasControls()	Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от Control)
HasEvents()	Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control)
InitializeAsUserControl(Page)	Инициализирует UserControl объект, созданный декларативно. Так как между страницами и пользовательскими элементами управления существуют некоторые различия, этот метод гарантирует правильное инициализацию пользовательского элемента управления. (Унаследовано от UserControl)
InstantiateInContentPlaceHolder(Control, ITemplate)	Предоставляет метод для задания текущего элемента управления шаблоном на страницу, которая владеет главной страницей.
IsLiteralContent()	Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control)
LoadControl(String)	Control Загружает объект из файла на основе указанного виртуального пути. (Унаследовано от TemplateControl)
LoadControl(Type, Object[])	Control Загружает объект на основе заданных параметров типа и конструктора. (Унаследовано от TemplateControl)
LoadControlState(Object)	Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState() . (Унаследовано от Control)
LoadTemplate(String)	Получает экземпляр ITemplate интерфейса из внешнего файла. (Унаследовано от TemplateControl)
LoadViewState(Object)	Восстанавливает сведения о состоянии представления из предыдущего запроса пользовательского элемента управления, сохраненного методом SaveViewState() . (Унаследовано от UserControl)
MapPath(String)	Назначает путь к виртуальному файлу ( абсолютный или относительный) физическому пути к файлу. (Унаследовано от UserControl)
MapPathSecure(String)	Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnAbortTransaction(EventArgs)	Вызывает событие AbortTransaction. (Унаследовано от TemplateControl)
OnBubbleEvent(Object, EventArgs)	Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control)
OnCommitTransaction(EventArgs)	Вызывает событие CommitTransaction. (Унаследовано от TemplateControl)
OnDataBinding(EventArgs)	Вызывает событие DataBinding. (Унаследовано от Control)
OnError(EventArgs)	Вызывает событие Error. (Унаследовано от TemplateControl)
OnInit(EventArgs)	Вызывает событие Init. (Унаследовано от UserControl)
OnLoad(EventArgs)	Вызывает событие Load. (Унаследовано от Control)
OnPreRender(EventArgs)	Вызывает событие PreRender. (Унаследовано от Control)
OnUnload(EventArgs)	Вызывает событие Unload. (Унаследовано от Control)
OpenFile(String)	Возвращает используемый Stream для чтения файла. (Унаследовано от Control)
ParseControl(String, Boolean)	Анализирует входную строку в Control объект на веб-странице ASP.NET или пользовательском элементе управления. (Унаследовано от TemplateControl)
ParseControl(String)	Анализирует входную строку в Control объект на странице веб-форм или пользовательском элементе управления. (Унаследовано от TemplateControl)
RaiseBubbleEvent(Object, EventArgs)	Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control)
ReadStringResource()	Считывает строковый ресурс. Метод ReadStringResource() не предназначен для использования из кода. (Унаследовано от TemplateControl)
RemovedControl(Control)	Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control)
Render(HtmlTextWriter)	Отправляет содержимое элемента управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control)
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control)
RenderControl(HtmlTextWriter)	Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control)
ResolveAdapter()	Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control)
SaveControlState()	Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control)
SaveViewState()	Сохраняет все изменения состояния представления пользовательского элемента управления, которые произошли с момента последней публикации страницы. (Унаследовано от UserControl)
SetDesignModeState(IDictionary)	Задает данные во время разработки для элемента управления. (Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)	Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control)
SetStringResourcePointer(Object, Int32)	Задает указатель на строковый ресурс. Метод SetStringResourcePointer(Object, Int32) используется созданными классами и не предназначен для использования из кода. (Унаследовано от TemplateControl)
SetTraceData(Object, Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
TestDeviceFilter(String)	Возвращает логическое значение, указывающее, применяется ли фильтр устройства к HTTP-запросу. (Унаследовано от TemplateControl)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Вызывает отслеживание изменений состояния представления в серверном элементе управления, чтобы они могли храниться в объекте серверного элемента управления StateBag . Этот объект доступен через ViewState свойство. (Унаследовано от Control)
TryUpdateModel<TModel>(TModel, IValueProvider)	Пытается обновить экземпляр модели, используя значения от поставщика значений. (Унаследовано от UserControl)
TryUpdateModel<TModel>(TModel)	Пытается обновить экземпляр модели с помощью значений из элемента управления, привязанного к данным. (Унаследовано от UserControl)
UpdateModel<TModel>(TModel, IValueProvider)	Обновляет указанный экземпляр модели, используя значения от поставщика значений пользовательского элемента управления. (Унаследовано от UserControl)
UpdateModel<TModel>(TModel)	Обновляет экземпляр модели с помощью значений из элемента управления с привязкой к данным. (Унаследовано от UserControl)
WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)	Записывает строку ресурса в HtmlTextWriter элемент управления. Метод WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) используется созданными классами и не предназначен для использования из кода. (Унаследовано от TemplateControl)
XPath(String, IXmlNamespaceResolver)	Вычисляет выражение привязки данных XPath с помощью указанных префиксов и сопоставлений пространств имен для разрешения пространства имен. (Унаследовано от TemplateControl)
XPath(String, String, IXmlNamespaceResolver)	Вычисляет выражение привязки данных XPath с помощью указанных префиксов и сопоставлений пространств имен для разрешения пространства имен и указанной строки формата для отображения результата. (Унаследовано от TemplateControl)
XPath(String, String)	Вычисляет выражение привязки данных XPath с помощью указанной строки формата для отображения результата. (Унаследовано от TemplateControl)
XPath(String)	Вычисляет выражение привязки данных XPath. (Унаследовано от TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)	Вычисляет выражение привязки данных XPath с помощью указанных префиксов и сопоставлений пространств имен для разрешения пространства имен и возвращает коллекцию узлов, реализующую IEnumerable интерфейс. (Унаследовано от TemplateControl)
XPathSelect(String)	Вычисляет выражение привязки данных XPath и возвращает коллекцию узлов, реализующую IEnumerable интерфейс. (Унаследовано от TemplateControl)

События

Имя	Описание
AbortTransaction	Происходит, когда пользователь завершает транзакцию. (Унаследовано от TemplateControl)
CommitTransaction	Происходит при завершении транзакции. (Унаследовано от TemplateControl)
DataBinding	Происходит, когда серверный элемент управления привязывается к источнику данных. (Унаследовано от Control)
Disposed	Происходит при освобождении серверного элемента управления из памяти, который является последним этапом жизненного цикла управления сервера при запросе страницы ASP.NET. (Унаследовано от Control)
Error	Возникает при возникновении необработанного исключения. (Унаследовано от TemplateControl)
Init	Происходит при инициализации серверного элемента управления, который является первым шагом в его жизненном цикле. (Унаследовано от Control)
Load	Происходит при загрузке серверного элемента управления в Page объект. (Унаследовано от Control)
PreRender	Происходит после Control загрузки объекта, но до отрисовки. (Унаследовано от Control)
Unload	Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control)

Явные реализации интерфейса

Имя	Описание
IAttributeAccessor.GetAttribute(String)	Возвращает значение указанного атрибута пользовательского элемента управления. (Унаследовано от UserControl)
IAttributeAccessor.SetAttribute(String, String)	Задает значение указанного атрибута пользовательского элемента управления. (Унаследовано от UserControl)
IControlBuilderAccessor.ControlBuilder	Описание этого элемента см. в разделе ControlBuilder. (Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()	Описание этого элемента см. в разделе GetDesignModeState(). (Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Описание этого элемента см. в разделе SetDesignModeState(IDictionary). (Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Описание этого элемента см. в разделе SetOwnerControl(Control). (Унаследовано от Control)
IControlDesignerAccessor.UserData	Описание этого элемента см. в разделе UserData. (Унаследовано от Control)
IDataBindingsAccessor.DataBindings	Описание этого элемента см. в разделе DataBindings. (Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings	Описание этого элемента см. в разделе HasDataBindings. (Унаследовано от Control)
IExpressionsAccessor.Expressions	Описание этого элемента см. в разделе Expressions. (Унаследовано от Control)
IExpressionsAccessor.HasExpressions	Описание этого элемента см. в разделе HasExpressions. (Унаследовано от Control)
IFilterResolutionService.CompareFilters(String, String)	Возвращает значение, указывающее, существует ли связь родительского или дочернего устройства между двумя указанными фильтрами устройств. (Унаследовано от TemplateControl)
IFilterResolutionService.EvaluateFilter(String)	Возвращает значение, указывающее, является ли указанный фильтр типом текущего объекта фильтра. (Унаследовано от TemplateControl)
IParserAccessor.AddParsedSubObject(Object)	Описание этого элемента см. в разделе AddParsedSubObject(Object). (Унаследовано от Control)
IUserControlDesignerAccessor.InnerText	Возвращает или задает текст, отображаемый между открывающим и закрывающим тегами пользовательского элемента управления. (Унаследовано от UserControl)
IUserControlDesignerAccessor.TagName	Возвращает или задает полное имя тега пользовательского элемента управления. (Унаследовано от UserControl)

Методы расширения

Имя	Описание
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Включает поведение динамических данных для указанного элемента управления данными.
EnableDynamicData(INamingContainer, Type, Object)	Включает поведение динамических данных для указанного элемента управления данными.
EnableDynamicData(INamingContainer, Type)	Включает поведение динамических данных для указанного элемента управления данными.
FindDataSourceControl(Control)	Возвращает источник данных, связанный с элементом управления данными для указанного элемента управления.
FindFieldTemplate(Control, String)	Возвращает шаблон поля для указанного столбца в контейнере именования указанного элемента управления.
FindMetaTable(Control)	Возвращает объект метатабли для содержащего элемента управления данными.
GetDefaultValues(INamingContainer)	Возвращает коллекцию значений по умолчанию для указанного элемента управления данными.
GetMetaTable(INamingContainer)	Возвращает метаданные таблицы для указанного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable, Object)	Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable)	Задает метаданные таблицы для указанного элемента управления данными.
TryGetMetaTable(INamingContainer, MetaTable)	Определяет, доступны ли метаданные таблицы.

Применяется к

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

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