HttpUtility.UrlEncode Метод

Определение

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

System.Web

Сборки:

netstandard.dll, 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 по умолчанию. Поэтому использование метода предоставляет те же результаты, что и метод UrlEncodeUrlEncode и указание UTF8 второго параметра.

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

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

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

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