Uri.MakeRelativeUri(Uri) メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

アセンブリ:

System.dll

アセンブリ:

netstandard.dll

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

public:
 Uri ^ MakeRelativeUri(Uri ^ uri);

public Uri MakeRelativeUri (Uri uri);

member this.MakeRelativeUri : Uri -> Uri

Public Function MakeRelativeUri (uri As Uri) As Uri

パラメーター

uri

Uri

現在の URI と比較する URI。

戻り値

Uri

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

ホスト名またはスキームが異なる場合は、Uri パラメーターを表す uri がこのメソッドから返されます。

例外

ArgumentNullException

uri が nullです。

InvalidOperationException

このインスタンスは相対 URI を表します。このプロパティは、絶対 URI でのみ有効です。

例

次の例では、2 つの Uri インスタンスを作成します。 パス情報の違いは、コンソールに書き込まれます。

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

// Create a new Uri from a string.
Uri^ address2 = gcnew Uri( "http://www.contoso.com/index.htm?date=today" );

// Determine the relative Uri.  
Console::WriteLine( "The difference is {0}", address1->MakeRelativeUri( address2 ) );

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

// Create a base Uri.
let address1 = Uri "http://www.contoso.com/"

// Create a new Uri from a string.
let address2 = Uri "http://www.contoso.com/index.htm?date=today"

// Determine the relative Uri.
printfn $"The difference is {address1.MakeRelativeUri address2}"

    ' 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

注釈

次の表は、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 に存在する場合、ユーザー情報は無視されます。