HttpUtility Класс

Ссылка

Определение

Пространство имен:: System.Web

Сборка:: System.Web.HttpUtility.dll

Сборка:: System.Web.dll

Сборки:: System.Web.dll, System.Web.Services.dll

Сборка:: netstandard.dll

Сборка:: System.Web.Services.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет методы для кодирования и декодирования URL-адресов при обработке веб-запросов. Этот класс не наследуется.

public ref class HttpUtility sealed

public sealed class HttpUtility

type HttpUtility = class

Public NotInheritable Class HttpUtility

Наследование: Object
HttpUtility

Примеры

В следующем примере кода демонстрируется использование UrlEncode UrlDecode класса и ParseQueryString методовHttpUtility.

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

Класс HttpUtility используется внутри HttpServerUtility класса, методы и свойства которого предоставляются через встроенный объект ASP.NETServer. Кроме того, HttpUtility класс содержит кодирование и декодирование служебных методов, которые недоступны из Server.

Чтобы кодировать или декодировать значения вне веб-приложения, используйте класс WebUtility.

Конструкторы

HttpUtility()

Инициализирует новый экземпляр класса HttpUtility.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HtmlAttributeEncode(String)	Минимально преобразует строку в строку в формате HTML.
HtmlAttributeEncode(String, TextWriter)	Минимально преобразует строку в строку в кодировке HTML и отправляет кодированную строку в выходной поток TextWriter.
HtmlDecode(String)	Преобразует строку, преобразованную в кодировку HTML для передачи по протоколу HTTP, в декодированную строку.
HtmlDecode(String, TextWriter)	Преобразует строку в формате HTML в декодированную строку и отправляет декодированную строку в выходной поток TextWriter.
HtmlEncode(Object)	Преобразует строковое представление объекта в HTML-кодированную строку и возвращает закодированную строку.
HtmlEncode(String)	Преобразует строку в строку в кодировке HTML.
HtmlEncode(String, TextWriter)	Преобразует строку в строку в кодировке HTML и возвращает выходные данные в виде потока выходных данных TextWriter.
JavaScriptStringEncode(String)	Кодирует строку.
JavaScriptStringEncode(String, Boolean)	Кодирует строку.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ParseQueryString(String)	Преобразует строку запроса в NameValueCollection с использованием кодировки UTF8.
ParseQueryString(String, Encoding)	Преобразует строку запроса в NameValueCollection с использованием указанного Encoding.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
UrlDecode(Byte[], Encoding)	Преобразует массив байтов в кодировке URL в декодированную строку с помощью указанного объекта декодирования.
UrlDecode(Byte[], Int32, Int32, Encoding)	Преобразует массив байтов в URL-кодировке в декодированную строку с помощью указанного объекта кодирования, начиная с указанной позиции в массиве и до указанного числа байтов.
UrlDecode(String)	Преобразует строку, закодированную для передачи в URL-адресе, в декодированную строку.
UrlDecode(String, Encoding)	Преобразует строку в кодировке URL в декодированную строку с помощью указанного объекта кодирования.
UrlDecodeToBytes(Byte[])	Преобразует массив байтов в URL-кодировке в декодированный массив байтов.
UrlDecodeToBytes(Byte[], Int32, Int32)	Преобразует массив байтов в URL-кодировке в декодированный массив байтов, начиная с указанной позиции в массиве и до указанного количества байтов.
UrlDecodeToBytes(String)	Преобразует строку в кодировке URL в декодированный массив байтов.
UrlDecodeToBytes(String, Encoding)	Преобразует строку в кодировке URL в декодированный массив байтов с помощью указанного объекта декодирования.
UrlEncode(Byte[])	Преобразует массив байтов в закодированную строку URL-адреса.
UrlEncode(Byte[], Int32, Int32)	Преобразует массив байтов в строку URL-кодировки, начиная с указанной позиции в массиве и до указанного количества числа байтов.
UrlEncode(String)	Кодирует строку URL-адреса.
UrlEncode(String, Encoding)	Кодирует строку URL-адреса, используя указанный объект кодирования.
UrlEncodeToBytes(Byte[])	Преобразует массив байтов в массив байтов в URL-кодировке.
UrlEncodeToBytes(Byte[], Int32, Int32)	Преобразует массив байтов в массив байтов в URL-кодировке, начиная с указанной позиции в массиве и до указанного количества байтов.
UrlEncodeToBytes(String)	Преобразует строку в кодировке URL в массив байтов.
UrlEncodeToBytes(String, Encoding)	Преобразует строку в массив байтов в кодировке URL-адреса с использованием указанного объекта кодирования.
UrlEncodeUnicode(String)	Является устаревшей. Преобразует строку в строку Юникода.
UrlEncodeUnicodeToBytes(String)	Является устаревшей. Преобразует строку Юникода в массив байтов.
UrlPathEncode(String)	Не использовать; предназначено исключительно для совместимости браузеров. Используйте ключевое слово UrlEncode(String).

Применяется к

HttpUtility Класс

Определение

Примеры

Комментарии

Конструкторы

Методы

Применяется к

См. также раздел

Дополнительные ресурсы