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


Page Класс

Определение

Представляет ASCX-файл, также называемый страницей веб-форм, запрашиваемый с сервера, на котором размещается веб-приложение 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
Наследование
Производный
Реализации

Примеры

Проект веб-сайта Visual Studio с исходным кодом доступен в следующем разделе: Скачивание.

В следующем примере кода показано, как 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 и Inherits атрибуты и CodeFile , чтобы связать файл кода программной части с файлом .aspx. В этом примере атрибут указывает MyCodeBehind класс, Inherits а 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

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

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

Устанавливает тип MIME HTTP для объекта 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

Возвращает заголовок документа страницы, если элемент head определен с runat=server в объявлении страницы.

ID

Возвращает или задает идентификатор для конкретного экземпляра класса Page.

IdSeparator

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

IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.

(Унаследовано от Control)
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

Получает или задает содержимое элемента meta свойства "description".

MetaKeywords

Получает или задает содержимое meta-элемента "keywords".

ModelBindingExecutionContext

Получает контекст выполнения привязки модели.

ModelState

Получает объект словаря состояния модели, содержащий состояние модели и проверку привязки модели.

NamingContainer

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

(Унаследовано от Control)
Page

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.

(Унаследовано от Control)
PageAdapter

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

PageStatePersister

Возвращает объект PageStatePersister, связанный со страницей.

Parent

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.

(Унаследовано от Control)
PreviousPage

Возвращает страницу, передавшую управление текущей странице.

RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.

(Унаследовано от Control)
Request

Возвращает объект HttpRequest для запрашиваемой страницы.

Response

Возвращает объект HttpResponse, связанный с объектом Page. Этот объект позволяет отправлять клиенту данные HTTP-ответа и содержит сведения об этом ответе.

ResponseEncoding

Устанавливает язык шифрования для текущего объекта HttpResponse.

RouteData

Получает значение свойства RouteData текущего экземпляра RequestContext.

Server

Возвращает объект Server, являющийся экземпляром класса HttpServerUtility.

Session

Возвращает текущий объект Session, предоставленный ASP.NET.

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

Устанавливает идентификатор интерфейса пользователя (UI) для объекта Thread, связанного со страницей.

UniqueFilePathSuffix

Возвращает уникальный суффикс для добавления к пути файла для браузеров с кэшем.

UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.

(Унаследовано от Control)
UnobtrusiveValidationMode

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

User

Возвращает сведения о пользователе, производящем запрос страницы.

ValidateRequestMode

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

ValidateRequestMode

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

(Унаследовано от Control)
Validators

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

ViewState

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

(Унаследовано от Control)
ViewStateEncryptionMode

Возвращает или задает режим шифрования состояния представления.

ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.

(Унаследовано от Control)
ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.

(Унаследовано от Control)
ViewStateUserKey

Присваивает пользователю идентификатор в переменной состояния представления, связанной с текущей страницей.

Visible

Возвращает или задает значение, определяющее, отображается ли объект Page.

Методы

AddContentTemplate(String, ITemplate)

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

AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.

(Унаследовано от Control)
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler)

Регистрирует делегаты, не требующих информации о состоянии, обработчика начального и конечного событий для асинхронной страницы.

AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object)

Регистрирует делегаты обработчика начального и конечного событий для асинхронной страницы.

AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.

(Унаследовано от Control)
AddWrappedFileDependencies(Object)

Добавляет список зависимых файлов, составляющих текущую страницу. Класс используется внутри платформы страницы ASP.NET и не предназначен для использования в коде.

ApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.

(Унаследовано от Control)
AspCompatBeginProcessRequest(HttpContext, AsyncCallback, Object)

Инициирует запрос на ресурсы Active Server Page (ASP). Метод, предоставляется для совместимости с предыдущими приложениями ASP.

AspCompatEndProcessRequest(IAsyncResult)

Завершает запрос на ресурсы Active Server Page (ASP). Метод, предоставляется для совместимости с предыдущими приложениями ASP.

AsyncPageBeginProcessRequest(HttpContext, AsyncCallback, Object)

Начинает обработку запроса асинхронной страницы.

AsyncPageEndProcessRequest(IAsyncResult)

Заканчивает обработку запроса асинхронной страницы.

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)
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()

Возвращает коллекцию данных имя-значение, отправленную на страницу с помощью команды GET или POST, и без выполнения проверки запросов ASP.NET в запросе.

Dispose()

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.

(Унаследовано от Control)
EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.

(Унаследовано от Control)
EnsureChildControls()

Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы.

(Унаследовано от Control)
EnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.

(Унаследовано от Control)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Eval(String)

Оценивает выражение привязки данных.

(Унаследовано от TemplateControl)
Eval(String, String)

Оценивает выражение привязки данных, используя указанный формат строки для отображения результата.

