Compartilhar via


Page Classe

Definição

Representa um arquivo .aspx, também conhecido como uma página dos Web Forms, solicitado de um servidor que hospeda um aplicativo 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
Derivado
Implementações

Exemplos

O exemplo de código a seguir demonstra como a Page classe é usada no modelo de página code-behind. Observe que o arquivo de origem code-behind declara uma classe parcial que herda de uma classe de página base. A classe de página base pode ser Page, ou pode ser outra classe que deriva de Page. Além disso, observe que a classe parcial permite que o arquivo code-behind use controles definidos na página sem a necessidade de defini-los como membros de 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 exemplo de código a seguir mostra o arquivo .aspx que corresponde ao arquivo de origem code-behind anterior.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma potencial ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das Explorações de Script.

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

Você deve usar a diretiva @ Page e usar os Inherits atributos e CodeFile para vincular o arquivo code-behind ao arquivo .aspx. Neste exemplo, o Inherits atributo indica a MyCodeBehind classe e o CodeFile atributo indica o caminho para o arquivo específico do idioma que contém a classe.

O exemplo de código a Pageseguir demonstra o modelo de página de arquivo único e como acessar a IsPostBack propriedade e a Response propriedade do .

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

Comentários

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

Se você quiser criar uma página do Web Forms usando a técnica code-behind, derive dessa classe. Designers de RAD (desenvolvimento rápido de aplicativos), como o Microsoft Visual Studio, usam automaticamente esse modelo para criar páginas do Web Forms.

O Page objeto serve como o contêiner de nomenclatura para todos os controles de servidor em uma página, exceto aqueles que implementam a INamingContainer interface ou são controles filho de controles que implementam essa interface.

A Page classe é um controle que atua como a interface do usuário para seu aplicativo Web e, como tal, deve ser examinada para garantir que as práticas recomendadas para escrever código seguro e proteger aplicativos sejam seguidas. Para obter informações gerais sobre esses tópicos, consulte Visão geral das ameaças à segurança do aplicativo Web, práticas recomendadas de política de segurança e principais conceitos de segurança. Para obter informações mais específicas, consulte Como proteger controles padrão, como exibir mensagens de erro seguras, como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres e introdução aos controles de validação.

Construtores

Nome Description
Page()

Inicializa uma nova instância da classe Page.

Campos

Nome Description
postEventArgumentID

Uma cadeia de caracteres que define o campo oculto EVENTARGUMENT na página renderizada.

postEventSourceID

Uma cadeia de caracteres que define o campo oculto EVENTTARGET na página renderizada.

Propriedades

Nome Description
Adapter

Obtém o adaptador específico do navegador para o controle.

(Herdado de Control)
Application

Obtém o HttpApplicationState objeto da solicitação da Web atual.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle.

(Herdado de Control)
AppRelativeVirtualPath

Obtém ou define o caminho do diretório virtual relativo ao aplicativo para o arquivo do qual o controle é analisado e compilado.

(Herdado de TemplateControl)
AspCompatMode

Define um valor que indica se a página pode ser executada em um thread STA (apartamento com thread único).

AsyncMode

Define um valor que indica se a página é processada de forma síncrona ou assíncrona.

AsyncTimeout

Obtém ou define um valor que indica o intervalo de tempo limite usado ao processar tarefas assíncronas.

AutoHandlers
Obsoleto.

A AutoHandlers propriedade foi preterida no ASP.NET NET 2.0. Ele é usado por classes geradas e não se destina a ser usado em seu código.

(Herdado de TemplateControl)
AutoPostBackControl

Obtém ou define o controle na página usada para executar postbacks.

BindingContainer

Obtém o controle que contém a associação de dados desse controle.

(Herdado de Control)
Buffer

Define um valor que indica se a saída da página é armazenada em buffer.

Cache

Obtém o Cache objeto associado ao aplicativo no qual a página reside.

ChildControlsCreated

Obtém um valor que indica se os controles filho do controle do servidor foram criados.

(Herdado de Control)
ClientID

Obtém a ID de controle para marcação HTML gerada por ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade.

(Herdado de Control)
ClientQueryString

Obtém a parte da cadeia de caracteres de consulta da URL solicitada.

