HttpUtility.UrlEncode Метод

Определение

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

System.Web

Сборка:

System.Web.HttpUtility.dll

Кодирует строку URL-адреса. Эти перегрузки метода можно использовать для кодирования всего URL-адреса, включая значения строки запроса.

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

Перегрузки

UrlEncode(Byte[], Int32, Int32)	Преобразует массив байтов в строку URL-кодировки, начиная с указанной позиции в массиве и до указанного количества числа байтов.
UrlEncode(String, Encoding)	Кодирует строку URL-адреса, используя указанный объект кодирования.
UrlEncode(Byte[])	Преобразует массив байтов в закодированную строку URL-адреса.
UrlEncode(String)	Кодирует строку URL-адреса.

UrlEncode(Byte[], Int32, Int32)

Исходный код:

HttpUtility.cs

Преобразует массив байтов в строку URL-кодировки, начиная с указанной позиции в массиве и до указанного количества числа байтов.

public:
 static System::String ^ UrlEncode(cli::array <System::Byte> ^ bytes, int offset, int count);

public static string? UrlEncode (byte[]? bytes, int offset, int count);

static member UrlEncode : byte[] * int * int -> string

Public Shared Function UrlEncode (bytes As Byte(), offset As Integer, count As Integer) As String

Параметры

bytes

Byte[]

Массив байтов, который нужно закодировать.

offset

Int32

Позиция в массиве байтов, с которой начинается кодирование.

count

Int32

Количество байтов, предназначенных для кодирования.

Возвращаемое значение

String

Закодированная строка.

Комментарии

Метод UrlEncode(String) можно использовать для кодирования всего URL-адреса, включая значения строки запроса. Если символы, такие как пробелы и знаки препинания, передаются в потоке HTTP, они могут быть неправильно интерпретированы на принимающем конце. При кодировании URL-адреса символы, недопустимые в URL-адресе, преобразуются в эквиваленты символьных сущностей; Декодирование URL-адресов меняет кодировку. Например, если символы < и > внедряются в блок текста, передаваемый в URL-адресе, они кодируются как %3c и %3e.

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

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

• UrlDecode(String)
• Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам

UrlEncode(String, Encoding)

Исходный код:

HttpUtility.cs

Кодирует строку URL-адреса, используя указанный объект кодирования.

public:
 static System::String ^ UrlEncode(System::String ^ str, System::Text::Encoding ^ e);

public static string? UrlEncode (string? str, System.Text.Encoding e);

static member UrlEncode : string * System.Text.Encoding -> string

Public Shared Function UrlEncode (str As String, e As Encoding) As String

Параметры

str

String

Кодируемый текст.

e

Encoding

ОбъектEncoding, указывающий схему кодирования.

Возвращаемое значение

String

Закодированная строка.

Комментарии

Этот метод можно использовать для кодирования всего URL-адреса, включая значения строки запроса. Если символы, такие как пробелы и знаки препинания, передаются в потоке HTTP, они могут быть неправильно интерпретированы на принимающем конце. При кодировании URL-адреса символы, недопустимые в URL-адресе, преобразуются в эквиваленты символьных сущностей; Декодирование URL-адресов меняет кодировку. Например, если символы < и > внедряются в блок текста, передаваемый в URL-адресе, они кодируются как %3c и %3e.

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

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

• UrlDecode(String)
• Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам

UrlEncode(Byte[])

Исходный код:

HttpUtility.cs

Преобразует массив байтов в закодированную строку URL-адреса.

public:
 static System::String ^ UrlEncode(cli::array <System::Byte> ^ bytes);

public static string? UrlEncode (byte[]? bytes);

static member UrlEncode : byte[] -> string

Public Shared Function UrlEncode (bytes As Byte()) As String

Параметры

bytes

Byte[]

Массив байтов, который нужно закодировать.

Возвращаемое значение

String

Закодированная строка.

Комментарии

Метод UrlEncode можно использовать для кодирования всего URL-адреса, включая значения строки запроса. Если символы, такие как пробелы и знаки препинания, передаются в потоке HTTP, они могут быть неправильно интерпретированы на принимающем конце. При кодировании URL-адреса символы, недопустимые в URL-адресе, преобразуются в эквиваленты символьных сущностей; Декодирование URL-адресов меняет кодировку. Например, если символы < и > внедряются в блок текста, передаваемый в URL-адресе, они кодируются как %3c и %3e.

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

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

• UrlDecode(String)
• Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам

UrlEncode(String)

Исходный код:

HttpUtility.cs

Кодирует строку URL-адреса.

public:
 static System::String ^ UrlEncode(System::String ^ str);

public static string? UrlEncode (string? str);

static member UrlEncode : string -> string

Public Shared Function UrlEncode (str As String) As String

Параметры

str

String

Кодируемый текст.

Возвращаемое значение

String

Закодированная строка.

Комментарии

Метод UrlEncode(String) можно использовать для кодирования всего URL-адреса, включая значения строки запроса. Если символы, такие как пробелы и знаки препинания, передаются в потоке HTTP без кодировки, они могут быть неправильно интерпретированы на принимающем конце. При кодировании URL-адреса символы, недопустимые в URL-адресе, преобразуются в эквиваленты символьных сущностей; Декодирование URL-адресов меняет кодировку. Например, если символы < и > внедряются в блок текста, передаваемый в URL-адресе, они кодируются как %3c и %3e.

URL-адрес можно закодировать с UrlEncode помощью метода или UrlPathEncode метода . Однако методы возвращают разные результаты. Метод UrlEncode преобразует каждый символ пробела в знак плюса (+). Метод UrlPathEncode преобразует каждый символ пробела в строку "%20", представляющую пробел в шестнадцатеричной нотации. UrlPathEncode Используйте метод при кодировании части пути URL-адреса, чтобы гарантировать согласованный декодированный URL-адрес независимо от того, какая платформа или браузер выполняет декодирование.

По HttpUtility.UrlEncode умолчанию метод использует кодировку UTF-8. Таким образом, использование UrlEncode метода дает те же результаты, что и при использовании UrlEncode метода и указан UTF8 второй параметр.

UrlEncode — это удобный способ доступа к методу UrlEncode во время выполнения из приложения ASP.NET. UrlEncode Внутренне использует метод для UrlEncode кодирования строк.

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

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

• UrlDecode(String)
• Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам