Uri.EscapeDataString(String) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

程序集:

System.dll

程序集:

netstandard.dll

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

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

要转义的字符串。

返回

String

stringToEscape 的转义表示形式。

例外

ArgumentNullException

stringToEscape 为 null。

UriFormatException

注意：在适用于 Windows 应用商店应用的 .NET 或可移植类库中，改为捕获基类异常 FormatException。

stringToEscape 的长度超过 32766 个字符。

注解

默认情况下，该方法 EscapeDataString 将所有字符（RFC 2396 无保留字符除外）转换为其十六进制表示形式。 如果启用了国际资源标识符 (IR) 或国际化域名 (IDN) 分析，该方法 EscapeDataString 会将 RFC 3986 未保留字符以外的所有字符转换为其十六进制表示形式。 在转义之前，所有 Unicode 字符都转换为 UTF-8 格式。

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

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

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