Uri.EscapeUriString(String) Метод

Ссылка

Определение

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

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

Сборка:: System.dll

Сборка:: netstandard.dll

Исходный код:: UriExt.cs

Исходный код:: UriExt.cs

Исходный код:: UriExt.cs

Важно!

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

Внимание!

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

Внимание!

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);

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.", 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}")]
public static string EscapeUriString (string stringToEscape);

static member EscapeUriString : string -> string

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

[<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://learn.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://learn.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 метод преобразует все символы, кроме безрезервированных символов RFC 2396, в их шестнадцатеричное представление. Если включен EscapeUriString синтаксический анализ международных идентификаторов ресурсов (IRIs) или международного доменного имени (IDN), метод преобразует все символы, за исключением безрезервированных символов RFC 3986, в их шестнадцатеричное представление. Перед экранированием все символы Юникода преобразуются в формат UTF-8.

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

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

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

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

Поделиться через