System.Uri.GetComponents 方法
方法描述
使用特殊字符的指定转义,获取当前实例的指定部分。
语法定义(C# System.Uri.GetComponents 方法 的用法)
public string GetComponents( UriComponents components, UriFormat format )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
components | System-UriComponents | UriComponents 值的按位组合,它指定当前实例中要返回到调用方的部分。 |
format | System-UriFormat | UriFormat 值中的一个,它控制如何转义特殊字符。 |
返回值 | System.String | 一个包含这些部分的 String。 |
提示和注释
单独指定 Query 或 Fragment 时,返回值包括分隔符。 Scheme 、UserInfo、Host、Port 和 Path 部分不包括分隔符。 对于所有其他 UriComponents 值以及这些值的组合,分隔符会包括在返回值中。
这些组成部分按照各自在 URI 中显示的顺序返回。 例如,如果指定 Scheme,它将第一个出现。
在启用国际资源标识符 (IRI) 和国际化域名 (IDN) 支持之后,String 中返回的字符的数量将增加。 用于支持 IRI 的 Punycode 名称仅包含 ASCII 字符,并且总是以 xn-- 前缀开头。 在启用 IRI 和 IDN 之后,GetComponents 方法将正确处理 Unicode 代理项字符。
有关 IRI 支持的更多信息,请参见 Uri 类的“备注”部分。
注意
如果调用 GetComponents 方法时 format 设置为 Unescaped,则不能使用返回值作为 Uri 构造函数的参数来创建等效的 Uri。
System.Uri.GetComponents 方法例子
异常
异常 | 异常描述 |
---|---|
ArgumentOutOfRangeException | uriComponents 不是有效 UriComponents 值的组合。 |
InvalidOperationException | 当前 Uri 不是绝对 URI。 相对 URI 不能和此方法一起使用。 |
版本信息
.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。