Page Classe

Definição

Espaço de Nomes:: System.Web.UI

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um ficheiro .aspx, também conhecido como página de Formulários Web, solicitado a um servidor que aloja uma aplicação Web 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

Herança: Object

Control

TemplateControl
Page

Derivado: System.Web.UI.DataVisualization.Charting.ChartHttpHandler

System.Web.UI.MobileControls.MobilePage

Implementações: IHttpHandler

Exemplos

O exemplo de código seguinte demonstra como a Page classe é usada no modelo de página por trás do código. Note que o ficheiro-fonte code-behind declara uma classe parcial que herda de uma classe base de página. A classe base de página pode ser Page, ou pode ser outra classe que deriva de Page. Além disso, note-se que a classe parcial permite que o ficheiro code-behind use controlos definidos na página sem necessidade de os definir como membros do campo.

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

O seguinte exemplo de código mostra o ficheiro .aspx que corresponde ao ficheiro fonte code-behind anterior.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

<%@ 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>

Deve usar a diretiva @ Page e usar os Inherits atributos e CodeFile para ligar o ficheiro code-behind ao ficheiro .aspx. Neste exemplo, o atributo Inherits indica a MyCodeBehind classe e o CodeFile atributo indica o caminho para o ficheiro específico da linguagem que contém a classe.

O exemplo de código seguinte demonstra o modelo de página de ficheiro único e como aceder à IsPostBack propriedade e à Response propriedade do Pagearquivo .

<%@ 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>

Observações

A Page classe está associada a ficheiros que têm uma extensão .aspx. Estes ficheiros são compilados em tempo de execução como Page objetos e armazenados em cache na memória do servidor.

Se quiser criar uma página Web Forms usando a técnica code-behind, derive desta classe. Os designers de desenvolvimento rápido de aplicações (RAD), como o Microsoft Visual Studio, usam automaticamente este modelo para criar páginas de Web Forms.

O Page objeto serve como contentor de nomenclatura para todos os controlos do servidor numa página, exceto aqueles que implementam a INamingContainer interface ou são controlos filhos dos controlos que implementam esta interface.

A Page classe é um controlo que atua como interface de utilizador para a sua aplicação Web e, como tal, deve ser analisada para garantir que as melhores práticas para escrever código seguro e proteger aplicações são seguidas. Para informações gerais sobre estes temas, consulte Visão Geral das Ameaças à Segurança das Aplicações Web, Boas Práticas de Política de Segurança e Conceitos Chave de Segurança. Para informações mais específicas, veja Segurança dos Controlos Padrão, Como: Exibir Mensagens de Erro Seguras, Como: Proteger contra Explorações de Scripts numa Aplicação de Códigos Aplicando Codificação HTML a Strings, e Introdução aos Controlos de Validação.

Construtores

Name	Description
Page()	Inicializa uma nova instância da Page classe.

Campos

Name	Description
postEventArgumentID	Uma cadeia que define o campo oculto EVENTARGUMENT na página renderizada.
postEventSourceID	Uma string que define o campo oculto EVENTTARGET na página renderizada.

Propriedades

