HtmlHead Classe

Definição

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece acesso programático ao elemento HTML head no código do servidor.

public ref class HtmlHead sealed : System::Web::UI::HtmlControls::HtmlGenericControl

public sealed class HtmlHead : System.Web.UI.HtmlControls.HtmlGenericControl

type HtmlHead = class
    inherit HtmlGenericControl

Public NotInheritable Class HtmlHead
Inherits HtmlGenericControl

Herança: Object

Control

HtmlControl

HtmlContainerControl

HtmlGenericControl
HtmlHead

Exemplos

O exemplo a seguir mostra como acessar programaticamente o HtmlHead controle para adicionar dinamicamente title e style elementos ao head elemento da página.

<%@ 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, System.EventArgs e)
  {
      
      // Create a Style object for the body of the page.
      Style bodyStyle = new Style();

      bodyStyle.ForeColor = System.Drawing.Color.Blue;
      bodyStyle.BackColor = System.Drawing.Color.LightGray;

      // <Snippet2>
      // Add the style rule named bodyStyle to the header 
      // of the current page. The rule is for the body HTML element.
      Page.Header.StyleSheet.CreateStyleRule(bodyStyle, null, "body");
      // </Snippet2>
 
      // Add the page title to the header element.
      Page.Header.Title = "HtmlHead Example"; 
                   
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head id="head1"
      runat="server">
      <title>To be replaced.</title>
</head>

<body>
  <form id="form1" runat="server">
  
  <h3>HtmlHead Class Example</h3>  
    
  <asp:label id="Label1" 
    text = "View the HTML source code of this page to see the title 
            and body style added to the header element."
    runat="server">
  </asp:label>   
    
  </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">
    
    Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        
        ' Create a Style object for the body of the page.
        Dim bodyStyle As New Style()
        
        bodyStyle.ForeColor = System.Drawing.Color.Blue
        bodyStyle.BackColor = System.Drawing.Color.LightGray

        ' <Snippet2>
        ' Add the style rule named bodyStyle to the header 
        ' of the current page. The rule is for the body HTML element.
        Page.Header.StyleSheet.CreateStyleRule(bodyStyle, Nothing, "body")
        ' </Snippet2>
            
        ' Add the page title to the header element.
        Page.Header.Title = "HtmlHead Example"

    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head id="head1"
      runat="server">
      <title>To be replaced.</title>
</head>

<body>
  <form id="Form1" runat="server">
  
  <h3>HtmlHead Class Example </h3>  
    
  <asp:label id="Label1" 
    text = "View the HTML source code of this page to see the title 
            and body style added to the header element."
    runat="server">
  </asp:label>   
    
  </form>
</body>
</html>

Comentários

O elemento HTML head é um contêiner que pode conter informações adicionais sobre a página. O HtmlHead controle é útil para especificar informações de formatação de página que podem ser acessadas em tempo de execução.

Note

Não há suporte para adicionar estilos ou regras de estilo programaticamente durante postbacks assíncronos. Quando você adiciona recursos do AJAX a uma página da Web ASP.NET, postbacks assíncronos atualizam regiões da página sem atualizar a página inteira. Para obter mais informações, consulte a Visão geral do Microsoft Ajax.

Construtores

Nome	Description
HtmlHead()	Inicializa uma nova instância da classe HtmlHead.
HtmlHead(String)	Inicializa uma nova instância da HtmlHead classe usando a marca especificada.

Propriedades

Nome	Description
Adapter	Obtém o adaptador específico do navegador para o controle. (Herdado de Control)
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)
Attributes	Obtém uma coleção de todos os pares de nome de atributo e valor expressos em uma marca de controle do servidor dentro da página ASP.NET. (Herdado de HtmlControl)
BindingContainer	Obtém o controle que contém a associação de dados desse controle. (Herdado de Control)
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)
Context	Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control)
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)
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)
Description	Obtém o conteúdo do elemento "description `meta` ".
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
Disabled	Obtém ou define um valor que indica se o controle do servidor HTML está desabilitado. (Herdado de HtmlControl)
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de Control)
EnableViewState	Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
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)
ID	Obtém ou define o identificador programático atribuído ao controle do servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
InnerHtml	Obtém ou define o conteúdo encontrado entre as marcas de abertura e fechamento do controle de servidor HTML especificado. (Herdado de HtmlContainerControl)
InnerText	Obtém ou define o texto entre as marcas de abertura e fechamento do controle de servidor HTML especificado. (Herdado de HtmlContainerControl)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control)
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)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
Keywords	Obtém o conteúdo do elemento "palavras-chave `meta` ".
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)
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)
Parent	Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control)
RenderingCompatibility	Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
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)
Style	Obtém uma coleção de todas as propriedades CSS (folha de estilos) em cascata aplicadas a um controle de servidor HTML especificado no arquivo ASP.NET. (Herdado de HtmlControl)
StyleSheet	Obtém uma IStyleSheet instância que representa as regras de estilo no HtmlHead controle.
TagName	Obtém ou define o nome do elemento HTML representado pelo HtmlGenericControl controle. (Herdado de HtmlGenericControl)
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)
Title	Obtém o título da página.
UniqueID	Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos. (Herdado de Control)
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)
ViewStateIgnoresCase	Obtém um valor que indica se o estado de exibição HtmlControl diferencia maiúsculas de minúsculas. (Herdado de HtmlControl)
ViewStateMode	Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página. (Herdado de Control)

