Uri.GetComponents メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Uri.GetComponents メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した特殊文字エスケープを使用して、現在のインスタンスの指定した構成要素を取得します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As Uri
Dim components As UriComponents
Dim format As UriFormat
Dim returnValue As String

returnValue = instance.GetComponents(components, format)

public string GetComponents (
    UriComponents components,
    UriFormat format
)

C++

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

public String GetComponents (
    UriComponents components, 
    UriFormat format
)

JScript

public function GetComponents (
    components : UriComponents, 
    format : UriFormat
) : String

パラメータ

components: 現在のインスタンスの中で呼び出し元に返す部分を指定する UriComponents 値のビットごとの組み合わせ。

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

戻り値
構成要素が含まれる文字列。

例外

例外の種類	条件
ArgumentOutOfRangeException	uriComponents が、有効な UriComponents 値の組み合わせではありません。
InvalidOperationException	現在の Uri が絶対 URI ではありません。相対 URI は、このメソッドでは使用できません。

解説

Query または Fragment が単独で指定されている場合、戻り値に区切り記号が含まれます。Scheme、UserInfo、Host、Port、および Path の各構成要素には、区切り記号が含まれません。その他すべての UriComponents 値、および値の組み合わせについては、戻り値に区切り記号が含まれます。

構成要素は、URI に表示される順序で返されます。たとえば、Scheme を指定すると、この構成要素が最初に表示されます。

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