HttpUtility Clase

Definición

Espacio de nombres:: System.Web

Ensamblado:: System.Web.dll

Ensamblados:: System.Web.dll, System.Web.Services.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona métodos para codificar y descodificar direcciones URL al procesar solicitudes web. Esta clase no puede heredarse.

public ref class HttpUtility sealed

public sealed class HttpUtility

type HttpUtility = class

Public NotInheritable Class HttpUtility

Herencia: Object
HttpUtility

Ejemplos

En el ejemplo de código siguiente se muestra el uso de los UrlEncodemétodos , UrlDecode y ParseQueryString de la HttpUtility clase .

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

Comentarios

La clase HttpUtility se usa internamente mediante la clase HttpServerUtility, cuyos métodos y propiedades se exponen a través del objeto intrínseco ASP.NET Server. Además, la HttpUtility clase contiene métodos de utilidad de codificación y descodificación que no son accesibles desde Server.

Para codificar o descodificar valores fuera de una aplicación web, use la WebUtility clase .

Constructores

Nombre	Description
HttpUtility()	Inicializa una nueva instancia de la clase HttpUtility.

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HtmlAttributeEncode(String, TextWriter)	Convierte mínimamente una cadena en una cadena codificada en HTML y envía la cadena codificada a un TextWriter flujo de salida.
HtmlAttributeEncode(String)	Convierte mínimamente una cadena en una cadena codificada en HTML.
HtmlDecode(String, TextWriter)	Convierte una cadena codificada en HTML en una cadena descodificada y envía la cadena descodificada a un TextWriter flujo de salida.
HtmlDecode(String)	Convierte una cadena codificada en HTML para la transmisión HTTP en una cadena descodificada.
HtmlEncode(Object)	Convierte la representación de cadena de un objeto en una cadena codificada en HTML y devuelve la cadena codificada.
HtmlEncode(String, TextWriter)	Convierte una cadena en una cadena codificada en HTML y devuelve la salida como un TextWriter flujo de salida.
HtmlEncode(String)	Convierte una cadena en una cadena codificada en HTML.
JavaScriptStringEncode(String, Boolean)	Codifica una cadena.
JavaScriptStringEncode(String)	Codifica una cadena.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ParseQueryString(String, Encoding)	Analiza una cadena de consulta en mediante NameValueCollection el especificado Encoding.
ParseQueryString(String)	Analiza una cadena de consulta en un NameValueCollection mediante UTF8 la codificación .
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
UrlDecode(Byte[], Encoding)	Convierte una matriz de bytes con codificación URL en una cadena descodificada mediante el objeto de descodificación especificado.
UrlDecode(Byte[], Int32, Int32, Encoding)	Convierte una matriz de bytes con codificación URL en una cadena descodificada mediante el objeto de codificación especificado, comenzando en la posición especificada de la matriz y continuando para el número de bytes especificado.
UrlDecode(String, Encoding)	Convierte una cadena con codificación URL en una cadena descodificada mediante el objeto de codificación especificado.
UrlDecode(String)	Convierte una cadena que se ha codificado para la transmisión en una dirección URL en una cadena descodificada.
UrlDecodeToBytes(Byte[], Int32, Int32)	Convierte una matriz con codificación URL de bytes en una matriz de bytes descodificada, empezando por la posición especificada en la matriz y continuando para el número especificado de bytes.
UrlDecodeToBytes(Byte[])	Convierte una matriz con codificación URL de bytes en una matriz de bytes descodificada de bytes.
UrlDecodeToBytes(String, Encoding)	Convierte una cadena con codificación URL en una matriz de bytes descodificada mediante el objeto de descodificación especificado.
UrlDecodeToBytes(String)	Convierte una cadena con codificación URL en una matriz de bytes descodificada.
UrlEncode(Byte[], Int32, Int32)	Convierte una matriz de bytes en una cadena con codificación URL, empezando por la posición especificada en la matriz y continuando para el número especificado de bytes.
UrlEncode(Byte[])	Convierte una matriz de bytes en una cadena de dirección URL codificada.
UrlEncode(String, Encoding)	Codifica una cadena de dirección URL mediante el objeto de codificación especificado.
UrlEncode(String)	Codifica una cadena de dirección URL.
UrlEncodeToBytes(Byte[], Int32, Int32)	Convierte una matriz de bytes en una matriz con codificación URL de bytes, empezando por la posición especificada en la matriz y continuando para el número especificado de bytes.
UrlEncodeToBytes(Byte[])	Convierte una matriz de bytes en una matriz con codificación URL de bytes.
UrlEncodeToBytes(String, Encoding)	Convierte una cadena en una matriz con codificación URL de bytes mediante el objeto de codificación especificado.
UrlEncodeToBytes(String)	Convierte una cadena en una matriz con codificación URL de bytes.
UrlEncodeUnicode(String)	Obsoletos. Convierte una cadena en una cadena Unicode.
UrlEncodeUnicodeToBytes(String)	Obsoletos. Convierte una cadena Unicode en una matriz de bytes.
UrlPathEncode(String)	No use; diseñado solo para la compatibilidad del explorador. Utilice UrlEncode(String).

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?