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)

'Declaration
Public Overridable ReadOnly Property RequiresLeadingPageBreak As Boolean
'Usage
Dim instance As HttpCapabilitiesBase 
Dim value As Boolean 

value = instance.RequiresLeadingPageBreak

Property Value

Type: System.Boolean
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="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)
        CheckBrowserCaps()
    End Sub 

    Function CheckBrowserCaps()

        Dim labelText As String = "" 
        Dim myBrowserCaps As System.Web.HttpBrowserCapabilities = Request.Browser
        If (CType(myBrowserCaps, System.Web.Configuration.HttpCapabilitiesBase)).RequiresLeadingPageBreak Then
            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." 
        End If

        Label1.Text = labelText

    End Function '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 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.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: