HttpCapabilitiesBase.RequiresSpecialViewStateEncoding Propriedade

Referência

Definição

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém um valor que indica se o navegador requer que os valores de VIEWSTATE tenham codificação especial.

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

public virtual bool RequiresSpecialViewStateEncoding { get; }

member this.RequiresSpecialViewStateEncoding : bool

Public Overridable ReadOnly Property RequiresSpecialViewStateEncoding As Boolean

Valor da propriedade

Boolean

true se o navegador exigir VIEWSTATE que os valores sejam especialmente codificados; caso contrário, false. O padrão é false.

Exemplos

O exemplo de código a seguir mostra como determinar se o navegador exige VIEWSTATE que os valores sejam codificados especialmente.

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

Comentários

HTTP é um protocolo sem estado e VIEWSTATE é um mecanismo usado para persistir as alterações do cliente em várias solicitações. Cada controle em uma página da Web contém uma ViewState propriedade, que representa o acúmulo de quaisquer alterações feitas pelo cliente. Em uma página de Web Forms, essas alterações são codificadas em dados de postback como um value elemento HTML <input> com um type atributo de hidden. Por exemplo:

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

Se true, caracteres não alfabéticos no VIEWSTATE valor não serão enviados corretamente pelo navegador, nem por um gateway intermediário. Para corrigir isso, os adaptadores de controle de servidor substituem caracteres não alfabéticos no VIEWSTATE valor por outros que não exigem codificação em solicitações HTTP.

Aplica-se a

Share via