HttpUtility Classe

Definição

Namespace:
System.Web
Assembly:
System.Web.dll
Assemblies:
System.Web.dll, System.Web.Services.dll
Assembly:
netstandard.dll

Fornece métodos para codificar e decodificar URLs ao processar solicitações da Web. Essa classe não pode ser herdada.

public ref class HttpUtility sealed
public sealed class HttpUtility
type HttpUtility = class
Public NotInheritable Class HttpUtility
Herança
Object
HttpUtility

Exemplos

O exemplo de código a seguir demonstra o uso dos métodos e ParseQueryString métodos UrlEncodeUrlDecode da HttpUtility classe.

<%@ 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">

    protected void Page_Load(object sender, EventArgs e)
    {
        String currurl = HttpContext.Current.Request.RawUrl;
        String querystring = null;

        // Check to make sure some query string variables
        // exist and if not add some and redirect.
        int iqs = currurl.IndexOf('?');
        if (iqs == -1)
        {
            String redirecturl = currurl + "?var1=1&var2=2+2%2f3&var1=3";
            Response.Redirect(redirecturl, true);
        }
        // If query string variables exist, put them in
        // a string.
        else if (iqs >= 0)
        {
            querystring = (iqs < currurl.Length - 1) ? currurl.Substring(iqs + 1) : String.Empty;
        }

        // Parse the query string variables into a NameValueCollection.
        NameValueCollection qscoll = HttpUtility.ParseQueryString(querystring);

        // Iterate through the collection.
        StringBuilder sb = new StringBuilder();
        foreach (String s in qscoll.AllKeys)
        {
            sb.Append(s + " - " + qscoll[s] + "<br />");
        }

        // Write the results to the appropriate labels.
        ParseOutput.Text = sb.ToString();
        UrlRawOutput.Text = currurl;
        UrlEncodedOutput.Text = HttpUtility.UrlEncode(currurl);
        UrlDecodedOutput.Text = HttpUtility.UrlDecode(currurl);
    }
</script>


<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      The raw url is: <br />
      <asp:Label  id="UrlRawOutput"
                  runat="server" />
      <br /><br />
      The url encoded is: <br />
      <asp:Label  id="UrlEncodedOutput"
                  runat="server" />
      <br /><br />
      The url decoded is: <br />
      <asp:Label  id="UrlDecodedOutput"
                  runat="server" />
      <br /><br />
      The query string NameValueCollection is: <br />
      <asp:Label  id="ParseOutput"
                  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">
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

        Dim currurl As String = HttpContext.Current.Request.RawUrl
        Dim querystring As String = Nothing
    
        ' Check to make sure some query string variables
        ' exist and if not add some and redirect.
        Dim iqs As Int32 = currurl.IndexOf("?".ToCharArray())
        If (iqs = -1) Then
      
            Dim redirecturl As String = currurl & "?var1=1&var2=2+2%2f3&var1=3"
            Response.Redirect(redirecturl, True)
      
            ' If query string variables exist, put them in
            ' a string.
        ElseIf (iqs >= 0) Then
      
            If (iqs < currurl.Length - 1) Then
                querystring = currurl.Substring(iqs + 1)
            End If
          
        End If

        ' Parse the query string variables into a NameValueCollection.
        Dim qscoll As NameValueCollection = HttpUtility.ParseQueryString(querystring)
    
        ' Iterate through the collection.
        Dim sb As New StringBuilder()
        For Each s As String In qscoll.AllKeys
      
            sb.Append(s & " - " & qscoll(s) & "<br />")
    
        Next s
    
        ' Write the results to the appropriate labels.
        ParseOutput.Text = sb.ToString()
        UrlRawOutput.Text = currurl
        UrlEncodedOutput.Text = HttpUtility.UrlEncode(currurl)
        UrlDecodedOutput.Text = HttpUtility.UrlDecode(currurl)
   
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      The raw url is: <br />
      <asp:Label  id="UrlRawOutput"
                  runat="server" />
      <br /><br />
      The url encoded is: <br />
      <asp:Label  id="UrlEncodedOutput"
                  runat="server" />
      <br /><br />
      The url decoded is: <br />
      <asp:Label  id="UrlDecodedOutput"
                  runat="server" />
      <br /><br />
      The query string NameValueCollection is: <br />
      <asp:Label  id="ParseOutput"
                  runat="server" />    
    </div>
    </form>
</body>
</html>

Comentários

A classe HttpUtility é usada internamente pela classe HttpServerUtility, cujos métodos e propriedades são expostos por meio do objeto ASP.NET Server intrínseco. Além disso, a HttpUtility classe contém métodos utilitários de codificação e decodificação que não são acessíveis da Server.

Para codificar ou decodificar valores fora de um aplicativo Web, use a WebUtility classe.