ClientScript

Obtém um ClientScriptManager objeto usado para gerenciar, registrar e adicionar script à página.

ClientTarget

Obtém ou define um valor que permite substituir a detecção automática de recursos do navegador e especificar como uma página é renderizada para determinados clientes do navegador.

CodePage

Define o identificador de página de código 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 controles filho para um controle de servidor especificado na hierarquia da interface do usuário.

(Herdado de Control)
Culture

Define a ID de cultura do Thread objeto associado à página.

DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl.

(Herdado de Control)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.

(Herdado de Control)
EnableEventValidation

Obtém ou define um valor que indica se a página valida eventos de postback e retorno de chamada.

EnableTheming

Obtém ou define um valor booliano que indica se os temas se aplicam ao controle derivado da TemplateControl classe.

(Herdado de TemplateControl)
EnableViewState

Obtém ou define um valor que indica se a página mantém seu estado de exibição e o estado de exibição de todos os controles de servidor que ele contém, quando a solicitação de página atual termina.

EnableViewStateMac

Obtém ou define um valor que indica se ASP.NET deve verificar os códigos de autenticação de mensagem (MAC) no estado de exibição da página quando a página é postada novamente do cliente.

ErrorPage

Obtém ou define a página de erro para a qual o navegador solicitante é redirecionado no caso de uma exceção de página sem tratamento.

Events

Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura.

(Herdado de Control)
FileDependencies
Obsoleto.

Define uma matriz de arquivos dos quais o objeto atual HttpResponse depende.

Form

Obtém o formulário HTML da página.

HasChildViewState

Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas.

(Herdado de Control)
Header

Obtém o cabeçalho do documento da página se o head elemento for definido com uma runat=server declaração na página.

ID

Obtém ou define um identificador para uma instância específica da Page classe.

IdSeparator

Obtém o caractere usado para separar identificadores de controle ao criar uma ID exclusiva para um controle em uma página.

IsAsync

Obtém um valor que indica se a página é processada de forma assíncrona.

IsCallback

Obtém um valor que indica se a solicitação de página é o resultado de um retorno de chamada.

IsChildControlStateCleared

Obtém um valor que indica se os controles contidos nesse controle têm estado de controle.

(Herdado de Control)
IsCrossPagePostBack

Obtém um valor que indica se a página está envolvida em um postback entre páginas.

IsPostBack

Obtém um valor que indica se a página está sendo renderizada pela primeira vez ou está sendo carregada em resposta a um postback.

IsPostBackEventControlRegistered

Obtém um valor que indica se o controle na página que executa postbacks foi registrado.

IsReusable

Obtém um valor que indica se o Page objeto pode ser reutilizado.

IsTrackingViewState

Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição.

(Herdado de Control)
IsValid

Obtém um valor que indica se a validação de página foi bem-sucedida.

IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.

(Herdado de Control)
Items

Obtém uma lista de objetos armazenados no contexto da página.

LCID

Define o identificador de localidade do Thread objeto associado à página.

LoadViewStateByID

Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice.

(Herdado de Control)
MaintainScrollPositionOnPostBack

Obtém ou define um valor que indica se o usuário deve retornar à mesma posição no navegador do cliente após o postback. Essa propriedade substitui a propriedade obsoleta SmartNavigation .

Master

Obtém a página mestra que determina a aparência geral da página.

MasterPageFile

Obtém ou define o caminho virtual da página mestra.

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 "description meta ".

MetaKeywords

Obtém ou define o conteúdo do elemento "palavras-chave" meta .

ModelBindingExecutionContext

Obtém o contexto de execução de associação de modelo.

ModelState

Obtém o objeto de dicionário de estado do modelo que contém o estado do modelo e da validação de associação de modelo.

NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles 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 controle do servidor.

(Herdado de Control)
PageAdapter

Obtém o adaptador que renderiza a página do navegador de solicitação específico.

PageStatePersister

Obtém o PageStatePersister objeto associado à página.

Parent

Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página.

(Herdado de Control)
PreviousPage

Obtém a página que transferiu o controle para a página atual.

RenderingCompatibility

Obtém 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 da página solicitada.

Response

Obtém o HttpResponse objeto associado ao Page objeto. Esse objeto permite enviar dados de resposta HTTP para um cliente e contém informações 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

