Path.GetPathRoot Метод

Определение

Пространство имен:

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Перегрузки

Имя	Описание
GetPathRoot(String)	Возвращает сведения о корневом каталоге из пути, содержащегося в указанной строке.
GetPathRoot(ReadOnlySpan<Char>)	Возвращает данные корневого каталога из пути, содержащегося в указанном диапазоне символов.

GetPathRoot(String)

Исходный код:

Path.Unix.cs

Возвращает сведения о корневом каталоге из пути, содержащегося в указанной строке.

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

Параметры

path

String

Строка, содержащая путь, из которого необходимо получить сведения о корневом каталоге.

Возвращаемое значение

String

Корневой каталог, path если он коренится.

–или–

Empty Значение , если path не содержит сведения о корневом каталоге.

–или–

Значение , если это или является фактически пустым.

Исключения

ArgumentException

Версии .NET Framework и .NET Core старше 2.1: path содержат один или несколько недопустимых символов, определенных в GetInvalidPathChars().

–или–

Только платформа .NET Framework: Empty передана в path.

Примеры

В следующем примере показано использование GetPathRoot метода.

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

Комментарии

Этот метод не проверяет наличие пути или файла.

Этот метод нормализует разделители каталогов.

Строка "эффективно пуста", если:

• В Windows вызов IsEmpty этой строки возвращается trueили все его символы — пробелы (').
• В Unix вызов IsNullOrEmpty этой строки возвращается true.

Возможные шаблоны для строки, возвращаемой этим методом, следующим образом:

• null (path значение NULL или пустая строка).

• Пустая строка (path указан относительный путь на текущем диске или томе).

• "/" (Unix: path указан абсолютный путь на текущем диске).

• "X:" (Windows: path указан относительный путь на диске, где X представляет диск или букву тома).

• "X:\" (Windows: path указан абсолютный путь на заданном диске).

• "\\ComputerName\SharedFolder" (Windows: UNC-путь).

• "\\?\C:" (Windows: путь к устройству DOS, поддерживаемый в версиях .NET и в .NET Framework 4.6.2 и более поздних версиях).

Дополнительные сведения о путях к файлам в Windows см. в форматах пути к файлам в системах Windows. Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Форматы пути к файлам в системах Windows
• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

GetPathRoot(ReadOnlySpan<Char>)

Исходный код:

Path.Unix.cs

Возвращает данные корневого каталога из пути, содержащегося в указанном диапазоне символов.

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)

Параметры

path

ReadOnlySpan<Char>

Диапазон символов, доступных только для чтения, содержащий путь, из которого необходимо получить сведения о корневом каталоге.

Возвращаемое значение

ReadOnlySpan<Char>

Диапазон символов, доступных только для чтения, содержащий корневой каталог path.

Комментарии

Этот метод не проверяет наличие пути или файла.

В отличие от строковой перегрузки этот метод не нормализует разделители каталогов.

Значение ReadOnlySpan<System.Char> "эффективно пусто", если:

• В Windows вызов ReadOnlySpan<T>.IsEmpty этого диапазона символов возвращается trueили все его символы — пробелы (').
• В Unix вызов ReadOnlySpan<T>.IsEmpty этого диапазона символов возвращается true.

Возможные шаблоны диапазона символов только для чтения, возвращаемые этим методом, следующим образом:

• ReadOnlySpan<T>.Empty (path был ReadOnlySpan<T>.Empty.

• ReadOnlySpan<T>.Empty (path указан относительный путь на текущем диске или томе).

• "/" (Unix: path указан абсолютный путь на текущем диске).

• "X:" (Windows: path указан относительный путь на диске, где X представляет диск или букву тома).

• "X:\" (Windows: path указан абсолютный путь на заданном диске).

• "\\ComputerName\SharedFolder" (Windows: UNC-путь).

• "\\?\C:" (Windows: путь к устройству DOS, поддерживаемый в версиях .NET и в .NET Framework 4.6.2 и более поздних версиях).

Дополнительные сведения о путях к файлам в Windows см. в форматах пути к файлам в системах Windows. Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Форматы пути к файлам в системах Windows