Uri.MakeRelative(Uri) Método

Definição

Cuidado

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

Cuidado

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

Cuidado

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

Cuidado

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

Determina a diferença entre duas instâncias 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

O URI a ser comparado com o URI atual.

Retornos

String

Se o nome de host e o esquema dessa instância do URI e toUri forem os mesmos, esse método retornará um String representando um URI relativo que, quando for anexado à instância atual do URI, gerará o parâmetro toUri.

Se o nome do host ou o esquema for diferente, esse método retornará um String que representa o parâmetro toUri.

Atributos

Exceções

toUri é null.

Essa instância representa um URI relativo e esse método é válido apenas para URIs absolutos.

Exemplos

O exemplo a seguir cria 2 Uri instâncias. A diferença nas informações do caminho é gravada no 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.
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

Comentários

A tabela a seguir mostra a instância toUride URI e os resultados da chamada MakeRelative.

Instância do URI atual toUri Valor retornado
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

As informações do usuário, se presentes no URI, são ignoradas.

Aplica-se a