Uri.MakeRelative メソッド

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

C#

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

J#

/** @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

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
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)
.NET Compact Framework
サポート対象 : 1.0
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

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