Obtém o objeto atual Session fornecido pelo ASP.NET.

Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design.

(Herdado de Control)
SkinID

Obtém ou define a pele a ser aplicada ao controle.

(Herdado de Control)
SkipFormActionValidation

Obtém ou define um valor que indica se o valor da cadeia de caracteres de consulta é validado.

SmartNavigation
Obsoleto.

Obtém ou define um valor que indica se a navegação inteligente está habilitada. Esta propriedade está obsoleta.

StyleSheetTheme

Obtém ou define o nome do tema aplicado à página no início do ciclo de vida da página.

SupportAutoEvents

Obtém um valor que indica se o controle dá suporte a TemplateControl eventos automáticos.

(Herdado de TemplateControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém esse controle.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual.

(Herdado de Control)
Theme

Obtém ou define o nome do tema da página.

Title

Obtém ou define o título da página.

Trace

Obtém o TraceContext objeto da solicitação da Web atual.

TraceEnabled

Define um valor que indica se o rastreamento está habilitado para o Page objeto.

TraceModeValue

Define o modo no qual as instruções de rastreamento são exibidas na página.

TransactionMode

Define o nível de suporte à transação para a página.

UICulture

Define a ID da interface do usuário para o Thread objeto associado à página.

UniqueFilePathSuffix

Obtém um sufixo exclusivo a ser acrescentado ao caminho do arquivo para armazenar em cache navegadores.

UniqueID

Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor.

(Herdado de Control)
UnobtrusiveValidationMode

Obtém ou define um valor que indica se JavaScript discreto é usado para validação do lado do cliente.

User

Obtém informações sobre o usuário que está fazendo a solicitação de página.

ValidateRequestMode

Obtém ou define um valor que indica se a página verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos.

Validators

Obtém uma coleção de todos os controles de validação contidos na página solicitada.

ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.

(Herdado de Control)
ViewStateEncryptionMode

Obtém ou define o modo de criptografia do estado de exibição.

ViewStateIgnoresCase

Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição desse controle.

(Herdado de Control)
ViewStateUserKey

Atribui um identificador a um usuário individual na variável de estado de exibição associada à página atual.

Visible

Obtém ou define um valor que indica se o Page objeto é renderizado.

Métodos

Nome Description
AddContentTemplate(String, ITemplate)

Chamado durante a inicialização da página para criar uma coleção de conteúdo (a partir de controles de conteúdo) que será entregue a uma página mestra, se a página atual ou a página mestra se referir a uma página mestra.

AddedControl(Control, Int32)

Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto.

(Herdado de Control)
AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler, Object)

Registra os delegados do manipulador de eventos iniciais e finais para uma página assíncrona.

AddOnPreRenderCompleteAsync(BeginEventHandler, EndEventHandler)

Registra delegados do manipulador de eventos iniciais e finais que não exigem informações de estado para uma página assíncrona.

AddParsedSubObject(Object)

Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor.

(Herdado de Control)
AddWrappedFileDependencies(Object)

Adiciona uma lista de arquivos dependentes que compõem a página atual. Esse método é usado internamente pela estrutura de página ASP.NET e não se destina a ser usado diretamente do código.

ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos de página ao controle.

(Herdado de Control)
AspCompatBeginProcessRequest(HttpContext, AsyncCallback, Object)

Inicia uma solicitação para recursos do ASP (Active Server Page). Esse método é fornecido para compatibilidade com aplicativos ASP herdados.

AspCompatEndProcessRequest(IAsyncResult)

Encerra uma solicitação para recursos da Página do Servidor Ativo (ASP). Esse método é fornecido para compatibilidade com aplicativos ASP herdados.

AsyncPageBeginProcessRequest(HttpContext, AsyncCallback, Object)

Começa a processar uma solicitação de página assíncrona.

AsyncPageEndProcessRequest(IAsyncResult)

Termina o processamento de uma solicitação de página assíncrona.

BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento em tempo de design dos dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor armazenado em ClientID cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle do servidor.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle do servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit.

(Herdado de Control)
Construct()

Executa a lógica de tempo de design.

(Herdado de TemplateControl)
CreateChildControls()

Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta ou renderização.

