共用方式為


Uri.GetComponents(UriComponents, UriFormat) 方法

定義

針對特殊字元使用指定的逸出方式,取得目前執行個體的指定元件。

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

目前執行個體的元件。

例外狀況

components 不是有效 UriComponents 值的結合。

目前的 Uri 不是絕對 URI。 相對 URI 不能用於這個方法。

備註

QueryFragmentSchemeUserInfoHostPortPath 元件不包含分隔符號。 您可以使用位 OR) 運算子,將旗標 (與其中任何一個值結合 KeepDelimiter ,以取得具有分隔符號的值。 針對所有其他 UriComponents 值和值的組合,分隔符號會包含在傳回的值中。

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

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

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

注意

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

適用於