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

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

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

Uri.MakeRelativeUri メソッド

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

2 つの Uri インスタンスの相違点を判断します。

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

Visual Basic (宣言)

Public Function MakeRelativeUri ( _
    uri As Uri _
) As Uri

Visual Basic (使用法)

Dim instance As Uri
Dim uri As Uri
Dim returnValue As Uri

returnValue = instance.MakeRelativeUri(uri)

public Uri MakeRelativeUri (
    Uri uri
)

C++

public:
Uri^ MakeRelativeUri (
    Uri^ uri
)

public Uri MakeRelativeUri (
    Uri uri
)

JScript

public function MakeRelativeUri (
    uri : Uri
) : Uri

パラメータ

uri: 現在の URI と比較する URI。

戻り値
この URI インスタンスと toUri のホスト名とスキームが同じ場合、現在の URI インスタンスに追加したときに toUri を作成する相対 URI がこのメソッドから返されます。ホスト名とスキームが異なる場合、このメソッドは、toUri を返します。

例外

例外の種類	条件
InvalidOperationException	このインスタンスは相対 URI を表します。このプロパティは、絶対 URI でのみ有効です。

解説

URI インスタンス、toUri、および MakeRelativeUri の呼び出し結果を次の表に示します。

現在の URI インスタンス	toUri	戻り値
http://www.contoso.com/	http://www.contoso.com/test/test.htm	test/test.htm
http://www.contoso.com/test1/	http://www.contoso.com/	../
http://www.contoso.com:8000/	http://www.contoso.com/test/test.htm	http://www.contoso.com/test/test.htm
http://username@www.contoso.com/	http://www.contoso.com/test1/test1.txt	test1/test1.txt

URI にユーザー情報が含まれる場合、このユーザー情報は無視されます。

使用例

2 つの Uri インスタンスを作成する例を次に示します。パス情報の相違点がコンソールに出力されます。

Visual Basic

    ' Create a base Uri.
    Dim address1 As New
 Uri("http://www.contoso.com/")
    
    ' Create a new Uri from a string.
    Dim address2 As New
 Uri("http://www.contoso.com/index.htm?date=today")
    
    ' Determine the relative Uri.  
    Console.WriteLine("The difference is {0}", address1.MakeRelativeUri(address2))

End Sub 'SampleMakeRelative

// Create a base Uri.
Uri address1 = new Uri("http://www.contoso.com/");

// Create a new Uri from a string.
Uri address2 = new Uri("http://www.contoso.com/index.htm?date=today");
 
           
// Determine the relative Uri.  
Console.WriteLine("The difference is {0}", address1.MakeRelativeUri(address2));