Name	Description
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
Application	Obtém o HttpApplicationState objeto para o pedido Web atual.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
AppRelativeVirtualPath	Obtém ou define o caminho do diretório virtual relativo à aplicação para o ficheiro a partir do qual o controlo é analisado e compilado. (Herdado de TemplateControl)
AspCompatMode	Define um valor que indica se a página pode ser executada numa thread single-threaded apartment (STA).
AsyncMode	Define um valor que indica se a página é processada de forma síncrona ou assíncrona.
AsyncTimeout	Recebe ou define um valor que indica o intervalo de tempo útil usado ao processar tarefas assíncronas.
AutoHandlers	Obsoleto. A propriedade AutoHandlers foi obsoleta no ASP.NET NET 2.0. É usado por classes geradas e não é destinado a ser usado dentro do seu código. (Herdado de TemplateControl)
AutoPostBackControl	Obtém ou define o controlo na página que é usado para realizar os postbacks.
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
Buffer	Define um valor que indica se a saída da página está em buffer.
Cache	Obtém o Cache objeto associado à aplicação onde a página reside.
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ClientID	Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
ClientQueryString	Obtém a parte da string de consulta do URL solicitado.
ClientScript	Obtém um ClientScriptManager objeto usado para gerir, registar e adicionar script à página.
ClientTarget	Obtém ou define um valor que permite sobrepor a deteção automática das capacidades do navegador e especificar como uma página é renderizada para determinados clientes do navegador.
CodePage	Define o identificador da página de códigos para o atual Page.
ContentType	Define o tipo HTTP MIME para o HttpResponse objeto associado à página.
Context	Obtém o HttpContext objeto associado à página.
Controls	Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface. (Herdado de Control)
Culture	Define o ID de cultura para o Thread objeto associado à página.
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
EnableEventValidation	Recebe ou define um valor que indica se a página valida eventos de postback e callback.
EnableTheming	Obtém ou define um valor booleano que indica se os temas se aplicam ao controlo derivado da TemplateControl classe. (Herdado de TemplateControl)
EnableViewState	Recebe ou define um valor que indica se a página mantém o seu estado de visualização, e o estado de visualização de qualquer servidor que a controle, quando o pedido de página atual termina.
EnableViewStateMac	Recebe ou define um valor que indica se o ASP.NET deve verificar os códigos de autenticação de mensagens (MAC) no estado de visualização da página quando a página é publicada de volta pelo cliente.
ErrorPage	Recebe ou define a página de erro para a qual o navegador solicitante é redirecionado no caso de uma exceção de página não tratada.
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
FileDependencies	Obsoleto. Define um array de ficheiros dos quais o objeto atual HttpResponse depende.
Form	Recebe o formulário HTML da página.
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
Header	Obtém o cabeçalho do documento para a página se o `head` elemento estiver definido com a `runat=server` na declaração da página.
ID	Obtém ou define um identificador para uma instância particular da Page classe.
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo ao construir um ID único para um controlo numa página.
IsAsync	Recebe um valor que indica se a página é processada de forma assíncrona.
IsCallback	Recebe um valor que indica se o pedido de página é resultado de um callback.
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsCrossPagePostBack	Recebe um valor que indica se a página está envolvida num devolução de publicação entre páginas.
IsPostBack	Recebe um valor que indica se a página está a ser renderizada pela primeira vez ou se está a ser carregada em resposta a um retorno de publicação.
IsPostBackEventControlRegistered	Recebe um valor que indica se o controlo na página que realiza os postbacks foi registado.
IsReusable	Recebe um valor que indica se o Page objeto pode ser reutilizado.
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsValid	Recebe um valor que indica se a validação da página teve sucesso.
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
Items	Obtém uma lista de objetos armazenados no contexto da página.
LCID	Define o identificador de localização para o Thread objeto associado à página.
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
MaintainScrollPositionOnPostBack	Recebe ou define um valor que indica se deve devolver o utilizador à mesma posição no navegador cliente após o postback. Esta propriedade substitui a propriedade obsoleta SmartNavigation .
Master	Obtém a página principal que determina o aspeto geral da página.
MasterPageFile	Obtém ou define o caminho virtual da página mestre.
MaxPageStateFieldLength	Obtém ou define o comprimento máximo para o campo de estado da página.
MetaDescription	Obtém ou define o conteúdo do elemento "descrição". `meta`
MetaKeywords	Obtém ou define o conteúdo do elemento "palavras-chave `meta` ".
ModelBindingExecutionContext	Obtém o contexto de execução que liga o modelo.
ModelState	Obtém o objeto do dicionário de estado do modelo que contém o estado do modelo e da validação da ligação ao modelo.
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
PageAdapter	Recebe o adaptador que renderiza a página para o navegador específico que faz o pedido.
PageStatePersister	Obtém o PageStatePersister objeto associado à página.
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
PreviousPage	Recebe a página que transferiu o controlo para a página atual.
RenderingCompatibility	Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
Request	Obtém o HttpRequest objeto para a página solicitada.
Response	Obtém o HttpResponse objeto associado ao Page objeto. Este objeto permite enviar dados de resposta HTTP para um cliente e contém informação sobre essa resposta.
ResponseEncoding	Define a linguagem de codificação para o objeto atual HttpResponse .
RouteData	Obtém o RouteData valor da instância atual RequestContext .
Server	Obtém o `Server` objeto, que é uma instância da HttpServerUtility classe.
Session	Recebe o objeto atual `Session` fornecido por ASP.NET.
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SkinID	Obtém ou fixa a pele para aplicar no controlo. (Herdado de Control)
SkipFormActionValidation	Recebe ou define um valor que indica se o valor da string de consulta está validado.
SmartNavigation	Obsoleto. Recebe ou define um valor que indica se a navegação inteligente está ativada. Esta propriedade está obsoleta.
StyleSheetTheme	Recebe ou define o nome do tema que é aplicado à página no início do ciclo de vida da página.
SupportAutoEvents	Recebe um valor que indica se o controlo TemplateControl suporta eventos automáticos. (Herdado de TemplateControl)
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
Theme	Obtém ou define o nome do tema da página.
Title	Recebe ou define o título da página.
Trace	Obtém o TraceContext objeto para o pedido Web atual.
TraceEnabled	Define um valor que indica se o traçado está ativado para o Page objeto.
TraceModeValue	Define o modo em que as instruções de traço são exibidas na página.
TransactionMode	Define o nível de suporte a transações para a página.
UICulture	Define o ID da interface de utilizador (UI) para o Thread objeto associado à página.
UniqueFilePathSuffix	Recebe um sufixo único para adicionar ao caminho do ficheiro para armazenamento em cache dos navegadores.
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
UnobtrusiveValidationMode	Recebe ou define um valor que indica se JavaScript discreto é usado para validação do lado do cliente.
User	Obtém informações sobre o utilizador a fazer o pedido de página.
ValidateRequestMode	Recebe ou define um valor que indica se a página verifica a entrada do cliente do navegador para valores potencialmente perigosos.
Validators	Obtém uma coleção de todos os controlos de validação contidos na página solicitada.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateEncryptionMode	Obtém ou define o modo de encriptação do estado de visualização.
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
ViewStateUserKey	Atribui um identificador a um utilizador individual na variável view-state associada à página atual.
Visible	Recebe ou define um valor que indica se o Page objeto é renderizado.