(Herdado de Control)
CreateControlCollection()

Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle 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)

Acessa cadeias de caracteres literais armazenadas em um recurso. O CreateResourceBasedLiteralControl(Int32, Int32, Boolean) método não se destina ao uso de dentro do código.

(Herdado de TemplateControl)
DataBind()

Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho.

(Herdado de Control)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.

(Herdado de Control)
DesignerInitialize()

Executa qualquer inicialização da instância da Page classe exigida pelos designers RAD. Esse método é usado somente em tempo de design.

DeterminePostBackMode()

Retorna um NameValueCollection dos dados postados novamente na página usando um comando POST ou GET.

DeterminePostBackModeUnvalidated()

Retorna uma coleção nome-valor de dados que foi postada na página usando um comando POST ou GET, sem executar ASP.NET validação de solicitação na solicitação.

Dispose()

Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento em tempo de design dos dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho.

(Herdado de Control)
EnsureID()

Cria um identificador para controles 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 associação de dados usando a cadeia de caracteres de formato especificada para exibir o resultado.

(Herdado de TemplateControl)
Eval(String)

Avalia uma expressão de associação de dados.

(Herdado de TemplateControl)
ExecuteRegisteredAsyncTasks()

Inicia a execução de uma tarefa assíncrona.

FindControl(String, Int32)

Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado id e um inteiro, especificado no parâmetro, que pathOffset ajuda na pesquisa. Você não deve substituir essa versão do FindControl método.

(Herdado de Control)
FindControl(String)

Pesquisa o contêiner de nomenclatura de página para um controle de servidor com o identificador especificado.

FindControl(String)

Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado id .

(Herdado de Control)
Focus()

Define o foco de entrada como um controle.

(Herdado de Control)
FrameworkInitialize()

Inicializa a árvore de controle durante a geração de página com base na natureza declarativa da página.

FrameworkInitialize()

Inicializa o controle derivado da TemplateControl classe.

(Herdado de TemplateControl)
GetDataItem()

Obtém o item de dados na parte superior da pilha de contexto de associação de dados.

GetDesignModeState()

Obtém dados de tempo de design para um controle.

(Herdado de Control)
GetGlobalResourceObject(String, String, Type, String)

Obtém um objeto de recurso no nível do aplicativo com base nas propriedades especificadas ClassKey e ResourceKey nas propriedades, no tipo de objeto e no nome da propriedade do recurso.

(Herdado de TemplateControl)
GetGlobalResourceObject(String, String)

Obtém um objeto de recurso no nível do aplicativo com base nas propriedades e ResourceKey especificadasClassKey.

(Herdado de TemplateControl)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetLocalResourceObject(String, Type, String)

Obtém um objeto de recurso no nível da página com base na propriedade, no tipo de objeto e no nome da propriedade especificados ResourceKey .

(Herdado de TemplateControl)
GetLocalResourceObject(String)

Obtém um objeto de recurso no 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 em um evento cliente para postar de volta no servidor para o controle especificado e com os argumentos de evento especificados.

GetPostBackClientHyperlink(Control, String)
Obsoleto.

Obtém uma referência, acrescentada javascript: ao início dela, que pode ser usada em um evento cliente para postar de volta no servidor para o controle especificado e com os argumentos de evento especificados.

GetPostBackEventReference(Control, String)
Obsoleto.

Retorna uma cadeia de caracteres que pode ser usada em um evento cliente para causar postback no servidor. A cadeia de caracteres de referência é definida pelo controle especificado que manipula o postback e um argumento de cadeia de caracteres de informações de evento adicionais.

GetPostBackEventReference(Control)
Obsoleto.

Retorna uma cadeia de caracteres que pode ser usada em um evento cliente para causar postback no servidor. A cadeia de caracteres 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 a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetTypeHashCode()

Recupera um código hash gerado por Page objetos que são gerados em tempo de execução. Esse código hash é exclusivo da Page hierarquia de controle do objeto.

GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da UniqueID propriedade do controle especificado.

(Herdado de Control)
GetValidators(String)

Retorna uma coleção de validadores de controle para um grupo de validação especificado.

GetWrappedFileDependencies(String[])

