Uri.MakeRelative(Uri) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

Precaución

The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202

Precaución

Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).

Precaución

Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.

Precaución

The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202

Determina la diferencia que existe entre dos instancias de Uri.

public:
 System::String ^ MakeRelative(Uri ^ toUri);

[System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202")]
public string MakeRelative (Uri toUri);

[System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).")]
public string MakeRelative (Uri toUri);

[System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.")]
public string MakeRelative (Uri toUri);

[System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")]
public string MakeRelative (Uri toUri);

public string MakeRelative (Uri toUri);

[<System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). https://go.microsoft.com/fwlink/?linkid=14202")>]
member this.MakeRelative : Uri -> string

[<System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri).")>]
member this.MakeRelative : Uri -> string

[<System.Obsolete("Uri.MakeRelative has been deprecated. Use MakeRelativeUri(Uri uri) instead.")>]
member this.MakeRelative : Uri -> string

[<System.Obsolete("The method has been deprecated. Please use MakeRelativeUri(Uri uri). http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.MakeRelative : Uri -> string

member this.MakeRelative : Uri -> string

Public Function MakeRelative (toUri As Uri) As String

Parámetros

toUri

Uri

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

Devoluciones

String

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.

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

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

toUri es null.

InvalidOperationException

Esta instancia representa un identificador URI relativo, y este método sólo es válido 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 MakeRelative.

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.