Uri.MakeRelativeUri(Uri) Metoda

Definicja

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

uri to null.

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.

Dotyczy