Construtores

Nome Description
HttpUtility()

Inicializa uma nova instância da classe HttpUtility.

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HtmlAttributeEncode(String, TextWriter)

Converte minimamente uma cadeia de caracteres em uma cadeia de caracteres codificada em HTML e envia a cadeia de caracteres codificada para um TextWriter fluxo de saída.
HtmlAttributeEncode(String)

Converte minimamente uma cadeia de caracteres em uma cadeia de caracteres codificada em HTML.
HtmlDecode(String, TextWriter)

Converte uma cadeia de caracteres que foi codificada em HTML em uma cadeia de caracteres decodificada e envia a cadeia de caracteres decodificada para um TextWriter fluxo de saída.
HtmlDecode(String)

Converte uma cadeia de caracteres que foi codificada em HTML para transmissão HTTP em uma cadeia de caracteres decodificada.
HtmlEncode(Object)

Converte a representação de cadeia de caracteres de um objeto em uma cadeia de caracteres codificada em HTML e retorna a cadeia de caracteres codificada.
HtmlEncode(String, TextWriter)

Converte uma cadeia de caracteres em uma cadeia de caracteres codificada em HTML e retorna a saída como um TextWriter fluxo de saída.
HtmlEncode(String)

Converte uma cadeia de caracteres em uma cadeia de códigos HTML.
JavaScriptStringEncode(String, Boolean)

Codifica uma cadeia de caracteres.
JavaScriptStringEncode(String)

Codifica uma cadeia de caracteres.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ParseQueryString(String, Encoding)

Analisa uma cadeia de caracteres de consulta em um NameValueCollection usando o .Encoding
ParseQueryString(String)

Analisa uma cadeia de caracteres de consulta em uma NameValueCollection codificação usando UTF8 .
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
UrlDecode(Byte[], Encoding)

Converte uma matriz de bytes codificada em URL em uma cadeia de caracteres decodificada usando o objeto de decodificação especificado.
UrlDecode(Byte[], Int32, Int32, Encoding)

Converte uma matriz de bytes codificada em URL em uma cadeia de caracteres decodificada usando o objeto de codificação especificado, começando na posição especificada na matriz e continuando para o número especificado de bytes.
UrlDecode(String, Encoding)

Converte uma cadeia de caracteres codificada em URL em uma cadeia de caracteres decodificada usando o objeto de codificação especificado.
UrlDecode(String)

Converte uma cadeia de caracteres que foi codificada para transmissão em uma URL em uma cadeia de caracteres decodificada.
UrlDecodeToBytes(Byte[], Int32, Int32)

Converte uma matriz de bytes codificada em URL em uma matriz de bytes decodificada, começando na posição especificada na matriz e continuando para o número especificado de bytes.
UrlDecodeToBytes(Byte[])

Converte uma matriz de bytes codificada em URL em uma matriz de bytes decodificada.
UrlDecodeToBytes(String, Encoding)

Converte uma cadeia de caracteres codificada em URL em uma matriz de bytes decodificada usando o objeto de decodificação especificado.
UrlDecodeToBytes(String)

Converte uma cadeia de caracteres codificada em URL em uma matriz de bytes decodificada.
UrlEncode(Byte[], Int32, Int32)

Converte uma matriz de bytes em uma cadeia de caracteres codificada em URL, começando na posição especificada na matriz e continuando para o número especificado de bytes.
UrlEncode(Byte[])

Converte uma matriz de bytes em uma cadeia de caracteres de URL codificada.
UrlEncode(String, Encoding)

Codifica uma cadeia de caracteres de URL usando o objeto de codificação especificado.
UrlEncode(String)

Codifica uma cadeia de caracteres de URL.
UrlEncodeToBytes(Byte[], Int32, Int32)

Converte uma matriz de bytes em uma matriz de bytes codificada em URL, começando na posição especificada na matriz e continuando para o número especificado de bytes.
UrlEncodeToBytes(Byte[])

Converte uma matriz de bytes em uma matriz de bytes codificada em URL.
UrlEncodeToBytes(String, Encoding)

Converte uma cadeia de caracteres em uma matriz de bytes codificada em URL usando o objeto de codificação especificado.
UrlEncodeToBytes(String)

Converte uma cadeia de caracteres em uma matriz de bytes codificada em URL.
UrlEncodeUnicode(String)
Obsoleto.

Converte uma cadeia de caracteres em uma cadeia de caracteres Unicode.
UrlEncodeUnicodeToBytes(String)
Obsoleto.

Converte uma cadeia de caracteres Unicode em uma matriz de bytes.
UrlPathEncode(String)

Não use; destinado apenas à compatibilidade do navegador. Use UrlEncode(String).

Aplica-se a

Confira também