Métodos

Name	Description
AddContentTemplate(String, ITemplate)	É chamado durante a inicialização da página para criar uma coleção de conteúdo (a partir de controlos de conteúdo) que é entregue a uma página mestre, se a página atual ou a página-mestre se referir a uma página mestre.
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object)	Regista os delegados do gestor de eventos iniciais e finais para uma página assíncrona.
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler)	Regista delegados de gestores de eventos iniciais e finais que não necessitam de informação de estado para uma página assíncrona.
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
AddWrappedFileDependencies(Object)	Adiciona uma lista de ficheiros dependentes que compõem a página atual. Este método é usado internamente pelo framework de páginas ASP.NET e não se destina a ser usado diretamente a partir do seu código.
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
AspCompatBeginProcessRequest(HttpContext, AsyncCallback, Object)	Inicia um pedido de recursos da Página do Servidor Ativo (ASP). Este método é fornecido para compatibilidade com aplicações ASP legadas.
AspCompatEndProcessRequest(IAsyncResult)	Termina um pedido de recursos da Página do Servidor Ativo (ASP). Este método é fornecido para compatibilidade com aplicações ASP legadas.
AsyncPageBeginProcessRequest(HttpContext, AsyncCallback, Object)	Começa a processar um pedido de página assíncrono.
AsyncPageEndProcessRequest(IAsyncResult)	Termina o processamento de um pedido de página assíncrono.
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
Construct()	Executa lógica em tempo de design. (Herdado de TemplateControl)
CreateChildControls()	Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control)
CreateHtmlTextWriter(TextWriter)	Cria um HtmlTextWriter objeto para renderizar o conteúdo da página.
CreateHtmlTextWriterFromType(TextWriter, Type)	Cria um objeto especificado HtmlTextWriter para renderizar o conteúdo da página.
CreateResourceBasedLiteralControl(Int32, Int32, Boolean)	Acede a cadeias literais armazenadas num recurso. O CreateResourceBasedLiteralControl(Int32, Int32, Boolean) método não é destinado a ser usado dentro do seu código. (Herdado de TemplateControl)
DataBind()	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de Control)
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
DesignerInitialize()	Realiza qualquer inicialização da instância da Page classe que seja exigida pelos projetistas RAD. Este método é usado apenas no momento do projeto.
DeterminePostBackMode()	Devolve uma NameValueCollection quantidade de dados publicados à página usando um comando POST ou GET.
DeterminePostBackModeUnvalidated()	Devolve uma coleção nome-valor de dados que foi publicada na página usando um comando POST ou GET, sem realizar a validação do pedido ASP.NET no pedido.
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureID()	Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Eval(String, String)	Avalia uma expressão de ligação de dados usando a string de formato especificada para mostrar o resultado. (Herdado de TemplateControl)
Eval(String)	Avalia uma expressão de ligação de dados. (Herdado de TemplateControl)
ExecuteRegisteredAsyncTasks()	Inicia a execução de uma tarefa assíncrona.
FindControl(String, Int32)	Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomeação de páginas um controlo de servidor com o identificador especificado.
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada num controlo. (Herdado de Control)
FrameworkInitialize()	Inicializa a árvore de controlo durante a geração da página com base na natureza declarativa da página.
FrameworkInitialize()	Inicializa o controlo derivado da TemplateControl classe. (Herdado de TemplateControl)
GetDataItem()	Obtém o item de dados no topo da pilha de contexto de ligação de dados.
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetGlobalResourceObject(String, String, Type, String)	Obtém um objeto de recurso ao nível da aplicação com base nas propriedades e especificados ClassKey , ResourceKey no tipo de objeto e no nome da propriedade do recurso. (Herdado de TemplateControl)
GetGlobalResourceObject(String, String)	Obtém um objeto de recurso ao nível da aplicação com base nas propriedades e ClassKey especificadosResourceKey. (Herdado de TemplateControl)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetLocalResourceObject(String, Type, String)	Obtém um objeto de recurso ao nível da página com base na propriedade especificada ResourceKey , tipo de objeto e nome da propriedade. (Herdado de TemplateControl)
GetLocalResourceObject(String)	Obtém um objeto de recurso ao nível da página com base na propriedade especificada ResourceKey . (Herdado de TemplateControl)
GetPostBackClientEvent(Control, String)	Obsoleto. Obtém uma referência que pode ser usada num evento cliente para publicar de volta ao servidor para o controlo especificado e com os argumentos do evento especificados.
GetPostBackClientHyperlink(Control, String)	Obsoleto. Recebe uma referência, com `javascript:` anexada ao início, que pode ser usada num evento cliente para ser publicada de volta ao servidor para o controlo especificado e com os argumentos do evento especificados.
GetPostBackEventReference(Control, String)	Obsoleto. Devolve uma string que pode ser usada num evento cliente para causar postback ao servidor. A cadeia de referência é definida pelo controlo especificado que gere o postback e por um argumento de cadeia com informação adicional de evento.
GetPostBackEventReference(Control)	Obsoleto. Devolve uma string que pode ser usada num evento cliente para causar postback ao servidor. A cadeia de referência é definida pelo objeto especificado Control .
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetTypeHashCode()	Recupera um código de hash gerado por Page objetos gerados em tempo de execução. Este código de hash é exclusivo da Page hierarquia de controlo do objeto.
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
GetValidators(String)	Devolve uma coleção de validadores de controlo para um grupo de validação especificado.
GetWrappedFileDependencies(String[])	Devolve uma lista de nomes físicos de ficheiros que correspondem a uma lista de localizações virtuais de ficheiros.
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
InitializeCulture()	Define o Culture e UICulture para o tópico atual da página.
InitOutputCache(Int32, String, String, OutputCacheLocation, String)	Inicializa a cache de saída do pedido de página atual.
InitOutputCache(Int32, String, String, String, OutputCacheLocation, String)	Inicializa a cache de saída do pedido de página atual.
InitOutputCache(OutputCacheParameters)	Inicializa a cache de saída do pedido de página atual com base num OutputCacheParameters objeto.
IsClientScriptBlockRegistered(String)	Obsoleto. Determina se o bloco de script cliente com a chave especificada está registado na página.
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
IsStartupScriptRegistered(String)	Obsoleto. Determina se o script de arranque do cliente está registado no Page objeto.
LoadControl(String)	Carrega um Control objeto a partir de um ficheiro com base num caminho virtual especificado. (Herdado de TemplateControl)
LoadControl(Type, Object[])	Carrega um Control objeto com base num tipo especificado e nos parâmetros do construtor. (Herdado de TemplateControl)
LoadControlState(Object)	Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control)
LoadPageStateFromPersistenceMedium()	Carrega qualquer informação de estado de visualização guardada para o Page objeto.
LoadTemplate(String)	Obtém uma instância da ITemplate interface a partir de um ficheiro externo. (Herdado de TemplateControl)
LoadViewState(Object)	Restaura a informação de estado de visualização de um pedido anterior de página que foi guardado pelo SaveViewState() método. (Herdado de Control)
MapPath(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, ou um caminho relativo à aplicação se mapeia.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnAbortTransaction(EventArgs)	Eleva o AbortTransaction evento. (Herdado de TemplateControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control)
OnCommitTransaction(EventArgs)	Eleva o CommitTransaction evento. (Herdado de TemplateControl)
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnError(EventArgs)	Eleva o Error evento. (Herdado de TemplateControl)
OnInit(EventArgs)	Levanta o Init evento para inicializar a página.
OnInit(EventArgs)	Eleva o Init evento. (Herdado de Control)
OnInitComplete(EventArgs)	Levanta o InitComplete evento após a inicialização da página.
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnLoadComplete(EventArgs)	Aumenta o LoadComplete evento no final da fase de carregamento da página.
OnPreInit(EventArgs)	Levanta o PreInit evento no início da inicialização da página.
OnPreLoad(EventArgs)	Levanta o PreLoad evento depois de os dados de postback serem carregados nos controlos do servidor de páginas, mas antes do OnLoad(EventArgs) evento.
OnPreRender(EventArgs)	Eleva o PreRender evento. (Herdado de Control)
OnPreRenderComplete(EventArgs)	Aumenta o PreRenderComplete evento após o OnPreRenderComplete(EventArgs) evento e antes da página ser renderizada.
OnSaveStateComplete(EventArgs)	Eleva o SaveStateComplete evento depois de o estado da página ter sido guardado para o meio de persistência.
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
ParseControl(String, Boolean)	Analisa uma cadeia de entrada num objeto Control na página Web ASP.NET ou controlo do utilizador. (Herdado de TemplateControl)
ParseControl(String)	Analisa uma cadeia de entrada num Control objeto na página Web Forms ou no controlo do utilizador. (Herdado de TemplateControl)
ProcessRequest(HttpContext)	Define os objetos intrínsecos do servidor do Page objeto, como os Context, Request, Response, e Application as propriedades.
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RaisePostBackEvent(IPostBackEventHandler, String)	Notifica o controlo do servidor que causou o postback de que deve lidar com um evento de postback que se aproxima.
ReadStringResource()	Lê um recurso de cadeia. O ReadStringResource() método não é destinado a ser usado dentro do seu código. (Herdado de TemplateControl)
RegisterArrayDeclaration(String, String)	Obsoleto. Declara um valor que é declarado como uma declaração de array ECMAScript quando a página é renderizada.
RegisterAsyncTask(PageAsyncTask)	Regista uma nova tarefa assíncrona na página.
RegisterClientScriptBlock(String, String)	Obsoleto. Emite blocos de script do lado do cliente para a resposta.
RegisterHiddenField(String, String)	Obsoleto. Permite aos controlos do servidor registar automaticamente um campo oculto no formulário. O campo será enviado para o Page objeto quando o HtmlForm controlo do servidor for renderizado.
RegisterOnSubmitStatement(String, String)	Obsoleto. Permite que uma página aceda ao evento do cliente `OnSubmit` . O script deve ser uma chamada de função para o código do cliente registado noutro local.
RegisterRequiresControlState(Control)	Regista um controlo como aquele cujo estado de controlo deve ser mantido.
RegisterRequiresPostBack(Control)	Regista um controlo como um que requer tratamento de postback quando a página é publicada de volta no servidor.
RegisterRequiresRaiseEvent(IPostBackEventHandler)	Regista um controlo ASP.NET servidor como aquele que exige que um evento seja levantado quando o controlo é processado no objeto Page.
RegisterRequiresViewStateEncryption()	Regista um controlo com a página como sendo necessário encriptação do estado de visualização.
RegisterStartupScript(String, String)	Obsoleto. Emite um bloco de script do lado do cliente na resposta da página.
RegisterViewStateHandler()	Faz com que o estado de visualização da página seja mantido, se for chamado.
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Inicializa o HtmlTextWriter objeto e chama os controlos filhos do Page para renderizar.
Render(HtmlTextWriter)	Envia conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control)
RequiresControlState(Control)	Determina se o objeto especificado Control está registado para participar na gestão do estado de controlo.
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control)
SavePageStateToPersistenceMedium(Object)	Guarda qualquer informação de estado de visualização e estado de controlo para a página.
SaveViewState()	Guarda quaisquer alterações de estado de visualização no controlo do servidor que tenham ocorrido desde o momento em que a página foi publicada de volta no servidor. (Herdado de Control)
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
SetFocus(Control)	Define o foco do navegador para o controlo especificado.
SetFocus(String)	Define o foco do navegador para o controlo com o identificador especificado.
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetStringResourcePointer(Object, Int32)	Define um ponteiro para um recurso de string. O SetStringResourcePointer(Object, Int32) método é usado por classes geradas e não é destinado a ser usado dentro do seu código. (Herdado de TemplateControl)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
TestDeviceFilter(String)	Devolve um valor Booleano que indica se um filtro de dispositivo se aplica ao pedido HTTP. (Herdado de TemplateControl)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Causa o rastreio das alterações de estado de visualização no controlo do servidor para que possam ser armazenadas no objeto do StateBag controlo do servidor. Este objeto é acessível através da ViewState propriedade. (Herdado de Control)
TryUpdateModel<TModel>(TModel, IValueProvider)	Atualiza a instância do modelo usando valores do fornecedor de valores especificado.
TryUpdateModel<TModel>(TModel)	Atualiza a instância do modelo especificada usando valores do controlo data-bound.
UnregisterRequiresControlState(Control)	Para a persistência do estado de controlo para o controlo especificado.
UpdateModel<TModel>(TModel, IValueProvider)	Atualiza a instância do modelo especificada usando valores de um fornecedor de valor especificado.
UpdateModel<TModel>(TModel)	Atualiza a instância do modelo especificada usando valores do controlo data-bound.
Validate()	Instrui quaisquer controlos de validação incluídos na página a validarem a informação atribuída.
Validate(String)	Instrui os controlos de validação no grupo de validação especificado a validarem a informação atribuída.
VerifyRenderingInServerForm(Control)	Confirma que um controlo HtmlForm é renderizado para o controlo do servidor ASP.NET especificado em tempo de execução.
WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)	Escreve uma cadeia de recursos num HtmlTextWriter controlo. O WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) método é usado por classes geradas e não é destinado a ser usado dentro do seu código. (Herdado de TemplateControl)
XPath(String, IXmlNamespaceResolver)	Avalia uma expressão de ligação de dados XPath usando o prefixo especificado e os mapeamentos de namespace para resolução de namespace. (Herdado de TemplateControl)
XPath(String, String, IXmlNamespaceResolver)	Avalia uma expressão de ligação de dados XPath usando o prefixo especificado e os mapeamentos do espaço de nomes para resolução do espaço de nomes e a string de formato especificada para mostrar o resultado. (Herdado de TemplateControl)
XPath(String, String)	Avalia uma expressão de ligação de dados XPath usando a string de formato especificada para mostrar o resultado. (Herdado de TemplateControl)
XPath(String)	Avalia uma expressão de ligação de dados XPath. (Herdado de TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)	Avalia uma expressão de ligação de dados XPath usando o prefixo especificado e os mapeamentos de namespace para resolução de namespace e retorna uma coleção de nós que implementa a IEnumerable interface. (Herdado de TemplateControl)
XPathSelect(String)	Avalia uma expressão de ligação de dados XPath e devolve uma coleção de nós que implementa a IEnumerable interface. (Herdado de TemplateControl)

