Path.IsPathFullyQualified Methode

Definition

Gibt einen Wert zurück, der angibt, ob ein Dateipfad vollständig qualifiziert ist.

Überlädt

Name Beschreibung
IsPathFullyQualified(String)

Gibt einen Wert zurück, der angibt, ob der angegebene Dateipfad auf ein bestimmtes Laufwerk oder einen UNC-Pfad festgelegt ist.

IsPathFullyQualified(ReadOnlySpan<Char>)

Gibt einen Wert zurück, der angibt, ob der durch die angegebene Zeichenspanne dargestellte Dateipfad auf einen bestimmten Laufwerks- oder UNC-Pfad festgelegt ist.

Hinweise

Die Überladungen der IsPathFullyQualified Methoden behandeln Pfade, die sowohl die DirectorySeparatorChar Zeichen als auch die AltDirectorySeparatorChar Zeichen verwenden. Es führt keine Überprüfung des Pfads durch, der als Argument an ihn übergeben wird. Daher werden URIs als relative Pfade interpretiert und zurückgegeben false.

Es gibt einen Unterschied zwischen einem vollqualifizierten Pfad (wie durch die IsPathFullyQualified Methode angegeben) und einem root-Pfad (wie durch die IsPathRooted Methode angegeben). Ein vollqualifizierter Pfad oder absoluter Pfad definiert immer einen genauen Pfad von einem bestimmten Laufwerk oder Gerät zu einer Zieldatei oder einem Verzeichnis und hängt nicht vom aktuellen Laufwerk oder dem aktuellen Verzeichnis ab. In Windows Systemen definiert C:/users/user1/documents/reports/2019/january/highlights.pdf einen absoluten Pfad vom Stammverzeichnis des Laufwerks C: zur Zieldatei, highlights.pdf. Ein Stammpfad gibt entweder ein Startlaufwerk oder ein Stammverzeichnis an, hängt jedoch entweder vom aktuellen Verzeichnis (sofern es durch ein angegebenes Laufwerk gestammt ist) oder vom aktuellen Laufwerk (wenn es durch das Stammverzeichnis stammet) ab. Im folgenden Beispiel wird der Unterschied zwischen vollqualifizierten Pfaden und gewurzelten Pfaden veranschaulicht.

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

IsPathFullyQualified(String)

Gibt einen Wert zurück, der angibt, ob der angegebene Dateipfad auf ein bestimmtes Laufwerk oder einen UNC-Pfad festgelegt ist.

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

Parameter

path
String

Ein Dateipfad.

Gibt zurück

true wenn der Pfad auf ein bestimmtes Laufwerk oder einen UNC-Pfad festgelegt ist; false wenn der Pfad relativ zum aktuellen Laufwerk oder Arbeitsverzeichnis ist.

Ausnahmen

path ist null.

Hinweise

Diese Methode behandelt Pfade, die das alternative Verzeichnistrennzeichen verwenden. Es ist ein häufiger Fehler, davon auszugehen, dass stammige Pfade (IsPathRooted(String)) nicht relativ sind. Beispielsweise ist "C:a" relativ, d. h. es wird gegen das aktuelle Verzeichnis für C aufgelöst (root, aber relativ). "C:\a" ist root und nicht relativ, d. h. das aktuelle Verzeichnis wird nicht zum Ändern des Pfads verwendet.

Weitere Informationen

Gilt für:

IsPathFullyQualified(ReadOnlySpan<Char>)

Gibt einen Wert zurück, der angibt, ob der durch die angegebene Zeichenspanne dargestellte Dateipfad auf einen bestimmten Laufwerks- oder UNC-Pfad festgelegt ist.

public:
 static bool IsPathFullyQualified(ReadOnlySpan<char> path);
public static bool IsPathFullyQualified(ReadOnlySpan<char> path);
static member IsPathFullyQualified : ReadOnlySpan<char> -> bool
Public Shared Function IsPathFullyQualified (path As ReadOnlySpan(Of Char)) As Boolean

Parameter

path
ReadOnlySpan<Char>

Ein Dateipfad.

Gibt zurück

true wenn der Pfad auf ein bestimmtes Laufwerk oder einen UNC-Pfad festgelegt ist; false wenn der Pfad relativ zum aktuellen Laufwerk oder Arbeitsverzeichnis ist.

Weitere Informationen

Gilt für: