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

Definición

Advertencia

Esta API está ya obsoleta.

Determina la diferencia que existe entre dos instancias de Uri.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

Parámetros

toUri
Uri Uri Uri Uri

Identificador URI que se va a comparar con el identificador URI actual.The URI to compare to the current URI.

Devoluciones

Si el nombre de host y el esquema de esta instancia de identificador URI y toUri son iguales, este método devuelve un String que representa un identificador URI relativo que, cuando se anexa a la instancia de identificador URI actual, genera el parámetro toUri.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.

Si el nombre de host o el esquema son diferentes, este método devuelve un String que representa el parámetro toUri.If the hostname or scheme is different, then this method returns a String that represents the toUri parameter.

Excepciones

Esta instancia representa un identificador URI relativo, y este método sólo es válido para identificadores URI absolutos.This instance represents a relative URI, and this method is valid only for absolute URIs.

Ejemplos

En el ejemplo siguiente se crean dos instancias de Uri.The following example creates 2 Uri instances. La diferencia en la información de la ruta de acceso se escribe en la consola.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

Comentarios

En la tabla siguiente se muestra la instancia de URI, toUri y los resultados de llamar a MakeRelative.The following table shows the URI instance, toUri, and the results of calling MakeRelative.

Instancia de URI actualCurrent URI instance toUri Valor devueltoReturn 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

La información del usuario, si está presente en el URI, se omite.User information, if present in the URI, is ignored.

Se aplica a