Path.GetPathRoot Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.Runtime.Extensions.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
GetPathRoot(String)

Obtém a informação do diretório raiz do caminho contido na cadeia especificada.
GetPathRoot(ReadOnlySpan<Char>)

Obtém a informação do diretório raiz do caminho contido no espaço de caracteres especificado.

GetPathRoot(String)

Origem:
Path.Unix.cs
Origem:
Path.Unix.cs
Origem:
Path.Unix.cs
Origem:
Path.Unix.cs
Origem:
Path.Unix.cs

Obtém a informação do diretório raiz do caminho contido na cadeia especificada.

public:
 static System::String ^ GetPathRoot(System::String ^ path);
public static string GetPathRoot(string path);
public static string? GetPathRoot(string? path);
static member GetPathRoot : string -> string
Public Shared Function GetPathRoot (path As String) As String

Parâmetros

path
String

Uma cadeia que contém o caminho a partir do qual obter informação do diretório raiz.

Devoluções

String

O diretório raiz de path se está enraizado.

-ou-

Empty if path não contém informação do diretório raiz.

-ou-

null se path for null ou for efetivamente vazio.

Exceções

ArgumentException

.NET Framework e .NET Core versões anteriores à 2.1: path contém um ou mais dos caracteres inválidos definidos em GetInvalidPathChars().

-ou-

.NET apenas Framework: Empty foi passado para path.

Exemplos

O exemplo seguinte demonstra a utilização do GetPathRoot método.

string path = @"\mydir\";
string fileName = "myfile.ext";
string fullPath = @"C:\mydir\myfile.ext";
string pathRoot;

pathRoot = Path.GetPathRoot(path);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    path, pathRoot);

pathRoot = Path.GetPathRoot(fileName);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    fileName, pathRoot);

pathRoot = Path.GetPathRoot(fullPath);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    fullPath, pathRoot);

// This code produces output similar to the following:
//
// GetPathRoot('\mydir\') returns '\'
// GetPathRoot('myfile.ext') returns ''
// GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

Dim pathname As String = "\mydir\"
Dim fileName As String = "myfile.ext"
Dim fullPath As String = "C:\mydir\myfile.ext"
Dim pathnameRoot As String

pathnameRoot = Path.GetPathRoot(pathname)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", pathname, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fileName)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fileName, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fullPath)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fullPath, pathnameRoot)

' This code produces output similar to the following:
'
' GetPathRoot('\mydir\') returns '\'
' GetPathRoot('myfile.ext') returns ''
' GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

Observações

Este método não verifica se o caminho ou ficheiro existe.

Este método normaliza os separadores de diretórios.

Uma cadeia é "efetivamente vazia" se:

  • Em Windows, chamar IsEmpty nesta cadeia devolve true, ou todos os seus caracteres são espaços (' ').
  • No Unix, chamar IsNullOrEmpty esta cadeia retorna true.

Os padrões possíveis para a cadeia devolvida por este método são os seguintes:

  • null (path era nulo ou uma cadeia vazia).

  • Uma cadeia vazia (path especificada um caminho relativo no drive ou volume atual).

  • "/" (Unix: path especificou um caminho absoluto no disco atual).

  • "X:" (Windows: path especificava um caminho relativo numa unidade, onde X representa uma letra de drive ou volume).

  • "X:\" (Windows: path especificava um caminho absoluto numa determinada unidade).

  • "\\NomeComputador\PastaPartilhada" (Windows: um caminho UNC).

  • "\\?\C:" (Windows: um caminho de dispositivo DOS, suportado nas versões .NET e no .NET Framework 4.6.2 e versões posteriores).

Para mais informações sobre caminhos de ficheiro em Windows, consulte formatos de caminho de ficheiro em sistemas Windows. Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

Aplica-se a

GetPathRoot(ReadOnlySpan<Char>)

Origem:
Path.Unix.cs
Origem:
Path.Unix.cs
Origem:
Path.Unix.cs
Origem:
Path.Unix.cs
Origem:
Path.Unix.cs

Obtém a informação do diretório raiz do caminho contido no espaço de caracteres especificado.

public:
 static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);
public static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);
static member GetPathRoot : ReadOnlySpan<char> -> ReadOnlySpan<char>
Public Shared Function GetPathRoot (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Parâmetros

path
ReadOnlySpan<Char>

Um espaço de apenas leitura de caracteres contendo o caminho a partir do qual obter informação do diretório raiz.

Devoluções

ReadOnlySpan<Char>

Um intervalo de apenas leitura de caracteres contendo o diretório raiz de path.

Observações

Este método não verifica se o caminho ou ficheiro existe.

Ao contrário da sobrecarga de strings, este método não normaliza separadores de diretórios.

A ReadOnlySpan<System.Char> é "efetivamente vazio" se:

Os padrões possíveis para o intervalo de caracteres apenas de leitura devolvido por este método são os seguintes:

  • ReadOnlySpan<T>.Empty (path era ReadOnlySpan<T>.Empty.

  • ReadOnlySpan<T>.Empty (path especificava um caminho relativo no disco ou volume atual).

  • "/" (Unix: path especificou um caminho absoluto no disco atual).

  • "X:" (Windows: path especificava um caminho relativo numa unidade, onde X representa uma letra de drive ou volume).

  • "X:\" (Windows: path especificava um caminho absoluto numa determinada unidade).

  • "\\NomeComputador\PastaPartilhada" (Windows: um caminho UNC).

  • "\\?\C:" (Windows: um caminho de dispositivo DOS, suportado nas versões .NET e no .NET Framework 4.6.2 e versões posteriores).

Para mais informações sobre caminhos de ficheiro em Windows, consulte formatos de caminho de ficheiro em sistemas Windows. Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

Aplica-se a