Uri.EscapeUriString(String) Метод

Определение

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

System

Сборка:

System.Runtime.dll

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

UriExt.cs

Внимание!

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.

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

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

[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString (string stringToEscape);

[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string

Public Shared Function EscapeUriString (stringToEscape As String) As String

Параметры

stringToEscape

String

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

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

String

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

Атрибуты

ObsoleteAttribute

Исключения

ArgumentNullException

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

UriFormatException

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

    Note: In <a href="https://docs.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://docs.microsoft.com/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library">Portable Class Library</a>, catch the base class exception, <xref data-throw-if-not-resolved="true" uid="System.FormatException"></xref>, instead.

Комментарии

Используйте метод , EscapeUriString чтобы подготовить неэкранированную строку URI в виде параметра для конструктора Uri .

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

В этом методе предполагается, что stringToEscape в нем нет escape-последовательностей.

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

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