Retorna uma lista de nomes de arquivos físicos que correspondem a uma lista de locais de arquivos virtuais.

HasControls()

Determina se o controle do servidor contém controles filho.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho.

(Herdado de Control)
InitializeCulture()

Define o Culture thread atual da página e UICulture para o thread atual.

InitOutputCache(Int32, String, String, OutputCacheLocation, String)

Inicializa o cache de saída para a solicitação de página atual.

InitOutputCache(Int32, String, String, String, OutputCacheLocation, String)

Inicializa o cache de saída para a solicitação de página atual.

InitOutputCache(OutputCacheParameters)

Inicializa o cache de saída para a solicitação de página atual com base em um OutputCacheParameters objeto.

IsClientScriptBlockRegistered(String)
Obsoleto.

Determina se o bloco de script do cliente com a chave especificada está registrado na página.

IsLiteralContent()

Determina se o controle do servidor contém apenas conteúdo literal.

(Herdado de Control)
IsStartupScriptRegistered(String)
Obsoleto.

Determina se o script de inicialização do cliente está registrado com o Page objeto.

LoadControl(String)

Carrega um Control objeto de um arquivo com base em um caminho virtual especificado.

(Herdado de TemplateControl)
LoadControl(Type, Object[])

Carrega um Control objeto com base em um tipo e parâmetros de construtor especificados.

(Herdado de TemplateControl)
LoadControlState(Object)

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo SaveControlState() método.

(Herdado de Control)
LoadPageStateFromPersistenceMedium()

Carrega todas as informações de estado de exibição salvas para o Page objeto.

LoadTemplate(String)

Obtém uma instância da ITemplate interface de um arquivo externo.

(Herdado de TemplateControl)
LoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação de página anterior que foi salva pelo SaveViewState() método.

(Herdado de Control)
MapPath(String)

Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, ou um caminho relativo ao aplicativo é mapeado.

MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
OnAbortTransaction(EventArgs)

Aciona o evento AbortTransaction.

(Herdado de TemplateControl)
OnBubbleEvent(Object, EventArgs)

Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página.

(Herdado de Control)
OnCommitTransaction(EventArgs)

Aciona o evento CommitTransaction.

(Herdado de TemplateControl)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnError(EventArgs)

Aciona o evento Error.

(Herdado de TemplateControl)
OnInit(EventArgs)

Aciona o Init evento para inicializar a página.

OnInit(EventArgs)

Aciona o evento Init.

(Herdado de Control)
OnInitComplete(EventArgs)

Gera o InitComplete evento após a inicialização da página.

OnLoad(EventArgs)

Aciona o evento Load.

(Herdado de Control)
OnLoadComplete(EventArgs)

Aciona o LoadComplete evento no final do estágio de carregamento da página.

OnPreInit(EventArgs)

Gera o PreInit evento no início da inicialização da página.

OnPreLoad(EventArgs)

Gera o PreLoad evento depois que os dados de postback são carregados nos controles do servidor de página, mas antes do OnLoad(EventArgs) evento.

OnPreRender(EventArgs)

Aciona o evento PreRender.

(Herdado de Control)
OnPreRenderComplete(EventArgs)

Aciona o PreRenderComplete evento após o OnPreRenderComplete(EventArgs) evento e antes que a página seja renderizada.

OnSaveStateComplete(EventArgs)

Aciona o SaveStateComplete evento depois que o estado da página é salvo no meio de persistência.

OnUnload(EventArgs)

Aciona o evento Unload.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.

(Herdado de Control)
ParseControl(String, Boolean)

Analisa uma cadeia de caracteres de entrada em um Control objeto na página da Web ASP.NET ou no controle do usuário.

(Herdado de TemplateControl)
ParseControl(String)

Analisa uma cadeia de caracteres de entrada em um Control objeto na página do Web Forms ou no controle de usuário.

(Herdado de TemplateControl)
ProcessRequest(HttpContext)

Define os objetos de servidor intrínsecos do Page objeto, como o Context, Requeste ResponseApplication as propriedades.

RaiseBubbleEvent(Object, EventArgs)

Atribui todas as fontes do evento e suas informações ao pai do controle.

(Herdado de Control)
RaisePostBackEvent(IPostBackEventHandler, String)

