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


Uri.EscapeUriString(String) Метод

Определение

Внимание!

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-представление.

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

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

Атрибуты

Исключения

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

Длина 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 чтобы подготовить неэкранированную строку 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 для класса .

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