Uri.GetComponents(UriComponents, UriFormat) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

程序集:

System.dll

程序集:

netstandard.dll

使用特殊字符的指定转义，获取当前实例的指定部分。

public:
 System::String ^ GetComponents(UriComponents components, UriFormat format);

public string GetComponents (UriComponents components, UriFormat format);

member this.GetComponents : UriComponents * UriFormat -> string

Public Function GetComponents (components As UriComponents, format As UriFormat) As String

参数

components

UriComponents

UriComponents 值的按位组合，它指定当前实例中要返回到调用方的部分。

format

UriFormat

枚举值之一，它控制如何转义特殊字符。

返回

String

当前实例的组件。

例外

ArgumentOutOfRangeException

components 不是有效 UriComponents 值的组合。

InvalidOperationException

当前 Uri 不是绝对 URI。 相对 URI 不能和此方法一起使用。

注解

Query、Fragment、Scheme、UserInfo、Host和PortPath组件不包含分隔符。 可以使用按位 OR 运算符将标志) (与其中任何值结合使用 KeepDelimiter ，以使用分隔符获取值。 对于所有其他 UriComponents 值和值组合，分隔符将包含在返回的值中。

组件按 URI 中显示的顺序返回。 例如，如果 Scheme 指定，则首先显示它。

启用国际资源标识符 (IRI) 和国际化域名 (IDN) 支持时，将增加返回 String 的字符数。 用于支持 IRI 的 Punycode 名称仅包含 ASCII 字符，并且始终以 xn- 前缀开头。 启用 IRI 和 IDN 后，Unicode 代理字符由 GetComponents 该方法正确处理。

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

备注

If the GetComponents method is called with format set to Unescaped , you cannot use the return value as an argument to a Uri constructor to create an equivalent Uri.