Uri.MakeRelativeUri(Uri) Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: Uri.cs

Origem:: Uri.cs

Origem:: Uri.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

O URI a ser comparado com o URI atual.

Retornos

Uri

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

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

Exceções

ArgumentNullException

uri é null.

InvalidOperationException

Esta instância representa uma URL relativa, e esta propriedade só é válida para URIs absolutos.

Exemplos

O exemplo a seguir cria duas 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 de URI, toUrie os resultados da chamada MakeRelativeUri.

Instância de 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

Partilhar via