Path.IsPathRooted Метод

Определение

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

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Возвращает значение, показывающее, содержит ли путь к файлу корневую папку.

Перегрузки

IsPathRooted(String)	Возвращает значение, показывающее, содержит ли указанная строка пути корневую папку.
IsPathRooted(ReadOnlySpan<Char>)	Возвращает значение, которое показывает, содержит ли указанный диапазон символов, являющийся путем к файлу, корневую папку.

Комментарии

Корневой путь — это путь к файлу, который фиксируется на определенном диске или UNC-пути; он отличается от пути, который находится относительно текущего диска или рабочего каталога. Например, в системах Windows путь с корнем начинается с обратной косой черты (например, "\Documents") или буквы диска и двоеточия (например, "C:Documents").

Обратите внимание, что корневые пути могут быть либо абсолютными (то есть полными), либо относительными. Абсолютный путь с корнем — это полный путь от корня диска к определенному каталогу. Относительный корневой путь указывает диск, но его полный путь разрешается в текущем каталоге. В следующем примере демонстрируется это различие.

C#

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string relative1 = "C:Documents"; 
        ShowPathInfo(relative1);

        string relative2 = "/Documents";
        ShowPathInfo(relative2);

        string absolute = "C:/Documents";
        ShowPathInfo(absolute);
    }

    private static void ShowPathInfo(string path)
    {
        Console.WriteLine($"Path: {path}");
        Console.WriteLine($"   Rooted: {Path.IsPathRooted(path)}");
        Console.WriteLine($"   Fully qualified: {Path.IsPathFullyQualified(path)}");
        Console.WriteLine($"   Full path: {Path.GetFullPath(path)}");
        Console.WriteLine();
    }
}
// The example displays the following output when run on a Windows system:
//    Path: C:Documents
//        Rooted: True
//        Fully qualified: False
//        Full path: c:\Users\user1\Documents\projects\path\ispathrooted\Documents
//
//    Path: /Documents
//       Rooted: True
//       Fully qualified: False
//       Full path: c:\Documents
//
//    Path: C:/Documents
//       Rooted: True
//       Fully qualified: True
//       Full path: C:\Documents

IsPathRooted(String)

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

Path.Unix.cs

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

C#

public static bool IsPathRooted(string? path);

Параметры

path

String

Проверяемый путь.

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

Boolean

Значение true, если параметр path содержит корневую папку; в противном случае — значение false.

Исключения

ArgumentException

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

Примеры

В следующем примере показано, как IsPathRooted можно использовать метод для проверки трех строк.

C#

string fileName = @"C:\mydir\myfile.ext";
string UncPath = @"\\myPc\mydir\myfile";
string relativePath = @"mydir\sudir\";
bool result;

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

result = Path.IsPathRooted(UncPath);
Console.WriteLine("IsPathRooted('{0}') returns {1}",
    UncPath, result);

result = Path.IsPathRooted(relativePath);
Console.WriteLine("IsPathRooted('{0}') returns {1}",
    relativePath, result);

// This code produces output similar to the following:
//
// IsPathRooted('C:\mydir\myfile.ext') returns True
// IsPathRooted('\\myPc\mydir\myfile') returns True
// IsPathRooted('mydir\sudir\') returns False

Комментарии

Метод IsPathRooted возвращает значение true , если первый символ является символом разделителя каталога, например "\", или если путь начинается с буквы диска и двоеточия (:). Например, он возвращает для truepath таких строк, как "\MyDir\MyFile.txt", "C:\MyDir" или "C:MyDir". Возвращается false для path таких строк, как "MyDir".

Этот метод не проверяет, существует ли путь или имя файла.

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

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

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

IsPathRooted(ReadOnlySpan<Char>)

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

Path.Unix.cs

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

C#

public static bool IsPathRooted(ReadOnlySpan<char> path);

Параметры

path

ReadOnlySpan<Char>

Проверяемый путь.

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

Boolean

Значение true, если параметр path содержит корневую папку; в противном случае — значение false.

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

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