MasterPage Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Действует как шаблон и контейнер слияния для страниц, которые состоят только из элементов управления 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
- Наследование
Примеры
В этом разделе содержатся четыре примера кода:
В первом примере кода показано, как создать эталонную страницу декларативно.
Второй пример кода представляет страницу содержимого, связанную с главной страницей, созданной в первом примере кода.
В третьем примере кода показано, как добавить свойство на главную страницу.
В четвертом примере кода показано, как использовать страницу содержимого для доступа к общедоступному свойству на главной странице.
В следующем примере показано, как создать эталонную страницу декларативно и добавить в нее содержимое с помощью страницы содержимого. Первая веб-страница — это главная страница с именем 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>
В следующем примере показано, как использовать страницу содержимого для доступа к свойству public 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
, , 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 .
Примечание
Файлы с расширениями 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) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
AddParsedSubObject(Object) |
Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control) |
ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
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) |
Оценивает выражение привязки данных. (Унаследовано от TemplateControl) |
Eval(String, String) |
Оценивает выражение привязки данных, используя указанный формат строки для отображения результата. (Унаследовано от TemplateControl) |
FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
Focus() |
Задает фокус ввода на элемент управления. (Унаследовано от Control) |
FrameworkInitialize() |
Инициализирует элемент контроля производного от класса TemplateControl. (Унаследовано от TemplateControl) |
GetDesignModeState() |
Возвращает данные времени разработки для элемента управления. (Унаследовано от Control) |
GetGlobalResourceObject(String, String) |
Получает объект ресурса на уровне приложения на основе указанных свойств ClassKey и ResourceKey. (Унаследовано от TemplateControl) |
GetGlobalResourceObject(String, String, Type, String) |
Возвращает объект ресурса на уровне приложения на основе выделенного ClassKey и свойств ResourceKey, типа объекта и ресурса имени объекта. (Унаследовано от TemplateControl) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetLocalResourceObject(String) |
Возвращает объект ресурса на основе выделенных данных свойства ResourceKey. (Унаследовано от TemplateControl) |
GetLocalResourceObject(String, Type, 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) |
Анализирует входную строку в объекте Control на ASP.NET веб-форме в пользовательском элементе управления. (Унаследовано от TemplateControl) |
ParseControl(String, Boolean) |
Анализирует входную строку в объекте Control на ASP.NET веб-странице в пользовательском элементе управления. (Унаследовано от TemplateControl) |
RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
ReadStringResource() |
Считывает строку ресурса. Метод ReadStringResource() не рассматривается для использования в коде. (Унаследовано от TemplateControl) |
RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
Render(HtmlTextWriter) |
Отправляет содержимое серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает содержимое для отрисовки в клиенте. (Унаследовано от Control) |
RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
SaveControlState() |
Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
SaveViewState() |
Сохраняет любые изменения состояния представления пользовательского элемента управления, произошедшие с момента последней обратной передачи страницы. (Унаследовано от UserControl) |
SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
SetStringResourcePointer(Object, Int32) |
Задает указатель строке ресурса. Метод SetStringResourcePointer(Object, Int32) используется сгенерированными классами и не рассматривается для использования в коде. (Унаследовано от TemplateControl) |
SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
TestDeviceFilter(String) |
Возвращает логическое значение, которое указывает, используется ли фильтр устройств для HTTP-запроса. (Унаследовано от TemplateControl) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
TrackViewState() |
Вызывает отслеживание изменений состояния представления серверного элемента управления для сохранения в объекте StateBag серверного элемента управления. Этот объект доступен с помощью свойства ViewState. (Унаследовано от Control) |
TryUpdateModel<TModel>(TModel) |
Пытается обновить экземпляр модели, используя значения из элемента управления с привязкой к данным. (Унаследовано от UserControl) |
TryUpdateModel<TModel>(TModel, IValueProvider) |
Пытается обновить экземпляр модели, используя значения, предоставленные поставщиком значений. (Унаследовано от UserControl) |
UpdateModel<TModel>(TModel) |
Обновляет экземпляр модели, используя значения из элемента управления с привязкой к данным. (Унаследовано от UserControl) |
UpdateModel<TModel>(TModel, IValueProvider) |
Обновляет указанный экземпляр модели с помощью значений, предоставленных поставщиком значений пользовательского элемента управления. (Унаследовано от UserControl) |
WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) |
Записывает строку ресурса в элемент управления HtmlTextWriter. Метод WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) используется сгенерированными классами и не рассматривается для использования в коде. (Унаследовано от TemplateControl) |
XPath(String) |
Оценка выражений привязки данных в формате XPath. (Унаследовано от TemplateControl) |
XPath(String, IXmlNamespaceResolver) |
Оценка выражения привязки данных в формате XPath с использованием указанного префикса и сопоставления пространства имен для разрешения пространства имен. (Унаследовано от TemplateControl) |
XPath(String, String) |
Оценка выражения привязки данных в формате XPath с использованием указанной строки форматирования для отображения результата. (Унаследовано от TemplateControl) |
XPath(String, String, IXmlNamespaceResolver) |
Оценивает XPath-выражения привязки данных при помощи префикса и сопоставлений пространства имен для разрешения пространства имен выделенного формата строки для отображение результата. (Унаследовано от TemplateControl) |
XPathSelect(String) |
Оценивает выражение привязки данных в формате XPath и получение коллекции узлов, которая реализует интерфейс IEnumerable. (Унаследовано от TemplateControl) |
XPathSelect(String, IXmlNamespaceResolver) |
Оценка выражения привязки данных в формате 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) |
Методы расширения
FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |
GetDefaultValues(INamingContainer) |
Получает коллекцию значений по умолчанию для заданного элемента управления данными. |
GetMetaTable(INamingContainer) |
Получает метаданные таблицы для заданного элемента управления данными. |
SetMetaTable(INamingContainer, MetaTable) |
Задает метаданные таблицы для заданного элемента управления данными. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
TryGetMetaTable(INamingContainer, MetaTable) |
Определяет, доступны ли метаданные таблицы. |
EnableDynamicData(INamingContainer, Type) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |