HtmlHead Class (System.Web.UI.HtmlControls)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

HtmlHead Class

Provides programmatic access to the HTML head element in server code.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic (Declaration)

<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class HtmlHead _
    Inherits HtmlGenericControl

Visual Basic (Usage)

Dim instance As HtmlHead

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class HtmlHead : HtmlGenericControl

Visual C++

[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class HtmlHead sealed : public HtmlGenericControl

JScript

public final class HtmlHead extends HtmlGenericControl

ASP.NET

<asp:HtmlHead />

Remarks

The HTML head element is a container that can contain additional information about the page. The HtmlHead control is useful for specifying page formatting information that can be accessed at run time.

Note:
Adding styles or style rules programmatically during asynchronous postbacks is not supported. When you add AJAX capabilities to an ASP.NET Web page, asynchronous postbacks update regions of the page without updating the whole page. For more information, see ASP.NET AJAX Overview.

Topic	Location
How to: Add HTML Server Controls to a Web Page Using ASP.NET Syntax	Building ASP .NET Web Applications
How to: Add HTML Server Controls to a Web Page Using ASP.NET Syntax	Building ASP .NET Web Applications
How to: Add HTML Server Controls to a Web Page Using ASP.NET Syntax	Building ASP .NET Web Applications in Visual Studio
How to: Add HTML Server Controls to a Web Page Using ASP.NET Syntax	Building ASP .NET Web Applications in Visual Studio
How to: Set HTML Server Control Properties Programmatically	Building ASP .NET Web Applications
How to: Set HTML Server Control Properties Programmatically	Building ASP .NET Web Applications
How to: Set HTML Server Control Properties Programmatically	Building ASP .NET Web Applications in Visual Studio
How to: Set HTML Server Control Properties Programmatically	Building ASP .NET Web Applications in Visual Studio

Examples

The following example shows how to programmatically access the HtmlHead control to dynamically add title and style elements to the head element of the page.

Visual Basic

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

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

        ' Add the page title to the header element.
        Page.Header.Title = "HtmlHead Example"

    End Sub

</script>

<html  >

<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="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;

      // 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");

      // Add the page title to the header element.
      Page.Header.Title = "HtmlHead Example"; 

  }

</script>

<html  >

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

.NET Framework Security

AspNetHostingPermission
to run the HtmlHead control in a hosted environment. Associated enumeration: Minimal

Inheritance Hierarchy

System..::.Object
  System.Web.UI..::.Control
    System.Web.UI.HtmlControls..::.HtmlControl
      System.Web.UI.HtmlControls..::.HtmlContainerControl
        System.Web.UI.HtmlControls..::.HtmlGenericControl
          System.Web.UI.HtmlControls..::.HtmlHead

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

HtmlHead Members

System.Web.UI.HtmlControls Namespace

Header

HtmlLink

HtmlMeta

Other Resources

HTML Server Controls