Uri.MakeRelativeUri メソッド

.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)

C#

public Uri MakeRelativeUri (
    Uri uri
)

C++

public:
Uri^ MakeRelativeUri (
    Uri^ uri
)

J#

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

C#

// 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));

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Uri クラス
Uri メンバ
System 名前空間