HttpUtility Clase
Definición
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
-
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 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). |