Uri.GetComponents(UriComponents, UriFormat) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

UriExt.cs

特殊文字の指定したエスケープを使用して、現在のインスタンスの指定されたコンポーネントを取得します。

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

特殊文字のエスケープ方法を制御する列挙値の 1 つ。

返品

String

現在のインスタンスのコンポーネント。

例外

ArgumentOutOfRangeException

components は有効な UriComponents 値の組み合わせではありません。

InvalidOperationException

現在の Uri は絶対 URI ではありません。 このメソッドでは、相対 URI を使用できません。

注釈

Query、Fragment、Scheme、UserInfo、Host、Port、およびPathの各コンポーネントには、区切り記号は含まれません。 KeepDelimiter フラグ (ビットごとの OR 演算子を使用) をこれらの値と組み合わせて、区切り記号で値を取得できます。 他のすべての UriComponents 値と値の組み合わせについては、区切り記号が戻り値に含まれます。

コンポーネントは、URI に表示される順序で返されます。 たとえば、 Scheme を指定すると、最初に表示されます。

国際リソース識別子 (IRI) と国際化ドメイン名 (IDN) のサポートを有効にすると、 String で返される文字数が増えます。 IRI をサポートするために使用される Punycode 名には ASCII 文字のみが含まれ、常に xn-- プレフィックスで始まります。 IRI と IDN が有効になっている場合、Unicode サロゲート文字は GetComponents メソッドによって正しく処理されます。

IRI サポートの詳細については、 Uri クラスの「解説」セクションを参照してください。

Note

GetComponentsを format に設定してUnescaped メソッドが呼び出された場合、戻り値を Uri コンストラクターの引数として使用して同等のUriを作成することはできません。