Page Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет файл .aspx, который также называется страницей веб-форм, запрошенной с сервера, на котором размещено веб-приложение ASP.NET.
public ref class Page : System::Web::UI::TemplateControl, System::Web::IHttpHandler
public class Page : System.Web.UI.TemplateControl, System.Web.IHttpHandler
type Page = class
inherit TemplateControl
interface IHttpHandler
Public Class Page
Inherits TemplateControl
Implements IHttpHandler
- Наследование
- Производный
- Реализации
Примеры
В следующем примере кода показано, как Page класс используется в модели страницы программной части. Обратите внимание, что исходный файл кода за исходным файлом объявляет частичный класс, наследующий от базового класса страницы. Базовый класс страницы может быть Pageили может быть другим классом, производным от Page. Кроме того, обратите внимание, что частичный класс позволяет файлу программной части использовать элементы управления, определенные на странице, без необходимости определять их как элементы поля.
using System;
public partial class MyCodeBehindCS : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
// Place page-specific code here.
}
// Define a handler for the button click.
protected void SubmitBtn_Click(object sender, EventArgs e)
{
MySpan.InnerHtml = "Hello, " + MyTextBox.Text + ".";
}
}
Partial Class MyCodeBehindVB
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
' Place page-specific code here.
End Sub
' Define a handler for the button click.
Protected Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyButton.Click
MySpan.InnerHtml = "Hello, " + MyTextBox.Text + "."
End Sub
End Class
В следующем примере кода показан файл .aspx, соответствующий предыдущему исходному файлу кода.
Это важно
В этом примере есть текстовое поле, которое принимает входные данные пользователя, которое является потенциальной угрозой безопасности. По умолчанию ASP.NET веб-страницы проверяют, что входные данные пользователя не включают скрипт или ЭЛЕМЕНТЫ HTML. Дополнительные сведения см. в разделе "Обзор эксплойтов скриптов".
<%@ Page Language="C#" CodeFile="pageexample.aspx.cs" Inherits="MyCodeBehindCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Page Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<table>
<tr>
<td> Name: </td>
<td> <asp:textbox id="MyTextBox" runat="server"/> </td>
</tr>
<tr>
<td></td>
<td><asp:button id="MyButton" text="Click Here" onclick="SubmitBtn_Click" runat="server"/></td>
</tr>
<tr>
<td></td>
<td><span id="MySpan" runat="server" /></td>
</tr>
</table>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" CodeFile="pageexample.aspx.vb" Inherits="MyCodeBehindVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Page Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<table>
<tr>
<td> Name: </td>
<td> <asp:textbox id="MyTextBox" runat="server"/> </td>
</tr>
<tr>
<td></td>
<td><asp:button id="MyButton" text="Click Here" onclick="SubmitBtn_Click" runat="server"/></td>
</tr>
<tr>
<td></td>
<td><span id="MySpan" runat="server" /></td>
</tr>
</table>
</div>
</form>
</body>
</html>
Необходимо использовать директиву @Page и использовать InheritsCodeFile атрибуты для связывания файла кода с файлом .aspx. В этом примере Inherits атрибут указывает MyCodeBehind класс и CodeFile атрибут указывает путь к файлу, который содержит класс.
В следующем примере кода демонстрируется модель однофайловых страниц и как получить доступ к IsPostBack свойству и Response свойству объекта Page.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
StringBuilder sb = new StringBuilder();
if (Page.IsPostBack)
sb.Append("You posted back to the page.<br />");
sb.Append("The host address is " + Page.Request.UserHostAddress + ".<br />");
sb.Append("The page title is \"" + Page.Header.Title + "\".");
PageMessage.Text = sb.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Page Class Example</title>
</head>
<body>
<form id="form1"
runat="server">
<div>
<asp:Label id="PageMessage"
runat="server"/>
<br /> <br />
<asp:Button id="PageButton"
Text="PostBack"
runat="server" />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim sb As New StringBuilder()
If (Page.IsPostBack) Then
sb.Append("You posted back to the page.<br />")
End If
sb.Append("The host address is " + Page.Request.UserHostAddress + ".<br />")
sb.Append("The page title is """ + Page.Header.Title + """.")
PageMessage.Text = sb.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Page Class Example</title>
</head>
<body>
<form id="form1"
runat="server">
<div>
<asp:Label id="PageMessage"
runat="server"/>
<br /> <br />
<asp:Button id="PageButton"
Text="PostBack"
runat="server" />
</div>
</form>
</body>
</html>
Комментарии
Класс Page связан с файлами с расширением .aspx. Эти файлы компилируются во время выполнения как Page объекты и кэшируются в памяти сервера.
Если вы хотите создать страницу веб-форм с помощью метода программной части, наследуется от этого класса. Конструкторы быстрой разработки приложений (RAD), такие как Microsoft Visual Studio, автоматически используют эту модель для создания страниц веб-форм.
Объект Page служит контейнером именования для всех элементов управления сервера на странице, за исключением тех, которые реализуют INamingContainer интерфейс или являются дочерними элементами управления, реализующими этот интерфейс.
Класс Page — это элемент управления, который выступает в качестве пользовательского интерфейса для веб-приложения, и таким образом следует тщательно изучить, чтобы убедиться, что рекомендации по написанию защищенного кода и защите приложений выполняются. Общие сведения об этих разделах см. в разделе "Общие сведения об угрозах безопасности веб-приложений", рекомендациях по политикебезопасности и основных понятиях безопасности. Дополнительные сведения см. в разделе "Защита стандартных элементов управления", практическое руководство. Отображение безопасных сообщений об ошибках, практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам и введение в элементы управления проверки.
Конструкторы
| Имя | Описание |
|---|---|
| Page() |
Инициализирует новый экземпляр класса Page. |
Поля
| Имя | Описание |
|---|---|
| postEventArgumentID |
Строка, определяющая скрытое поле EVENTARGUMENT на отрисованной странице. |
| postEventSourceID |
Строка, определяющая скрытое поле EVENTTARGET на отрисованной странице. |
Свойства
| Имя | Описание |
|---|---|
| Adapter |
Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control) |
| Application |
HttpApplicationState Возвращает объект для текущего веб-запроса. |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control) |
| AppRelativeVirtualPath |
Возвращает или задает путь относительного приложения, виртуального каталога к файлу, из которого элемент управления анализируется и компилируется. (Унаследовано от TemplateControl) |
| AspCompatMode |
Задает значение, указывающее, может ли страница выполняться в потоке однопоточной квартиры (STA). |
| AsyncMode |
Задает значение, указывающее, обрабатывается ли страница синхронно или асинхронно. |
| AsyncTimeout |
Возвращает или задает значение, указывающее интервал времени ожидания, используемый при обработке асинхронных задач. |
| AutoHandlers |
Устаревшие..
Свойство AutoHandlers устарело в ASP.NET NET 2.0. Он используется созданными классами и не предназначен для использования в коде. (Унаследовано от TemplateControl) |
| AutoPostBackControl |
Получает или задает элемент управления на странице, которая используется для выполнения обратных операций. |
| BindingContainer |
Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control) |
| Buffer |
Задает значение, указывающее, буферичен ли выходные данные страницы. |
| Cache |
Возвращает объект, связанный Cache с приложением, в котором находится страница. |
| ChildControlsCreated |
Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control) |
| ClientID |
Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения ClientID свойства. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control) |
| ClientQueryString |
Возвращает часть строки запроса запрошенного URL-адреса. |
| ClientScript |
Возвращает объект, используемый ClientScriptManager для управления, регистрации и добавления скрипта на страницу. |
| ClientTarget |
Возвращает или задает значение, позволяющее переопределить автоматическое обнаружение возможностей браузера и указать способ отображения страницы для определенных клиентов браузера. |
| CodePage |
Задает идентификатор кодовой страницы для текущего Page. |
| ContentType |
Задает тип HTTP MIME для объекта, связанного HttpResponse со страницей. |
| Context |
Возвращает объект, связанный HttpContext со страницей. |
| Controls |
ControlCollection Возвращает объект, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от Control) |
| Culture |
Задает идентификатор языка и региональных параметров для объекта, связанного Thread со страницей. |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control) |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control) |
| EnableEventValidation |
Возвращает или задает значение, указывающее, проверяет ли страница события обратного и обратного вызова. |
| EnableTheming |
Возвращает или задает логическое значение, указывающее, применяются ли темы к элементу управления, производным TemplateControl от класса. (Унаследовано от TemplateControl) |
| EnableViewState |
Возвращает или задает значение, указывающее, поддерживает ли страница состояние представления, а состояние представления всех элементов управления сервером, содержащихся в нем, когда заканчивается текущий запрос страницы. |
| EnableViewStateMac |
Возвращает или задает значение, указывающее, следует ли ASP.NET проверять коды проверки подлинности сообщений (MAC) в состоянии представления страницы при обратной публикации страницы от клиента. |
| ErrorPage |
Получает или задает страницу ошибок, на которую запрашивающий браузер перенаправляется в случае необработанного исключения страницы. |
| Events |
Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| FileDependencies |
Устаревшие..
Задает массив файлов, от которых зависит текущий HttpResponse объект. |
| Form |
Возвращает HTML-форму для страницы. |
| HasChildViewState |
Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control) |
| Header |
Получает заголовок документа для страницы, если |
| ID |
Возвращает или задает идентификатор для определенного экземпляра Page класса. |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элемента управления при создании уникального идентификатора элемента управления на странице. |
| IsAsync |
Возвращает значение, указывающее, обрабатывается ли страница асинхронно. |
| IsCallback |
Возвращает значение, указывающее, является ли запрос страницы результатом обратного вызова. |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control) |
| IsCrossPagePostBack |
Возвращает значение, указывающее, участвует ли страница в перекрестной обратной отправке. |
| IsPostBack |
Возвращает значение, указывающее, выполняется ли отрисовка страницы в первый раз или загружается в ответ на обратную передачу. |
| IsPostBackEventControlRegistered |
Возвращает значение, указывающее, зарегистрирован ли элемент управления на странице, выполняющей обратные передачи. |
| IsReusable |
Возвращает значение, указывающее, можно ли Page повторно использовать объект. |
| IsTrackingViewState |
Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control) |
| IsValid |
Возвращает значение, указывающее, успешно ли выполнена проверка страницы. |
| IsViewStateEnabled |
Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| Items |
Возвращает список объектов, хранящихся в контексте страницы. |
| LCID |
Задает идентификатор языкового стандарта для объекта, связанного Thread со страницей. |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control) |
| MaintainScrollPositionOnPostBack |
Возвращает или задает значение, указывающее, следует ли возвращать пользователя в ту же позицию в клиентском браузере после обратной передачи. Это свойство заменяет устаревшее SmartNavigation свойство. |
| Master |
Возвращает главную страницу, которая определяет общий вид страницы. |
| MasterPageFile |
Возвращает или задает виртуальный путь главной страницы. |
| MaxPageStateFieldLength |
Возвращает или задает максимальную длину поля состояния страницы. |
| MetaDescription |
Возвращает или задает содержимое элемента description |
| MetaKeywords |
Возвращает или задает содержимое элемента "ключевые слова". |
| ModelBindingExecutionContext |
Возвращает контекст выполнения привязки модели. |
| ModelState |
Возвращает объект словаря состояния модели, содержащий состояние модели и проверки привязки модели. |
| NamingContainer |
Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control) |
| Page |
Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control) |
| PageAdapter |
Возвращает адаптер, который отображает страницу для конкретного запрашивающего браузера. |
| PageStatePersister |
Возвращает объект, связанный PageStatePersister со страницей. |
| Parent |
Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control) |
| PreviousPage |
Возвращает страницу, передаваемую элементом управления на текущую страницу. |
| RenderingCompatibility |
Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control) |
| Request |
HttpRequest Возвращает объект для запрошенной страницы. |
| Response |
Возвращает объект, связанный HttpResponsePage с объектом. Этот объект позволяет отправлять данные ответа HTTP клиенту и содержать сведения об этом ответе. |
| ResponseEncoding |
Задает язык кодирования для текущего HttpResponse объекта. |
| RouteData |
RouteData Возвращает значение текущего RequestContext экземпляра. |
| Server |
|
| Session |
Возвращает текущий |
| Site |
Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от Control) |
| SkipFormActionValidation |
Возвращает или задает значение, указывающее, проверяется ли значение строки запроса. |
| SmartNavigation |
Устаревшие..
Возвращает или задает значение, указывающее, включена ли интеллектуальная навигация. Это свойство является устаревшим. |
| StyleSheetTheme |
Возвращает или задает имя темы, применяемой к странице в начале жизненного цикла страницы. |
| SupportAutoEvents |
Возвращает значение, указывающее, поддерживает ли TemplateControl элемент управления автоматические события. (Унаследовано от TemplateControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| Theme |
Возвращает или задает имя темы страницы. |
| Title |
Возвращает или задает заголовок страницы. |
| Trace |
TraceContext Возвращает объект для текущего веб-запроса. |
| TraceEnabled |
Задает значение, указывающее, включена ли трассировка для Page объекта. |
| TraceModeValue |
Задает режим, в котором отображаются инструкции трассировки на странице. |
| TransactionMode |
Задает уровень поддержки транзакций для страницы. |
| UICulture |
Задает идентификатор пользовательского интерфейса для объекта, связанного Thread со страницей. |
| UniqueFilePathSuffix |
Получает уникальный суффикс для добавления к пути к файлу для кэширования браузеров. |
| UniqueID |
Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control) |
| UnobtrusiveValidationMode |
Возвращает или задает значение, указывающее, используется ли ненавязчивый JavaScript для проверки на стороне клиента. |
| User |
Получает сведения о пользователе, выполняющего запрос страницы. |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли страница входные данные клиента из браузера для потенциально опасных значений. |
| Validators |
Возвращает коллекцию всех элементов управления проверки, содержащихся на запрошенной странице. |
| ViewState |
Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control) |
| ViewStateEncryptionMode |
Возвращает или задает режим шифрования состояния представления. |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control) |
| ViewStateUserKey |
Присваивает идентификатор отдельному пользователю в переменной состояния представления, связанной с текущей страницей. |
| Visible |
Возвращает или задает значение, указывающее, отображается ли Page объект. |
Методы
| Имя | Описание |
|---|---|
| AddContentTemplate(String, ITemplate) |
Вызывается во время инициализации страницы для создания коллекции содержимого (из элементов управления содержимым), передаваемой главной странице, если текущая страница или эталонная страница ссылается на главную страницу. |
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control) |
| AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object) |
Регистрирует делегаты обработчика событий начала и окончания для асинхронной страницы. |
| AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler) |
Регистрирует делегаты обработчика событий начала и окончания, которые не требуют сведений о состоянии для асинхронной страницы. |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control) |
| AddWrappedFileDependencies(Object) |
Добавляет список зависимых файлов, составляющих текущую страницу. Этот метод используется внутри платформы страниц ASP.NET и не предназначен для использования непосредственно из кода. |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| AspCompatBeginProcessRequest(HttpContext, AsyncCallback, Object) |
Инициирует запрос ресурсов страницы Active Server (ASP). Этот метод предоставляется для обеспечения совместимости с устаревшими приложениями ASP. |
| AspCompatEndProcessRequest(IAsyncResult) |
Завершает запрос на ресурсы страницы Active Server (ASP). Этот метод предоставляется для обеспечения совместимости с устаревшими приложениями ASP. |
| AsyncPageBeginProcessRequest(HttpContext, AsyncCallback, Object) |
Начинает обработку асинхронного запроса страницы. |
| AsyncPageEndProcessRequest(IAsyncResult) |
Завершает обработку асинхронного запроса страницы. |
| 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) |
| CreateHtmlTextWriter(TextWriter) |
HtmlTextWriter Создает объект для отрисовки содержимого страницы. |
| CreateHtmlTextWriterFromType(TextWriter, Type) |
Создает указанный HtmlTextWriter объект для отрисовки содержимого страницы. |
| CreateResourceBasedLiteralControl(Int32, Int32, Boolean) |
Обращается к литеральным строкам, хранящимся в ресурсе. Метод CreateResourceBasedLiteralControl(Int32, Int32, Boolean) не предназначен для использования из кода. (Унаследовано от TemplateControl) |
| DataBind() |
Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. (Унаследовано от Control) |
| DataBind(Boolean) |
Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control) |
| DesignerInitialize() |
Выполняет любую инициализацию экземпляра класса, требуемого Page конструкторами RAD. Этот метод используется только во время разработки. |
| DeterminePostBackMode() |
NameValueCollection Возвращает данные, размещенные обратно на страницу с помощью команды POST или GET. |
| DeterminePostBackModeUnvalidated() |
Возвращает коллекцию данных с именем, которые были размещены на странице с помощью команды POST или GET, не выполняя проверку запроса ASP.NET по запросу. |
| Dispose() |
Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control) |
| EnsureID() |
Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| Eval(String, String) |
Вычисляет выражение привязки данных с помощью указанной строки формата для отображения результата. (Унаследовано от TemplateControl) |
| Eval(String) |
Вычисляет выражение привязки данных. (Унаследовано от TemplateControl) |
| ExecuteRegisteredAsyncTasks() |
Запускает выполнение асинхронной задачи. |
| FindControl(String, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| FindControl(String) |
Выполняет поиск контейнера именования страниц для элемента управления сервером с указанным идентификатором. |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| Focus() |
Задает фокус ввода элементу управления. (Унаследовано от Control) |
| FrameworkInitialize() |
Инициализирует дерево элементов управления во время создания страницы на основе декларативной природы страницы. |
| FrameworkInitialize() |
Инициализирует элемент управления, производный TemplateControl от класса. (Унаследовано от TemplateControl) |
| GetDataItem() |
Возвращает элемент данных в верхней части стека контекста привязки данных. |
| 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) |
| GetPostBackClientEvent(Control, String) |
Устаревшие..
Возвращает ссылку, которая может использоваться в клиентском событии для отправки обратно на сервер для указанного элемента управления и с указанными аргументами события. |
| GetPostBackClientHyperlink(Control, String) |
Устаревшие..
Получает ссылку, |
| GetPostBackEventReference(Control, String) |
Устаревшие..
Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылочная строка определяется указанным элементом управления, обрабатывающим обратную передачу и строковый аргумент дополнительных сведений о событии. |
| GetPostBackEventReference(Control) |
Устаревшие..
Возвращает строку, которая может использоваться в клиентском событии для обратной передачи на сервер. Ссылочная строка определяется указанным Control объектом. |
| GetRouteUrl(Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, Object) |
Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetTypeHashCode() |
Извлекает хэш-код, созданный объектами, созданными Page во время выполнения. Этот хэш-код является уникальным для Page иерархии элементов управления объекта. |
| GetUniqueIDRelativeTo(Control) |
Возвращает префиксированную часть UniqueID свойства указанного элемента управления. (Унаследовано от Control) |
| GetValidators(String) |
Возвращает коллекцию проверяющих средств управления для указанной группы проверки. |
| GetWrappedFileDependencies(String[]) |
Возвращает список имен физических файлов, соответствующих списку расположений виртуальных файлов. |
| HasControls() |
Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от Control) |
| HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control) |
| InitializeCulture() | |
| InitOutputCache(Int32, String, String, OutputCacheLocation, String) |
Инициализирует кэш выходных данных для текущего запроса страницы. |
| InitOutputCache(Int32, String, String, String, OutputCacheLocation, String) |
Инициализирует кэш выходных данных для текущего запроса страницы. |
| InitOutputCache(OutputCacheParameters) |
Инициализирует выходной кэш для текущего OutputCacheParameters запроса страницы на основе объекта. |
| IsClientScriptBlockRegistered(String) |
Устаревшие..
Определяет, зарегистрирован ли на странице блок клиентского скрипта с указанным ключом. |
| IsLiteralContent() |
Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control) |
| IsStartupScriptRegistered(String) |
Устаревшие..
Определяет, зарегистрирован ли скрипт запуска клиента в объекте Page . |
| LoadControl(String) |
Control Загружает объект из файла на основе указанного виртуального пути. (Унаследовано от TemplateControl) |
| LoadControl(Type, Object[]) |
Control Загружает объект на основе заданных параметров типа и конструктора. (Унаследовано от TemplateControl) |
| LoadControlState(Object) |
Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState() . (Унаследовано от Control) |
| LoadPageStateFromPersistenceMedium() |
Загружает все сохраненные сведения о состоянии представления в Page объект. |
| LoadTemplate(String) |
Получает экземпляр ITemplate интерфейса из внешнего файла. (Унаследовано от TemplateControl) |
| LoadViewState(Object) |
Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState() . (Унаследовано от Control) |
| MapPath(String) |
Извлекает физический путь, с которым сопоставляется виртуальный путь, абсолютный или относительный или относительный путь приложения. |
| 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 Вызывает событие для инициализации страницы. |
| OnInit(EventArgs) |
Вызывает событие Init. (Унаследовано от Control) |
| OnInitComplete(EventArgs) |
InitComplete Вызывает событие после инициализации страницы. |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnLoadComplete(EventArgs) |
LoadComplete Вызывает событие в конце этапа загрузки страницы. |
| OnPreInit(EventArgs) |
PreInit Вызывает событие в начале инициализации страницы. |
| OnPreLoad(EventArgs) |
PreLoad Вызывает событие после загрузки данных обратной передачи в элементы управления сервера страницы, но перед событиемOnLoad(EventArgs). |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. (Унаследовано от Control) |
| OnPreRenderComplete(EventArgs) |
PreRenderComplete Вызывает событие после OnPreRenderComplete(EventArgs) события и перед отображением страницы. |
| OnSaveStateComplete(EventArgs) |
SaveStateComplete Вызывает событие после сохранения состояния страницы в среде сохраняемости. |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает используемый Stream для чтения файла. (Унаследовано от Control) |
| ParseControl(String, Boolean) |
Анализирует входную строку в Control объект на веб-странице ASP.NET или пользовательском элементе управления. (Унаследовано от TemplateControl) |
| ParseControl(String) |
Анализирует входную строку в Control объект на странице веб-форм или пользовательском элементе управления. (Унаследовано от TemplateControl) |
| ProcessRequest(HttpContext) |
Задает встроенные объекты Page сервера объекта, такие как Context, RequestResponseи Application свойства. |
| RaiseBubbleEvent(Object, EventArgs) |
Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control) |
| RaisePostBackEvent(IPostBackEventHandler, String) |
Уведомляет серверный элемент управления, который вызвал обратную передачу, что он должен обрабатывать входящее событие обратной передачи. |
| ReadStringResource() |
Считывает строковый ресурс. Метод ReadStringResource() не предназначен для использования из кода. (Унаследовано от TemplateControl) |
| RegisterArrayDeclaration(String, String) |
Устаревшие..
Объявляет значение, объявленное как объявление массива ECMAScript при отрисовки страницы. |
| RegisterAsyncTask(PageAsyncTask) |
Регистрирует новую асинхронную задачу на странице. |
| RegisterClientScriptBlock(String, String) |
Устаревшие..
Выводит блоки скриптов на стороне клиента в ответ. |
| RegisterHiddenField(String, String) |
Устаревшие..
Позволяет элементам управления сервера автоматически регистрировать скрытое поле в форме. Поле будет отправлено Page объекту при отрисовки серверного HtmlForm элемента управления. |
| RegisterOnSubmitStatement(String, String) |
Устаревшие..
Позволяет странице получать доступ к событию клиента |
| RegisterRequiresControlState(Control) |
Регистрирует элемент управления в качестве элемента управления, состояние которого должно быть сохранено. |
| RegisterRequiresPostBack(Control) |
Регистрирует элемент управления в качестве элемента управления, требующего обратной обработки при отправке страницы обратно на сервер. |
| RegisterRequiresRaiseEvent(IPostBackEventHandler) |
Регистрирует серверный элемент управления ASP.NET в качестве одного, требующего создания события при обработке элемента управления в объекте Page . |
| RegisterRequiresViewStateEncryption() |
Регистрирует элемент управления на странице в качестве одного из них, требующего шифрования состояния представления. |
| RegisterStartupScript(String, String) |
Устаревшие..
Выводит блок скрипта на стороне клиента в ответе страницы. |
| RegisterViewStateHandler() |
Вызывает сохранение состояния представления страницы при вызове. |
| RemovedControl(Control) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Инициализирует HtmlTextWriter объект и вызывает дочерние элементы управления для отрисовки Page . |
| Render(HtmlTextWriter) |
Отправляет содержимое элемента управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RequiresControlState(Control) |
Определяет, зарегистрирован ли указанный Control объект для участия в управлении состоянием управления. |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control) |
| SavePageStateToPersistenceMedium(Object) |
Сохраняет все сведения о состоянии представления и состояния управления для страницы. |
| SaveViewState() |
Сохраняет все изменения состояния представления представления сервера, которые произошли с момента отправки страницы на сервер. (Унаследовано от Control) |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetFocus(Control) |
Задает фокус браузера для указанного элемента управления. |
| SetFocus(String) |
Задает фокус браузера элементу управления с указанным идентификатором. |
| 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) |
Обновляет экземпляр модели с помощью значений из указанного поставщика значений. |
| TryUpdateModel<TModel>(TModel) |
Обновляет указанный экземпляр модели с помощью значений из элемента управления с привязкой к данным. |
| UnregisterRequiresControlState(Control) |
Останавливает сохранение состояния элемента управления для указанного элемента управления. |
| UpdateModel<TModel>(TModel, IValueProvider) |
Обновляет указанный экземпляр модели с помощью значений из указанного поставщика значений. |
| UpdateModel<TModel>(TModel) |
Обновляет указанный экземпляр модели с помощью значений из элемента управления с привязкой к данным. |
| Validate() |
Указывает всем элементам управления проверки, включенным на странице для проверки назначенных сведений. |
| Validate(String) |
Указывает элементам управления проверки в указанной группе проверки проверить назначенные сведения. |
| VerifyRenderingInServerForm(Control) |
Подтверждает, что HtmlForm элемент управления отображается для указанного ASP.NET серверного элемента управления во время выполнения. |
| 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) |
| InitComplete |
Происходит при завершении инициализации страницы. |
| Load |
Происходит при загрузке серверного элемента управления в Page объект. (Унаследовано от Control) |
| LoadComplete |
Происходит в конце этапа загрузки жизненного цикла страницы. |
| PreInit |
Происходит перед инициализацией страницы. |
| PreLoad |
Происходит перед событием страницы Load . |
| PreRender |
Происходит после Control загрузки объекта, но до отрисовки. (Унаследовано от Control) |
| PreRenderComplete |
Происходит перед отображением содержимого страницы. |
| SaveStateComplete |
Происходит после завершения сохранения всех состояний представления и сведений о состоянии управления для страницы и элементов управления на странице. |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| 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) |
Методы расширения
| Имя | Описание |
|---|---|
| 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) |
Определяет, доступны ли метаданные таблицы. |