Uri.MakeRelative(Uri) Uri.MakeRelative(Uri) Uri.MakeRelative(Uri) Uri.MakeRelative(Uri) Method

Definition

Warnung

Diese API ist jetzt veraltet.

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

public:
 System::String ^ MakeRelative(Uri ^ toUri);
[System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")]
[System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202")]
public string MakeRelative (Uri toUri);
member this.MakeRelative : Uri -> string
Public Function MakeRelative (toUri As Uri) As String

Parameter

toUri
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 toUri identisch sind, gibt diese Methode einen String zurück, der einen relativen URI darstellt, der beim Anfügen an die aktuelle URI-Instanz den toUri-Parameter liefert.If the hostname and scheme of this URI instance and toUri are the same, then this method returns a String that represents a relative URI that, when appended to the current URI instance, yields the toUri parameter.

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

Ausnahmen

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

Beispiele

Im folgenden Beispiel werden zwei Uri -Instanzen erstellt.The following example creates 2 Uri instances. Der Unterschied in den Pfadinformationen wird 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

Hinweise

In der folgenden Tabelle werden die URI- toUriInstanz, und die Ergebnisse des MakeRelativeAufrufs von angezeigt.The following table shows the URI instance, toUri, and the results of calling MakeRelative.

Aktuelle Uri-InstanzCurrent URI instance toUri RückgabewertReturn value
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, sofern Sie im URI vorhanden sind, werden ignoriert.User information, if present in the URI, is ignored.

Gilt für: