Uri.MakeRelativeUri(Uri) Uri.MakeRelativeUri(Uri) Uri.MakeRelativeUri(Uri) Method

Definition

Bestimmt den Unterschied zwischen zwei Uri-Instanzen.Determines the difference between two Uri instances.

public:
 Uri ^ MakeRelativeUri(Uri ^ uri);
public Uri MakeRelativeUri (Uri uri);
member this.MakeRelativeUri : Uri -> Uri

Parameter

uri
Uri Uri Uri

Der mit dem aktuellen URI zu vergleichende URI.The URI to compare to the current URI.

Gibt zurück

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.If the hostname and scheme of this URI instance and uri are the same, then this method returns a relative Uri that, when appended to the current URI instance, yields uri.

Wenn der Hostname oder das Schema nicht identisch ist, gibt diese Methode einen Uri zurück, der den uri-Parameter darstellt.If the hostname or scheme is different, then this method returns a Uri that represents the uri parameter.

Ausnahmen

Diese Instanz stellt einen relativen URI dar, diese Eigenschaft ist jedoch nur für absolute URIs gültig.This instance represents a relative URI, and this property is valid only for absolute URIs.

Beispiele

Das folgende Beispiel erstellt 2 Uri Instanzen.The following example creates 2 Uri instances. Der Unterschied in der die Informationen werden in die Konsole geschrieben.The difference in the path information is written to the console.

// 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.
    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 'SampleMakeRelative

Hinweise

Die folgende Tabelle zeigt die URI-Instanz toUri, und die Ergebnisse des Aufrufs MakeRelativeUri.The following table shows the URI instance, toUri, and the results of calling MakeRelativeUri.

Aktuelle URI-InstanzCurrent URI instance toUri RückgabewertReturn value
http://www.contoso.com/ http://www.contoso.com/test/test.htm test/test.htmtest/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.txttest1/test1.txt

Benutzerinformationen, wird ignoriert, wenn im URI vorhanden ist.User information, if present in the URI, is ignored.

Gilt für: