This documentation is archived and is not being maintained.

HttpCapabilitiesBase.RequiresLeadingPageBreak Property

Gets a value indicating whether the browser requires the first element in the body of a Web page to be an HTML <br> element.

Namespace: System.Web.Configuration
Assembly: System.Web (in system.web.dll)

public virtual bool RequiresLeadingPageBreak { get; }
/** @property */
public boolean get_RequiresLeadingPageBreak ()

public function get RequiresLeadingPageBreak () : boolean

Not applicable.

Property Value

true if the browser requires the first element in the body of a Web page to be an HTML BR element; otherwise, false. The default is false.

If true, server-control adapters insert an additional <br> element immediately following the <body> tag in a Web page.

The following code example shows how to determine whether the browser requires the first element in the body of a Web page to be an HTML <br> element.

<%@ 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">
    void Page_Load(Object Sender, EventArgs e)
    {
        CheckBrowserCaps();
    }

    void CheckBrowserCaps()
    {
        String labelText = "";
        System.Web.HttpBrowserCapabilities myBrowserCaps = Request.Browser;
        if (((System.Web.Configuration.HttpCapabilitiesBase)myBrowserCaps).RequiresLeadingPageBreak)
        {
            labelText = "Browser requires that the first element in the body of a web page be an HTML BR element.";
        }
        else
        {
            labelText = "Browser does not require that the first element in the body of a web page be an HTML BR element.";
        }

        Label1.Text = labelText;
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Browser Capabilities Sample</title>
</head>
<body>
    <form runat="server" id="form1">
        <div>
            Browser Capabilities:
            <p/><asp:Label ID="Label1" Runat="server" />
        </div>
    </form>
</body>
</html>

<%@ page language="VJ#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">   

void Page_Load(Object sender, EventArgs e)
{
    CheckBrowserCaps();
} //Page_Load

void CheckBrowserCaps()
{
    String labelText = "";
    System.Web.HttpBrowserCapabilities myBrowserCaps = 
        get_Request().get_Browser();
    if (((System.Web.Configuration.HttpCapabilitiesBase)myBrowserCaps).
        get_RequiresLeadingPageBreak()) {
        labelText = "Browser requires that the first element in the body of a"
            +" web page be an HTML BR element.";
    }
    else {
        labelText = "Browser does not require that the first element in the"
            +" body of a web page be an HTML BR element.";
    }
    Label1.set_Text(labelText);
} //CheckBrowserCaps
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Browser Capabilities Sample</title>
</head>
<body>
    <form runat="server" id="form1">
        <div>
            Browser Capabilities:
            <p/><asp:Label ID="Label1" Runat="server" />
        </div>
    </form>
</body>
</html>

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: