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 、 Port 和 Path 元件不包含分隔符號。 您可以使用位 OR) 運算子，將旗標 (與其中任何一個值結合 KeepDelimiter ，以取得具有分隔符號的值。 針對所有其他 UriComponents 值和值的組合，分隔符號會包含在傳回的值中。

元件會依照它們出現在 URI 中的順序傳回。 例如，如果 Scheme 已指定，則會先顯示。

啟用國際資源識別碼 (IRI) 和國際化功能變數名稱 (IDN) 支援時，就會增加中 String 傳回的字元數。 用來支援 IRI 的 Punycode 名稱只包含 ASCII 字元，且一律以 xn-- 前置詞開頭。 啟用 IRI 和 IDN 時，Unicode Surrogate 字元會由 GetComponents 方法正確處理。

如需 IRI 支援的詳細資訊，請參閱 類別的 Uri 一節。

注意

GetComponents如果呼叫 方法時 format 設定 Unescaped 為 ，則您無法使用傳回值做為建構函式的引數 Uri ，以建立相等 Uri 的 。