HttpCapabilitiesBase.RequiresLeadingPageBreak Property

Reference

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 virtual property bool RequiresLeadingPageBreak { bool get(); };

public virtual bool RequiresLeadingPageBreak { get; }

member this.RequiresLeadingPageBreak : bool

Public Overridable ReadOnly Property RequiresLeadingPageBreak As Boolean

Property Value

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.

Examples

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

Remarks

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

Applies to

Condividi tramite