Path.IsPathRooted Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Vrátí hodnotu, která určuje, zda cesta k souboru obsahuje kořen.

Přetížení

Name	Description
IsPathRooted(String)	Vrátí hodnotu určující, zda zadaný řetězec cesty obsahuje kořen.
IsPathRooted(ReadOnlySpan<Char>)	Vrátí hodnotu, která určuje, zda zadané rozsahy znaků představující cestu k souboru obsahuje kořen.

Poznámky

Kořenová cesta je cesta k souboru, která je pevná pro konkrétní jednotku nebo cestu UNC; kontrastuje s cestou, která je relativní vzhledem k aktuální jednotce nebo pracovnímu adresáři. Například v systémech Windows začíná kořenová cesta zpětné lomítko (například \Documents) nebo písmeno jednotky a dvojtečka (například C:Documents).

Všimněte si, že kořenové cesty můžou být absolutní (tj. plně kvalifikované) nebo relativní. Absolutní kořenová cesta je plně kvalifikovaná cesta z kořenového adresáře jednotky do konkrétního adresáře. Relativní kořenová cesta určuje jednotku, ale její plně kvalifikovaná cesta se přeloží vůči aktuálnímu adresáři. Následující příklad znázorňuje rozdíl.

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

Imports System.IO

Module Program
    Public Sub Main()
        Dim relative1 As String = "C:Documents" 
        ShowPathInfo(relative1)

        Dim relative2 As String = "C:Documents" 
        ShowPathInfo(relative2)

        Dim absolute As String = "C:/Documents"
        ShowPathInfo(absolute)
    End Sub

    Private Sub ShowPathInfo(filepath As String)
        Console.WriteLine($"Path: {filepath}")
        Console.WriteLine($"   Rooted: {Path.IsPathRooted(filepath)}")
        Console.WriteLine($"   Fully qualified: {Path.IsPathFullyQualified(filepath)}")
        Console.WriteLine($"   Full path: {Path.GetFullPath(filepath)}")
        Console.WriteLine()
    End Sub
End Module
' 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)

Zdroj:

Path.Unix.cs

Vrátí hodnotu určující, zda zadaný řetězec cesty obsahuje kořen.

public:
 static bool IsPathRooted(System::String ^ path);

public static bool IsPathRooted(string? path);

static member IsPathRooted : string -> bool

Public Shared Function IsPathRooted (path As String) As Boolean

Parametry

path

String

Cesta k otestování.

Návraty

Boolean

true obsahuje-li path kořen; jinak , false.

Výjimky

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path obsahuje jeden nebo více neplatných znaků definovaných v GetInvalidPathChars().

Příklady

Následující příklad ukazuje, jak lze metodu IsPathRooted použít k otestování tří řetězců.

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

Dim fileName As String = "C:\mydir\myfile.ext"
Dim UncPath As String = "\\myPc\mydir\myfile"
Dim relativePath As String = "mydir\sudir\"
Dim result As Boolean

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

Poznámky

Metoda IsPathRooted vrátí true , pokud je prvním znakem znak oddělovače adresáře, například \, nebo pokud cesta začíná písmenem jednotky a dvojtečka (:). Například se vrátí true pro path řetězce, jako je "\\MyDir\MyFile.txt", "C:\MyDir" nebo "C:MyDir". false Vrátí se pro path řetězce, jako je například "MyDir".

Tato metoda neověřuje, zda cesta nebo název souboru existuje.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

• formáty cest Soubory v systémech Windows
• Vstup/výstup souborů a streamů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

IsPathRooted(ReadOnlySpan<Char>)

Zdroj:

Path.Unix.cs

Vrátí hodnotu, která určuje, zda zadané rozsahy znaků představující cestu k souboru obsahuje kořen.

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

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

static member IsPathRooted : ReadOnlySpan<char> -> bool

Public Shared Function IsPathRooted (path As ReadOnlySpan(Of Char)) As Boolean

Parametry

path

ReadOnlySpan<Char>

Cesta k otestování.

Návraty

Boolean

true obsahuje-li path kořen; jinak , false.

Viz také

• formáty cest Soubory v systémech Windows