Uri.MakeRelative(Uri) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

組件:

System.dll

組件:

netstandard.dll

警告

The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202

警告

Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).

警告

Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.

警告

The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202

判斷兩個 Uri 執行個體之間的差別。

public:
 System::String ^ MakeRelative(Uri ^ toUri);

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

[System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).")]
public string MakeRelative (Uri toUri);

[System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.")]
public string MakeRelative (Uri toUri);

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

public string MakeRelative (Uri toUri);

[<System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202")>]
member this.MakeRelative : Uri -> string

[<System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).")>]
member this.MakeRelative : Uri -> string

[<System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.")>]
member this.MakeRelative : Uri -> string

[<System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.MakeRelative : Uri -> string

member this.MakeRelative : Uri -> string

Public Function MakeRelative (toUri As Uri) As String

參數

toUri

Uri

要與目前之 URI 比較的 URI。

傳回

String

如果這個 URI 執行個體的主機名稱和配置與 toUri 相同，則這個方法會傳回代表相對 URI 的 String，當將這個相對 URI 附加到目前的 URI 執行個體時，會產生 toUri 參數。

如果主機名稱或配置不同，則這個方法會傳回代表 String 參數的 toUri。

屬性

ObsoleteAttribute

例外狀況

ArgumentNullException

toUri 為 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 以及呼叫 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 中，則會忽略使用者資訊。