Notifica o controle do servidor que causou o postback de que ele deve lidar com um evento de postback de entrada.

ReadStringResource()

Lê um recurso de cadeia de caracteres. O ReadStringResource() método não se destina ao uso de dentro do código.

(Herdado de TemplateControl)
RegisterArrayDeclaration(String, String)
Obsoleto.

Declara um valor declarado como uma declaração de matriz ECMAScript quando a página é renderizada.

RegisterAsyncTask(PageAsyncTask)

Registra uma nova tarefa assíncrona com a página.

RegisterClientScriptBlock(String, String)
Obsoleto.

Emite blocos de script do lado do cliente para a resposta.

RegisterHiddenField(String, String)
Obsoleto.

Permite que os controles do servidor registrem automaticamente um campo oculto no formulário. O campo será enviado ao Page objeto quando o controle do HtmlForm servidor for renderizado.

RegisterOnSubmitStatement(String, String)
Obsoleto.

Permite que uma página acesse o evento do cliente OnSubmit . O script deve ser uma chamada de função para o código do cliente registrado em outro lugar.

RegisterRequiresControlState(Control)

Registra um controle como aquele cujo estado de controle deve ser persistente.

RegisterRequiresPostBack(Control)

Registra um controle como aquele que requer tratamento de postback quando a página é postada de volta no servidor.

RegisterRequiresRaiseEvent(IPostBackEventHandler)

Registra um controle de servidor ASP.NET como um que exige que um evento seja acionado quando o controle é processado no Page objeto.

RegisterRequiresViewStateEncryption()

Registra um controle com a página como um que exige criptografia de estado de exibiçã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 exibição de página seja mantido, se chamado.

RemovedControl(Control)

Chamado depois que um controle filho é removido da Controls coleção do Control objeto.

(Herdado de Control)
Render(HtmlTextWriter)

Inicializa o HtmlTextWriter objeto e chama os controles filho da Page renderização.

Render(HtmlTextWriter)

Envia o conteúdo do controle do servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter .

(Herdado de Control)
RenderControl(HtmlTextWriter)

O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado.

(Herdado de Control)
RequiresControlState(Control)

Determina se o objeto especificado Control está registrado para participar do gerenciamento de estado de controle.

ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que é utilizável no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor.

(Herdado de Control)
SavePageStateToPersistenceMedium(Object)

Salva qualquer informação de estado de exibição e de estado de controle para a página.

SaveViewState()

Salva as alterações de estado de exibição de controle do servidor que ocorreram desde o momento em que a página foi postada novamente no servidor.

(Herdado de Control)
SetDesignModeState(IDictionary)

Define dados de tempo de design para um controle.

(Herdado de Control)
SetFocus(Control)

Define o foco do navegador como o controle especificado.

SetFocus(String)

Define o foco do navegador para o controle com o identificador especificado.

SetRenderMethodDelegate(RenderMethod)

Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai.

(Herdado de Control)
SetStringResourcePointer(Object, Int32)

Define um ponteiro para um recurso de cadeia de caracteres. O SetStringResourcePointer(Object, Int32) método é usado por classes geradas e não se destina a ser usado de dentro do código.

(Herdado de TemplateControl)
SetTraceData(Object, Object, Object)

Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento.

(Herdado de Control)
SetTraceData(Object, Object)

Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento.

(Herdado de Control)
TestDeviceFilter(String)

Retorna um valor booliano que indica se um filtro de dispositivo se aplica à solicitação HTTP.

(Herdado de TemplateControl)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Causa o acompanhamento de alterações de estado de exibição no controle do servidor para que possam ser armazenadas no objeto do controle do StateBag servidor. Esse objeto é acessível por meio da ViewState propriedade.

(Herdado de Control)
TryUpdateModel<TModel>(TModel, IValueProvider)

Atualiza a instância do modelo usando valores do provedor de valor especificado.

TryUpdateModel<TModel>(TModel)

Atualiza a instância de modelo especificada usando valores do controle associado a dados.

UnregisterRequiresControlState(Control)

Interrompe a persistência do estado de controle para o controle especificado.

UpdateModel<TModel>(TModel, IValueProvider)

Atualiza a instância de modelo especificada usando valores de um provedor de valor especificado.

