Export (0) Print
Expand All
Expand Minimize

HttpCapabilitiesBase.RequiresSpecialViewStateEncoding Property

Gets a value indicating whether the browser requires VIEWSTATE values to be specially encoded.

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

public virtual bool RequiresSpecialViewStateEncoding { get; }
/** @property */
public boolean get_RequiresSpecialViewStateEncoding ()

public function get RequiresSpecialViewStateEncoding () : boolean

Not applicable.

Property Value

true if the browser requires VIEWSTATE values to be specially encoded; otherwise, false. The default is false.

HTTP is a stateless protocol, and VIEWSTATE is one mechanism used to persist client changes across multiple requests. Each control on a Web page contains a ViewState property, which represents the accumulation of any changes made by the client. In a Web Forms page, these changes are encoded in postback data as the value of an HTML <input> element with a type attribute of hidden. For example:

<input type="hidden" name="__VIEWSTATE" value="t0PH_u56?cDxleHQ7P=" />

If true, non-alphabetic characters in the VIEWSTATE value will not be sent correctly by the browser, nor by an intermediate gateway. To correct this, server-control adapters replace non-alphabetic characters in the VIEWSTATE value with ones that do not require encoding in HTTP requests.

The following code example shows how to determine whether the browser requires VIEWSTATE values to be specially encoded.

<%@ 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).RequiresSpecialViewStateEncoding)
        {
            labelText = "Browser requires view state values to be specially encoded.";
        }
        else
        {
            labelText = "Browser does not require view state values to be specially encoded.";
        }

        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_RequiresSpecialViewStateEncoding()) {
        labelText = 
            "Browser requires view state values to be specially encoded.";
    }
    else {
        labelText = "Browser does not require view state values to be"
            +" specially encoded.";
    }
    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

Community Additions

ADD
Show:
© 2015 Microsoft