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

Definición

Determina la diferencia que existe entre dos instancias de Uri.Determines the difference between two Uri instances.

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

Parámetros

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 uri son iguales, este método devuelve un Uri relativo que, cuando se anexa a la instancia de identificador URI actual, genera uri.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.

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

Excepciones

Esta instancia representa un identificador URI relativo, y esta propiedad sólo es válida para identificadores URI absolutos.This instance represents a relative URI, and this property is valid only for absolute URIs.

Ejemplos

En el ejemplo siguiente se Uri crean dos instancias.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 toUride URI, y los resultados MakeRelativeUride una llamada a.The following table shows the URI instance, toUri, and the results of calling MakeRelativeUri.

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