UpdateModel<TModel>(TModel)

Atualiza a instância de modelo especificada usando valores do controle associado a dados.

Validate()

Instrui todos os controles de validação incluídos na página para validar suas informações atribuídas.

Validate(String)

Instrui os controles de validação no grupo de validação especificado para validar suas informações atribuídas.

VerifyRenderingInServerForm(Control)

Confirma se um HtmlForm controle é renderizado para o controle de servidor ASP.NET especificado em tempo de execução.

WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)

Grava uma cadeia de caracteres de recurso em um HtmlTextWriter controle. O WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) método é usado por classes geradas e não se destina a ser usado de dentro do código.

(Herdado de TemplateControl)
XPath(String, IXmlNamespaceResolver)

Avalia uma expressão de associação de dados XPath usando os mapeamentos de prefixo e namespace especificados para resolução de namespace.

(Herdado de TemplateControl)
XPath(String, String, IXmlNamespaceResolver)

Avalia uma expressão de associação de dados XPath usando os mapeamentos de prefixo e namespace especificados para resolução de namespace e a cadeia de caracteres de formato especificada para exibir o resultado.

(Herdado de TemplateControl)
XPath(String, String)

Avalia uma expressão de associação de dados XPath usando a cadeia de caracteres de formato especificada para exibir o resultado.

(Herdado de TemplateControl)
XPath(String)

Avalia uma expressão de associação de dados XPath.

(Herdado de TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)

Avalia uma expressão de associação de dados XPath usando os mapeamentos de prefixo e namespace especificados 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 associação de dados XPath e retorna uma coleção de nós que implementa a IEnumerable interface.

(Herdado de TemplateControl)

Eventos

Nome Description
AbortTransaction

Ocorre quando um usuário termina uma transação.

(Herdado de TemplateControl)
CommitTransaction

Ocorre quando uma transação é concluída.

(Herdado de TemplateControl)
DataBinding

Ocorre quando o controle do servidor é associado a uma fonte de dados.

(Herdado de Control)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Error

Ocorre quando uma exceção sem tratamento é gerada.

(Herdado de TemplateControl)
Init

Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida.

(Herdado de Control)
InitComplete

Ocorre quando a inicialização da página é concluída.

Load

Ocorre quando o controle do servidor é carregado no Page objeto.

(Herdado de Control)
LoadComplete

Ocorre no final do estágio de carga do ciclo de vida da página.

PreInit

Ocorre antes da inicialização da página.

PreLoad

Ocorre antes do evento de página Load .

PreRender

Ocorre depois que o Control objeto é carregado, mas antes da renderização.

(Herdado de Control)
PreRenderComplete

Ocorre antes que o conteúdo da página seja renderizado.

SaveStateComplete

Ocorre depois que a página é concluída salvando todas as informações de estado de exibição e de estado de controle para a página e os controles na página.

Unload

Ocorre quando o controle do servidor é descarregado da memória.

(Herdado de Control)

Implantações explícitas de interface

Nome Description
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição deste membro, consulte ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição deste membro, consulte GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição deste membro, consulte SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição deste membro, consulte UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição deste membro, consulte DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição deste membro, consulte HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição deste membro, consulte Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição deste membro, consulte HasExpressions.

(Herdado de Control)
IFilterResolutionService.CompareFilters(String, String)

Retorna um valor que indica se existe uma relação pai/filho entre dois filtros de dispositivo especificados.

(Herdado de TemplateControl)
IFilterResolutionService.EvaluateFilter(String)

Retorna um valor que indica se o filtro especificado é um tipo do objeto de filtro atual.

(Herdado de TemplateControl)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição deste membro, consulte AddParsedSubObject(Object).

(Herdado de Control)

Métodos de Extensão

Nome Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type, Object)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados para o controle especificado.

FindFieldTemplate(Control, String)

Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.

FindMetaTable(Control)

Retorna o objeto metatável para o controle de dados que contém.

GetDefaultValues(INamingContainer)

Obtém a coleção dos valores padrão para o controle de dados especificado.

GetMetaTable(INamingContainer)

Obtém os metadados da tabela para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados da tabela para o controle de dados especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Confira também