Path.IsPathRooted Metod

Definition

Returnerar ett värde som anger om en filsökväg innehåller en rot.

Överlagringar

Name Description
IsPathRooted(String)

Returnerar ett värde som anger om den angivna sökvägssträngen innehåller en rot.

IsPathRooted(ReadOnlySpan<Char>)

Returnerar ett värde som anger om det angivna teckenintervallet som representerar en filsökväg innehåller en rot.

Kommentarer

En rotad sökväg är en filsökväg som är fast på en specifik enhet eller UNC-sökväg. den står i kontrast till en sökväg som är relativ till den aktuella enheten eller arbetskatalogen. I Windows system börjar till exempel en rotad sökväg med ett omvänt snedstreck (till exempel "\Documents") eller en enhetsbeteckning och kolon (till exempel "C:Documents").

Observera att rotade sökvägar kan vara antingen absoluta (dvs. fullständigt kvalificerade) eller relativa. En absolut rotad sökväg är en fullständigt kvalificerad sökväg från roten på en enhet till en specifik katalog. En relativ rotad sökväg anger en enhet, men dess fullständigt kvalificerade sökväg matchas mot den aktuella katalogen. I följande exempel visas skillnaden.

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)

Källa:
Path.Unix.cs
Källa:
Path.Unix.cs
Källa:
Path.Unix.cs
Källa:
Path.Unix.cs
Källa:
Path.Unix.cs

Returnerar ett värde som anger om den angivna sökvägssträngen innehåller en rot.

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

Parametrar

path
String

Sökvägen att testa.

Returer

trueom path innehåller en rot, annars . false

Undantag

.NET Framework- och .NET Core-versioner som är äldre än 2.1: path innehåller ett eller flera av de ogiltiga tecken som definierats i GetInvalidPathChars().

Exempel

I följande exempel visas hur IsPathRooted metoden kan användas för att testa tre strängar.

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

Kommentarer

Metoden IsPathRooted returnerar true om det första tecknet är ett katalogavgränsartecken, till exempel "\", eller om sökvägen börjar med en enhetsbeteckning och ett kolon (:). Den returnerar true till exempel för path strängar som "\\MyDir\MyFile.txt", "C:\MyDir" eller "C:MyDir". Den returnerar false för path strängar som "MyDir".

Den här metoden verifierar inte att sökvägen eller filnamnet finns.

En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Se även

Gäller för

IsPathRooted(ReadOnlySpan<Char>)

Källa:
Path.Unix.cs
Källa:
Path.Unix.cs
Källa:
Path.Unix.cs
Källa:
Path.Unix.cs
Källa:
Path.Unix.cs

Returnerar ett värde som anger om det angivna teckenintervallet som representerar en filsökväg innehåller en rot.

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

Parametrar

path
ReadOnlySpan<Char>

Sökvägen att testa.

Returer

trueom path innehåller en rot, annars . false

Se även

Gäller för