Métodos

Nome	Description
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control)
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)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de Control)
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)
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 HtmlContainerControl)
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)
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)
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 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)
GetAttribute(String)	Obtém o valor do atributo nomeado no HtmlControl controle. (Herdado de HtmlControl)
GetDesignModeState()	Obtém dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
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)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da UniqueID propriedade do controle especificado. (Herdado de Control)
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)
IsLiteralContent()	Determina se o controle do servidor contém apenas conteúdo literal. (Herdado de Control)
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)
LoadViewState(Object)	Restaura o HtmlContainerControl estado de exibição do controle de uma solicitação de página anterior que foi salva pelo SaveViewState() método. (Herdado de HtmlContainerControl)
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)
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)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnInit(EventArgs)	Aciona o evento Init. (Herdado de Control)
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de Control)
OnPreRender(EventArgs)	Aciona o evento PreRender. (Herdado de Control)
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control)
RemovedControl(Control)	Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o HtmlContainerControl controle para o objeto especificado HtmlTextWriter . (Herdado de HtmlContainerControl)
RenderAttributes(HtmlTextWriter)	Renderiza os HtmlContainerControl atributos do controle para o objeto especificado HtmlTextWriter . (Herdado de HtmlContainerControl)
RenderBeginTag(HtmlTextWriter)	Renderiza a marca HTML de abertura do controle no objeto especificado HtmlTextWriter . (Herdado de HtmlControl)
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)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento do HtmlContainerControl controle para o objeto especificado HtmlTextWriter . (Herdado de HtmlContainerControl)
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)
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)
SetAttribute(String, String)	Define o valor do atributo nomeado no HtmlControl controle. (Herdado de HtmlControl)
SetDesignModeState(IDictionary)	Define dados de tempo de design para um controle. (Herdado de Control)
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)
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)
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)

Eventos

Nome	Description
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)
Init	Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

Nome	Description
IAttributeAccessor.GetAttribute(String)	Para obter uma descrição deste membro, consulte GetAttribute(String). (Herdado de HtmlControl)
IAttributeAccessor.SetAttribute(String, String)	Para obter uma descrição deste membro, consulte SetAttribute(String, String). (Herdado de HtmlControl)
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)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control)

Métodos de Extensão

Nome	Description
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.

Aplica-se a

Confira também

Comentários

Esta página foi útil?