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

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

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

Uri.MakeRelative メソッド

メモ : このメソッドは、互換性のために残されています。

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

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

Visual Basic (宣言)

<ObsoleteAttribute("The method has been deprecated. Please
 use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Function MakeRelative ( _
    toUri As Uri _
) As String

Visual Basic (使用法)

Dim instance As Uri
Dim toUri As Uri
Dim returnValue As String

returnValue = instance.MakeRelative(toUri)

[ObsoleteAttribute("The method has been deprecated. Please use MakeRelativeUri(Uri
 uri). http://go.microsoft.com/fwlink/?linkid=14202")] 
public string MakeRelative (
    Uri toUri
)

C++

[ObsoleteAttribute(L"The method has been deprecated. Please use MakeRelativeUri(Uri
 uri). http://go.microsoft.com/fwlink/?linkid=14202")] 
public:
String^ MakeRelative (
    Uri^ toUri
)

/** @attribute ObsoleteAttribute("The method has been deprecated. Please use
 MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")
 */ 
public String MakeRelative (
    Uri toUri
)

JScript

ObsoleteAttribute("The method has been deprecated. Please use MakeRelativeUri(Uri
 uri). http://go.microsoft.com/fwlink/?linkid=14202") 
public function MakeRelative (
    toUri : Uri
) : String

パラメータ

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

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

例外

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

解説

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

現在の 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));