Uri.MakeRelativeUri(Uri) Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

Określa różnicę między dwoma Uri wystąpieniami.

public:
 Uri ^ MakeRelativeUri(Uri ^ uri);

public Uri MakeRelativeUri (Uri uri);

member this.MakeRelativeUri : Uri -> Uri

Public Function MakeRelativeUri (uri As Uri) As Uri

Parametry

uri

Uri

Identyfikator URI do porównania z bieżącym identyfikatorem URI.

Zwraca

Uri

Jeśli nazwa hosta i schemat tego wystąpienia identyfikatora URI są uri takie same, ta metoda zwraca wartość względną Uri , która po dołączeniu do bieżącego wystąpienia identyfikatora URI zwraca wartość uri.

Jeśli nazwa hosta lub schemat jest inna, ta metoda zwraca Uri parametr reprezentujący uri parametr.

Wyjątki

ArgumentNullException

uri to null.

InvalidOperationException

To wystąpienie reprezentuje względny identyfikator URI, a ta właściwość jest prawidłowa tylko dla bezwzględnych identyfikatorów URI.

Przykłady

Poniższy przykład tworzy 2 Uri wystąpienia. Różnica w informacjach o ścieżce jest zapisywana w konsoli programu .

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

Uwagi

W poniższej tabeli przedstawiono wystąpienie identyfikatora URI oraz toUriwyniki wywołania metody MakeRelativeUri.

Bieżące wystąpienie identyfikatora URI	toUri	Wartość zwracana
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

Informacje o użytkowniku, jeśli znajdują się w identyfikatorze URI, są ignorowane.