Path.GetPathRoot Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

GetPathRoot(String)	Obtém as informações do diretório raiz do caminho contido na cadeia de caracteres especificada.
GetPathRoot(ReadOnlySpan<Char>)	Obtém as informações do diretório raiz do caminho contido no intervalo de caracteres especificado.

GetPathRoot(String)

Origem:

Path.Unix.cs

Obtém as informações do diretório raiz do caminho contido na cadeia de caracteres especificada.

public:
 static System::String ^ GetPathRoot(System::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 de caracteres que contém o caminho pelo qual obter informações do diretório raiz.

Retornos

String

O diretório raiz do path se ele estiver com raiz.

- ou -

Empty se path não contiver informações do diretório raiz.

- ou -

null se path for null ou estiver efetivamente vazio.

Exceções

ArgumentException

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

- ou -

Somente .NET Framework: Empty foi passado para path.

Exemplos

O exemplo a seguir demonstra o uso 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:\'

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:\'

Comentários

Esse método não verifica se o caminho ou arquivo existe.

Esse método normalizará separadores de diretório.

Uma cadeia de caracteres será "efetivamente vazia" se:

• No Windows, chamar IsEmpty nessa cadeia de caracteres retorna trueou todos os seus caracteres são espaços (' ').
• No Unix, chamar IsNullOrEmpty nessa cadeia de caracteres retorna true.

Os padrões possíveis para a cadeia de caracteres retornada por esse método são os seguintes:

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

• Uma cadeia de caracteres vazia (path especificou um caminho relativo na unidade ou volume atual).

• "/" (Unix: path especificou um caminho absoluto na unidade atual).

• "X:" (Windows: path especificou um caminho relativo em uma unidade, em que X representa uma letra de unidade ou volume).

• "X:\" (Windows: path especificou um caminho absoluto em uma determinada unidade).

• "\\ComputerName\SharedFolder" (Windows: um caminho UNC).

• "\\?\C:" (Windows: um caminho do dispositivo DOS, com suporte no .NET Core 1.1 e versões posteriores e em .NET Framework 4.6.2 e versões posteriores).

Para obter mais informações sobre caminhos de arquivo no Windows, consulte Formatos de caminho de arquivo em sistemas Windows. Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

• Formatos de caminho de arquivo em sistemas Windows
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

GetPathRoot(ReadOnlySpan<Char>)

Origem:

Path.Unix.cs

Obtém as informações do diretório raiz do caminho contido no intervalo 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 intervalo de caracteres somente leitura que contém o caminho pelo qual obter informações do diretório raiz.

Retornos

ReadOnlySpan<Char>

Um intervalo de caracteres somente leitura que contém o diretório raiz de path.

Comentários

Esse método não verifica se o caminho ou arquivo existe.

Ao contrário da sobrecarga de cadeia de caracteres, esse método não normaliza separadores de diretório.

Um ReadOnlySpan<System.Char> será "efetivamente vazio" se:

• No Windows, chamar ReadOnlySpan<T>.IsEmpty nesse intervalo de caracteres retorna trueou todos os seus caracteres são espaços (' ').
• No Unix, chamar ReadOnlySpan<T>.IsEmpty nesse intervalo de caracteres retorna true.

Os padrões possíveis para o intervalo de caracteres somente leitura retornado por esse método são os seguintes:

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

• ReadOnlySpan<T>.Empty (path especificou um caminho relativo na unidade ou volume atual).

• "/" (Unix: path especificou um caminho absoluto na unidade atual).

• "X:" (Windows: path especificou um caminho relativo em uma unidade, em que X representa uma letra de unidade ou volume).

• "X:\" (Windows: path especificou um caminho absoluto em uma determinada unidade).

• "\\ComputerName\SharedFolder" (Windows: um caminho UNC).

• "\\?\C:" (Windows: um caminho do dispositivo DOS, com suporte no .NET Core 1.1 e versões posteriores e em .NET Framework 4.6.2 e versões posteriores).

Para obter mais informações sobre caminhos de arquivo no Windows, consulte Formatos de caminho de arquivo em sistemas Windows. Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

• Formatos de caminho de arquivo em sistemas Windows