Uri.EscapeUriString(String) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

UriExt.cs

注意

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

将 URI 字符串转换为它的转义表示形式。

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

要转义的字符串。

返回

String

stringToEscape 的转义表示形式。

属性

ObsoleteAttribute

例外

ArgumentNullException

stringToEscape 为 null。

UriFormatException

stringToEscape 的长度超过 32766 个字符。

    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 未保留字符除外）转换为十六进制表示形式。 如果启用了国际资源标识符 (I RI) 或国际化域名 (IDN) 分析，该方法 EscapeUriString 会将除 RFC 3986 未保留字符之外的所有字符转换为十六进制表示形式。 在转义之前，所有 Unicode 字符都转换为 UTF-8 格式。

此方法假定 stringToEscape 中没有转义序列。

默认情况下，字符串根据 RFC 2396 进行转义。 如果启用了国际资源标识符 (I RI) 或国际化域名 (IDN) 分析，则会根据 RFC 3986 和 RFC 3987 转义字符串。 有关保留字符和未保留字符的定义，请参阅这些 RFC。

有关 IRI 支持的详细信息，请参阅 类的 Uri “备注”部分。