HttpUtility Clase

Referencia

Definición

Espacio de nombres:: System.Web

Ensamblado:: System.Web.HttpUtility.dll

Ensamblado:: System.Web.dll

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

Ensamblado:: netstandard.dll

Source:: HttpUtility.cs

Source:: HttpUtility.cs

Source:: HttpUtility.cs

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 las 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 .

ASP.NET (C#)

<%@ 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 HttpUtility clase se usa internamente por la HttpServerUtility clase , cuyos métodos y propiedades se exponen a través del objeto ASP.NET Server intrínseco. 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 clase WebUtility.

Constructores

HttpUtility()

Inicializa una nueva instancia de la clase HttpUtility.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HtmlAttributeEncode(String)	Convierte mínimamente una cadena en una cadena codificada en HTML.
HtmlAttributeEncode(String, TextWriter)	Como mínimo, convierte una cadena en una cadena codificada en HTML y envía la cadena codificada a un flujo de salida TextWriter.
HtmlDecode(String)	Convierte una cadena que se ha codificado en HTML para su transmisión HTTP en una cadena descodificada.
HtmlDecode(String, TextWriter)	Convierte una cadena que se ha codificado en HTML en una cadena descodificada y envía la cadena descodificada a una secuencia de salida de TextWriter.
HtmlEncode(Object)	Convierte la representación de cadena de un objeto en una cadena codificada en HTML y devuelve la cadena codificada.
HtmlEncode(String)	Convierte una cadena en una cadena codificada en HTML.
HtmlEncode(String, TextWriter)	Convierte una cadena en una cadena con codificación HTML y devuelve el resultado como una secuencia TextWriter de salida.
JavaScriptStringEncode(String)	Codifica una cadena.
JavaScriptStringEncode(String, Boolean)	Codifica una cadena.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ParseQueryString(String)	Analiza una cadena de consulta en un elemento NameValueCollection mediante codificación UTF8.
ParseQueryString(String, Encoding)	Analiza una cadena de consulta en una NameValueCollection usando el Encoding especificado.
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, empezando en la posición especificada de la matriz y continuando hasta el número especificado de bytes.
UrlDecode(String)	Convierte una cadena que se ha codificado para su transmisión en una dirección URL en una cadena descodificada.
UrlDecode(String, Encoding)	Convierte una cadena con codificación URL en una cadena descodificada, utilizando el objeto de codificación especificado.
UrlDecodeToBytes(Byte[])	Convierte una matriz de bytes con codificación URL en una matriz de bytes descodificada.
UrlDecodeToBytes(Byte[], Int32, Int32)	Convierte una matriz de bytes con codificación URL en una matriz de bytes descodificada, empezando en la posición especificada en la matriz y continuando hasta el número especificado de bytes.
UrlDecodeToBytes(String)	Convierte una cadena con codificación URL en una matriz decodificada 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.
UrlEncode(Byte[])	Convierte una matriz de bytes en una cadena de dirección URL codificada.
UrlEncode(Byte[], Int32, Int32)	Convierte una matriz de bytes en una cadena con codificación URL, empezando en la posición especificada en la matriz y continuando hasta el número especificado de bytes.
UrlEncode(String)	Codifica una cadena URL.
UrlEncode(String, Encoding)	Codifica una cadena de dirección URL mediante el objeto de codificación especificado.
UrlEncodeToBytes(Byte[])	Convierte una matriz de bytes en una matriz con codificación URL de bytes.
UrlEncodeToBytes(Byte[], Int32, Int32)	Convierte una matriz de bytes en una matriz de bytes con codificación URL, empezando en la posición especificada en la matriz y continuando hasta el número especificado de bytes.
UrlEncodeToBytes(String)	Convierte una cadena en una matriz con codificación URL de bytes.
UrlEncodeToBytes(String, Encoding)	Convierte una cadena en una matriz de bytes con codificación URL mediante el objeto de codificación especificado.
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 usar; diseñado solo para la compatibilidad con el explorador. Use UrlEncode(String).

Se aplica a

Producto	Versiones
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Compartir a través de