Path.GetRelativePath(String, String) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

Path.cs

Retorna um caminho relativo de um caminho para outro.

public:
 static System::String ^ GetRelativePath(System::String ^ relativeTo, System::String ^ path);

public static string GetRelativePath (string relativeTo, string path);

static member GetRelativePath : string * string -> string

Public Shared Function GetRelativePath (relativeTo As String, path As String) As String

Parâmetros

relativeTo

String

O caminho de origem ao qual o resultado deve ser relativo. Esse caminho é sempre considerado um diretório.

path

String

O caminho de destino.

Retornos

String

O caminho relativo ou path se os caminhos não compartilham a mesma raiz.

Exceções

ArgumentNullException

relativeTo ou path é null.

ArgumentException

relativeTo ou path está efetivamente vazio.

Exemplos

O código a seguir mostra como chamar o GetRelativePath método .

// "C:/Program Files/Microsoft" relative to "C:/Program Files/Common Files" is "../Microsoft"
Console.WriteLine(Path.GetRelativePath("C:/Program Files/Common Files", "C:/Program Files/Microsoft"));
// "C:/Program Files/Microsoft" relative to "C:/Program Files/" is "Microsoft"
Console.WriteLine(Path.GetRelativePath("C:/Program Files/", "C:/Program Files/Microsoft"));

// This code produces output similar to the following:
//
// ../Microsoft
// Microsoft

' "C:/Program Files/Microsoft" relative to "C:/Program Files/Common Files" is "../Microsoft"
Console.WriteLine(Path.GetRelativePath("C:/Program Files/Common Files", "C:/Program Files/Microsoft"))
' "C:/Program Files/Microsoft" relative to "C:/Program Files/" is "Microsoft"
Console.WriteLine(Path.GetRelativePath("C:/Program Files/", "C:/Program Files/Microsoft"))

' This code produces output similar to the following:
'
' ../Microsoft
' Microsoft

Comentários

Os caminhos são resolvidos chamando o GetFullPath método antes de calcular a diferença. O método usa a comparação de caminho de arquivo padrão para a plataforma atual (StringComparison.OrdinalIgnoreCase para Windows e MacOs, StringComparison.Ordinal para Linux.

Confira também

• Formatos de caminho de arquivo em sistemas Windows