Uri.MakeRelativeUri(Uri) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Bestimmt den Unterschied zwischen zwei Uri-Instanzen.

public:
 Uri ^ MakeRelativeUri(Uri ^ uri);

public Uri MakeRelativeUri (Uri uri);

member this.MakeRelativeUri : Uri -> Uri

Public Function MakeRelativeUri (uri As Uri) As Uri

Parameter

uri

Uri

Der mit dem aktuellen URI zu vergleichende URI.

Gibt zurück

Uri

Wenn der Hostname und das Schema dieser URI-Instanz mit uri identisch sind, gibt diese Methode einen relativen Uri zurück, der beim Anfügen an die aktuelle URI-Instanz uri liefert.

Wenn der Hostname oder das Schema nicht identisch ist, gibt diese Methode einen Uri zurück, der den uri-Parameter darstellt.

Ausnahmen

ArgumentNullException

uri ist null.

InvalidOperationException

Diese Instanz stellt einen relativen URI dar, diese Eigenschaft ist jedoch nur für absolute URIs gültig.

Beispiele

Im folgenden Beispiel werden 2 Uri Instanzen erstellt. Der Unterschied in den Pfadinformationen wird in die Konsole geschrieben.

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

Hinweise

Die folgende Tabelle zeigt die URI-Instanz und toUridie Ergebnisse des Aufrufens MakeRelativeUri.

Aktuelle URI-Instanz	toUri	Rückgabewert
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

Benutzerinformationen, wenn sie im URI vorhanden sind, werden ignoriert.