MasterPage 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.

Funciona como modelo e contentor de fusão para páginas compostas apenas por Content controlos e respetivos controlos filhos.

public ref class MasterPage : System::Web::UI::UserControl

public class MasterPage : System.Web.UI.UserControl

type MasterPage = class
    inherit UserControl

Public Class MasterPage
Inherits UserControl

Herança: Object

Control

TemplateControl

UserControl
MasterPage

Exemplos

Esta secção contém quatro exemplos de código:

O primeiro exemplo de código demonstra como criar uma página-mestre de forma declarativa.
O segundo exemplo de código representa a página de conteúdo associada à página mestra criada no primeiro exemplo de código.
O terceiro exemplo de código demonstra como adicionar uma propriedade a uma página mestre.
O quarto exemplo de código demonstra como usar uma página de conteúdo para aceder a uma propriedade pública na página mestre.

O exemplo seguinte demonstra como criar uma página mestre de forma declarativa e adicionar algum conteúdo a ela usando uma página de conteúdo. A primeira página Web é a página .master chamada MasterPageSample_1.master.

<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
    </div>
    </form>
</body>
</html>

<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
    </div>
    </form>
</body>
</html>

O exemplo seguinte representa a página de conteúdo associada a MasterPageSample_1.master. Contém um Content controlo e identifica o ContentPlaceHolder controlo ao qual o conteúdo está associado ao utilizar a ContentPlaceHolderID propriedade.

<%@ Page Language="C#" MasterPageFile="~/MasterPageSample_1cs.master" Title="Content Page"%>

<asp:content
    runat="server"
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>

<%@ Page Language="VB" MasterPageFile="~/MasterPageSample_1vb.master" Title="Content Page"%>

<asp:content
    runat="server"
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>

O exemplo seguinte demonstra como adicionar uma propriedade a uma página mestre. O ClassName atributo é usado para nomear a página mestre.

<%@ Master Language="C#" ClassName="MasterExample" %>

<script runat="server">
        public string SiteName
        {
            get { return "My Site Name"; }
        }
</script>

<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
        </asp:contentplaceholder>
    </div>
    </form>
</body>
</html>

<%@ Master Language="VB" ClassName="MasterExample" %>

<script runat="server">
  Public ReadOnly Property SiteName() As String
    Get
      Return "My Site Name"
    End Get
  End Property

</script>

<html >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
        </asp:contentplaceholder>
    </div>
    </form>
</body>
</html>

O exemplo seguinte mostra como usar uma página de conteúdo para aceder à propriedade SiteName pública na página mestre no exemplo de código anterior.

<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>

<script runat="server">
  protected void Page_Load(object sender, EventArgs e)
  {
    MasterExample m = (MasterExample)Page.Master;
    mylabel.Text = m.SiteName;
  }
</script>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
    Hello, Master Pages!
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>

<%@ Page Language="VB" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim m As MasterExample = CType(Page.Master, MasterPage)
    mylabel.Text = m.SiteName
  End Sub
</script>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
    Hello, Master Pages!
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>

Observações

Uma página mestra funciona como um contentor modelo e uma página de fusão para páginas de conteúdo na sua aplicação Web ASP.NET. As páginas-mestra oferecem uma forma conveniente de partilhar estrutura e conteúdo entre um conjunto de páginas de conteúdo. Utiliza-se placeholders de conteúdo para definir as secções da página-mestre a substituir por conteúdo das páginas de conteúdo.

Quando usa uma página mestre e as suas páginas de conteúdo relacionadas, adiciona as etiquetas de documento XHTML necessárias (como html, head e body) apenas à página mestre e deixa de criar os seus outros ficheiros de .aspx (ASP.NET páginas) como páginas Web autónomas. As páginas de conteúdo definem o conteúdo a inserir nos marcadores de lugar na página mestre.

Quando um pedido HTTP é feito para uma página em tempo de execução, a página mestra e as páginas de conteúdo são combinadas numa única classe com o mesmo nome das páginas de conteúdo. A classe compilada e fundida resultante deriva da Page classe.

Uma página-mestre pode conter marcação direta e controlos de servidor, bem como controlos de contentores. Cada elemento que é colocado na página-mestre fora de um ContentPlaceHolder controlo é renderizado em todas as páginas que resultam da fusão da página-mestre com as páginas de conteúdo.

Cada página de conteúdo relacionada com a página mestra deve referenciar a página principal num MasterPageFile atributo da sua diretiva @ Página . As páginas de conteúdo podem conter apenas uma @ Page diretiva e um ou mais Content controlos. Todo o texto da página, marcação e controlos do servidor devem ser colocados dentro Content dos controlos. Identifica-se o ContentPlaceHolder controlo de uma página-mestre à qual este Content controlo está associado definindo a ContentPlaceHolderID propriedade do Content controlo.

Em tempo de execução, o conteúdo dinâmico de cada Content controlo na página solicitada é fundido com a página mestra na localização exata do controlo relacionado ContentPlaceHolder . Qualquer outra marcação e controlos na página mestra não são afetados. Os gestores de eventos podem ser definidos tanto na master class como na página de conteúdo. Para mais informações, consulte Eventos em ASP.NET Páginas Principais e de Conteúdo.

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

A página mestra é disponibilizada à página de conteúdo através da Master propriedade da classe base Page . A Master propriedade devolve a instância da página mestre; no entanto, é tipada como a classe base MasterPage . Para aceder aos controlos, propriedades e funções da página mestre, a Master propriedade pode ser convertida num MasterPage objeto. O nome da classe da página mestre é definido usando o ClassName atributo da diretiva @ Master .

Note

Ficheiros com extensões .master não são servidos para um navegador.

As diretivas válidas numa página-mestre são as mesmas que estão disponíveis num UserControl objeto. Podem incluir os seguintes atributos:

