Uri.MakeRelativeUri(Uri) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

Uri.cs

Determina la diferencia que existe entre dos instancias de Uri.

public:
 Uri ^ MakeRelativeUri(Uri ^ uri);

public Uri MakeRelativeUri (Uri uri);

member this.MakeRelativeUri : Uri -> Uri

Public Function MakeRelativeUri (uri As Uri) As Uri

Parámetros

uri

Uri

Identificador URI que se va a comparar con el identificador URI actual.

Devoluciones

Uri

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.

Si el nombre de host o el esquema son diferentes, este método devuelve un Uri que representa el parámetro uri.

Excepciones

ArgumentNullException

uri es null.

InvalidOperationException

Esta instancia representa un identificador URI relativo, y esta propiedad sólo es válida para identificadores URI absolutos.

Ejemplos

En el ejemplo siguiente se crean dos Uri instancias. La diferencia en la información de ruta de acceso se escribe en la consola.

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

Comentarios

En la tabla siguiente se muestra la instancia de URI, toUriy los resultados de llamar a MakeRelativeUri.

Instancia de URI actual	toUri	Valor devuelto
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.