Uri.EscapeDataString 方法

定义

重载

EscapeDataString(ReadOnlySpan<Char>)

将范围转换为其转义表示形式。

EscapeDataString(String)

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

EscapeDataString(ReadOnlySpan<Char>)

将范围转换为其转义表示形式。

public static string EscapeDataString (ReadOnlySpan<char> charsToEscape);

参数

charsToEscape
ReadOnlySpan<Char>

要转义的跨度。

返回

charsToEscape的转义表示形式。

适用于

.NET 9
产品 版本
.NET 9

EscapeDataString(String)

Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs

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

public static string EscapeDataString (string stringToEscape);

参数

stringToEscape
String

要转义的字符串。

返回

stringToEscape的转义表示形式。

例外

stringToEscape null

注意:在适用于 Windows 应用商店应用的 .NET可移植类库中,请改为捕获基类异常,FormatException

stringToEscape 长度超过 32766 个字符。

注解

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

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

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

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

适用于

.NET 9 和其他版本
产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0