AutoEventWireup
ClassName
CodeFile
CompilerMode
CompilerOptions
Debug
Description
EnableTheming
EnableViewState
Explicit
Inherits
Language
LinePragmas
MasterPageFile
Src
Strict
WarningLevel

As diretivas da página mestra não sobrepõem-se às diretivas das páginas de conteúdo individuais.

As páginas-mestre são geralmente criadas de forma declarativa. Se quiseres criar uma página mestre programaticamente, deriva diretamente da MasterPage classe. Para além de estender a MasterPage classe, deve criar o ficheiro .master para mostrar visualmente a interface do utilizador (UI) associada às classes que invocou no seu ficheiro fonte.

Note

Quando cria uma página mestre criando primeiro a sua própria classe, deve incluir todos os namespaces exigidos para as classes que a página utiliza.

Para mais informações sobre páginas-mestre, consulte ASP.NET Páginas Mestres.

Construtores

Name	Description
MasterPage()	Cria uma nova instância da MasterPage classe.

Propriedades

Name	Description
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
Application	Obtém o Application objeto para o pedido Web atual. (Herdado de UserControl)
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)
Attributes	Obtém uma coleção de todos os pares de nomes e valores de atributos declarados na tag de controlo do utilizador dentro do ficheiro .aspx. (Herdado de UserControl)
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)
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
Cache	Obtém o Cache objeto associado à aplicação que contém o controlo do utilizador. (Herdado de UserControl)
CachePolicy	Obtém uma referência a uma coleção de parâmetros de cache para este controlo do utilizador. (Herdado de UserControl)
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)
ContentPlaceHolders	Obtém uma lista de ContentPlaceHolder controlos que a página mestre usa para definir diferentes regiões de conteúdo.
ContentTemplates	Obtém uma lista de controlos de conteúdo associados à página mestre.
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface. (Herdado de Control)
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)
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 o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
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)
ID	Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control)
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsPostBack	Recebe um valor que indica se o controlo do utilizador está a ser carregado em resposta a um postback do cliente, ou se está a ser carregado e acedido pela primeira vez. (Herdado de UserControl)
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
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)
Master	Obtém a página principal principal do mestre atual em cenários de páginas mestres aninhadas.
MasterPageFile	Obtém ou define o nome da página-mestre que contém o conteúdo atual.
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)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
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 o pedido Web atual. (Herdado de UserControl)
Response	Obtém o HttpResponse objeto para o pedido Web atual. (Herdado de UserControl)
Server	Obtém o HttpServerUtility objeto para o pedido Web atual. (Herdado de UserControl)
Session	Obtém o HttpSessionState objeto para o pedido Web atual. (Herdado de UserControl)
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)
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)
Trace	Obtém o TraceContext objeto para o pedido Web atual. (Herdado de UserControl)
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
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)
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)
Visible	Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control)

Métodos

Name	Description
AddContentTemplate(String, ITemplate)	Adiciona um Content controlo ao ContentTemplates dicionário.
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
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)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
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)
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 quaisquer passos de inicialização no controlo do utilizador que sejam exigidos pelos projetistas RAD. (Herdado de UserControl)
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)
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 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 o controlo derivado da TemplateControl classe. (Herdado de TemplateControl)
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 ResourceKey especificadosClassKey. (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)
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)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
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)
InitializeAsUserControl(Page)	Inicializa o UserControl objeto que foi criado de forma declarativa. Como existem algumas diferenças entre páginas e controlos de utilizador, este método garante que o controlo de utilizador está corretamente inicializado. (Herdado de UserControl)
InstantiateInContentPlaceHolder(Control, ITemplate)	Fornece um método para definir o controlo atual do modelo para uma página que detém a página-mestre.
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
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)
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 de controlo de utilizador anterior que foi guardado pelo SaveViewState() método. (Herdado de UserControl)
MapPath(String)	Atribui um caminho virtual de ficheiro, seja absoluto ou relativo, a um caminho físico. (Herdado de UserControl)
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)	Eleva o Init evento. (Herdado de UserControl)
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Eleva o PreRender evento. (Herdado de Control)
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)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
ReadStringResource()	Lê um recurso de cadeia. O ReadStringResource() método não é destinado a ser usado dentro do seu código. (Herdado de TemplateControl)
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
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)
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)
SaveViewState()	Guarda quaisquer alterações no estado de visualização do controlo do utilizador que tenham ocorrido desde a última publicação da página. (Herdado de UserControl)
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
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)	Tenta atualizar a instância do modelo usando valores do fornecedor de valor. (Herdado de UserControl)
TryUpdateModel<TModel>(TModel)	Tenta atualizar a instância do modelo usando os valores do controlo data-bound. (Herdado de UserControl)
UpdateModel<TModel>(TModel, IValueProvider)	Atualiza a instância do modelo especificada usando valores do fornecedor de valor do controlo do utilizador. (Herdado de UserControl)
UpdateModel<TModel>(TModel)	Atualiza a instância do modelo usando valores do controlo data-bound. (Herdado de UserControl)
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)
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)

Implementações de Interface Explícita

Name	Description
IAttributeAccessor.GetAttribute(String)	Devolve o valor do atributo de controlo do utilizador especificado. (Herdado de UserControl)
IAttributeAccessor.SetAttribute(String, String)	Define o valor do atributo de controlo do utilizador especificado. (Herdado de UserControl)
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)
IUserControlDesignerAccessor.InnerText	Obtém ou define o texto que aparece entre as etiquetas de abertura e fecho de um controlo de utilizador. (Herdado de UserControl)
IUserControlDesignerAccessor.TagName	Obtém ou define o nome completo da tag do controlo do utilizador. (Herdado de UserControl)

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?