Uri.EscapeDataString(String) Метод

Ссылка

Определение

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

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

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

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

Преобразует строку в ее escape-представление.

public:
 static System::String ^ EscapeDataString(System::String ^ stringToEscape);

public static string EscapeDataString (string stringToEscape);

static member EscapeDataString : string -> string

Public Shared Function EscapeDataString (stringToEscape As String) As String

Параметры

stringToEscape: String

Строка, которую нужно преобразовать в escape-представление.

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

String

Экранированное представление stringToEscape.

Исключения

ArgumentNullException

stringToEscape имеет значение null.

UriFormatException

Примечание. В .NET для приложений Магазина Windows или в переносимой библиотеке классов перехватите исключение базового класса FormatException.

Длина stringToEscape превышает 32 766 символов.

По умолчанию метод преобразует все символы, EscapeDataString кроме rfC 2396 без резервирования, в шестнадцатеричное представление. Если включен анализ международных идентификаторов ресурсов (IRIs) или международного доменного имени (IDN), EscapeDataString метод преобразует все символы, кроме незарезервированных символов RFC 3986, в шестнадцатеричное представление. Все символы Юникода преобразуются в формат UTF-8 перед экранированием.

Этот метод предполагает отсутствие stringToEscape escape-последовательностей в нем.

По умолчанию строка экранируется в соответствии с RFC 2396. Если включен анализ международных идентификаторов ресурсов (IRIs) или международного доменного имени (IDN), строка экранируется в соответствии с RFC 3986 и RFC 3987. Эти rfCs приведены для определения зарезервированных и незарезервированных символов.

Дополнительные сведения о поддержке IRI см. в разделе "Примечания" для Uri класса.

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