(Унаследовано от TemplateControl)
ExecuteRegisteredAsyncTasks()

Начинает выполнение асинхронной задачи.

FindControl(String)

Ищет контейнер именования страниц для указанного серверного элемента управления с указанным идентификатором.

FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

(Унаследовано от Control)
Focus()

Задает фокус ввода на элемент управления.

(Унаследовано от Control)
FrameworkInitialize()

Инициализирует дерево элементов управления во время генерации страницы, на основе декларативной природы страницы.

FrameworkInitialize()

Инициализирует элемент контроля производного от класса TemplateControl.

(Унаследовано от TemplateControl)
GetDataItem()

Возвращает элемент данных на верху стека контекста привязки данных.

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)
GetPostBackClientEvent(Control, String)
Устаревшие..

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

GetPostBackClientHyperlink(Control, String)
Устаревшие..

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

GetPostBackEventReference(Control)
Устаревшие..

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

GetPostBackEventReference(Control, String)
Устаревшие..

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

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()

Устанавливает свойства Culture и UICulture текущего потока страницы.

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)

Анализирует входную строку в объекте Control на ASP.NET веб-форме в пользовательском элементе управления.

(Унаследовано от TemplateControl)
ParseControl(String, Boolean)

Анализирует входную строку в объекте Control на ASP.NET веб-странице в пользовательском элементе управления.

(Унаследовано от TemplateControl)
ProcessRequest(HttpContext)

Задает встроенные серверные объекты, относящиеся к объекту Page, такие как свойства Context, Request, Response и 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)
Устаревшие..

Предоставляет странице доступ к клиентскому событию OnSubmit. Скрипт должен являться обращением функции к клиентскому коду, зарегистрированному в другом месте.

RegisterRequiresControlState(Control)

Регистрирует элемент управления, как элемент управления с сохраняемым состоянием.

RegisterRequiresPostBack(Control)

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

RegisterRequiresRaiseEvent(IPostBackEventHandler)

Регистрирует серверный элемент управления ASP.NET, как требующий возникновения события при его обработке в объекте Page.

RegisterRequiresViewStateEncryption()

Регистрирует элемент управления со страницей, как требующий состояния элемента управления.

RegisterStartupScript(String, String)
Устаревшие..

Порождает клиентские блоки скриптов в качестве реакции страницы.

RegisterViewStateHandler()

Вызывает сохранение состояния отображения страницы.

RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.

(Унаследовано от Control)
Render(HtmlTextWriter)

Инициализирует объект HtmlTextWriter и вызывает дочерние элементы управления страницы Page для отображения.

Render(HtmlTextWriter)

Отправляет содержимое серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает содержимое для отрисовки в клиенте.

(Унаследовано от Control)
RenderChildren(HtmlTextWriter)

Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте.

(Унаследовано от Control)
RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.

(Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.

(Унаследовано от Control)
RequiresControlState(Control)

Определяет, зарегистрирован ли указанный объект Control для участия в управлении состоянием элемента управления.

ResolveAdapter()

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

(Унаследовано от Control)
ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.

(Унаследовано от Control)
ResolveUrl(String)

Преобразует 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)

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

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

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

(Унаследовано от Control)
TestDeviceFilter(String)

Возвращает логическое значение, которое указывает, используется ли фильтр устройств для HTTP-запроса.

(Унаследовано от TemplateControl)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
TrackViewState()

Вызывает отслеживание изменений состояния представления серверного элемента управления для сохранения в объекте StateBag серверного элемента управления. Этот объект доступен с помощью свойства ViewState.

(Унаследовано от Control)
TryUpdateModel<TModel>(TModel)

Обновляет заданный экземпляр модели, используя значения из элемента управления с привязкой к данным.

TryUpdateModel<TModel>(TModel, IValueProvider)

Обновляет экземпляр модели, используя значения, предоставленные указанным поставщиком значений.

UnregisterRequiresControlState(Control)

Отменяет сохранение состояния элемента управления для указанного элемента управления.

UpdateModel<TModel>(TModel)

Обновляет заданный экземпляр модели, используя значения из элемента управления с привязкой к данным.

UpdateModel<TModel>(TModel, IValueProvider)

Обновляет указанный экземпляр модели, используя значения, предоставленные указанным поставщиком значений.

Validate()

Требует, чтобы проверочные элементы управления, содержащиеся на странице, выполняли проверку связанных с ними сведений.

Validate(String)

Требует, чтобы проверочные элементы управления в указанной группе проверки осуществили проверку связанных с ними сведений.

VerifyRenderingInServerForm(Control)

Подтверждает, что элемент управления HtmlForm отображается для указанного серверного элемента управления ASP.NET во время выполнения.

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)
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)

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

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)

Включает поведение платформы динамических данных для указанного элемента управления данными.

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

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