evento

Name	Description
AbortTransaction	Ocorre quando um utilizador termina uma transação. (Herdado de TemplateControl)
CommitTransaction	Ocorre quando uma transação é concluída. (Herdado de TemplateControl)
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Error	Ocorre quando uma exceção não tratada é lançada. (Herdado de TemplateControl)
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
InitComplete	Ocorre quando a inicialização da página está concluída.
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
LoadComplete	Ocorre no final da fase de carregamento do ciclo de vida da página.
PreInit	Ocorre antes da inicialização da página.
PreLoad	Ocorre antes do evento da página Load .
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
PreRenderComplete	Ocorre antes do conteúdo da página ser renderizado.
SaveStateComplete	Ocorre depois de a página ter terminado de guardar toda a informação do estado de visualização e do estado de controlo da página e dos controlos na página.
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)

Implementações de Interface Explícita

Name	Description
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IFilterResolutionService.CompareFilters(String, String)	Devolve um valor que indica se existe uma relação pai/filho entre dois filtros de dispositivo especificados. (Herdado de TemplateControl)
IFilterResolutionService.EvaluateFilter(String)	Devolve um valor que indica se o filtro especificado é um tipo do objeto do filtro atual. (Herdado de TemplateControl)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)

Métodos da Extensão

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
FindDataSourceControl(Control)	Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)	Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)	Devolve o objeto metatable para o controlo de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a recolha dos valores padrão para o controlo de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controlo de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Ver também

Comentários

Esta página foi útil?