Path.IsPathFullyQualified Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Gibt einen Wert zurück, der angibt, ob ein Dateipfad vollqualifiziert ist.

Überlädt

IsPathFullyQualified(ReadOnlySpan<Char>)	Gibt einen Wert zurück, der angibt, ob der durch die angegebene Zeichenspanne dargestellte Dateipfad auf ein bestimmtes Laufwerk oder einen UNC-Pfad festgelegt ist.
IsPathFullyQualified(String)	Gibt einen Wert zurück, der angibt, ob der angegebene Dateipfad auf ein bestimmtes Laufwerk oder einen UNC-Pfad festgelegt ist.

Hinweise

Die Überladungen der IsPathFullyQualified -Methode behandeln Pfade, die sowohl die DirectorySeparatorChar Zeichen als auch die AltDirectorySeparatorChar Zeichen verwenden. Es führt keine Überprüfung für den Pfad aus, der als Argument an ihn übergeben wird. Daher werden URIs als relative Pfade interpretiert und geben zurück 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 oderabsoluter Pfad definiert immer einen exakten Pfad von einem bestimmten Laufwerk oder Gerät zu einer Zieldatei oder einem Zielverzeichnis und hängt nicht vom aktuellen Laufwerk oder aktuellen Verzeichnis ab. Auf Windows-Systemen definiert beispielsweise C:/users/user1/documents/reports/2019/january/highlights.pdf einen absoluten Pfad vom Stamm des Laufwerks C: zur Zieldatei ,highlights.pdf. Ein Rootpfad gibt entweder ein Startlaufwerk oder ein Stammverzeichnis an, hängt jedoch entweder vom aktuellen Verzeichnis (wenn es von einem angegebenen Laufwerk gerootet wird) oder vom aktuellen Laufwerk (wenn es vom Stammverzeichnis gerootet wird). Das folgende Beispiel veranschaulicht den Unterschied zwischen vollqualifizierten Pfaden und Rootpfaden.

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(ReadOnlySpan<Char>)

Quelle:

Path.cs

Gibt einen Wert zurück, der angibt, ob der durch die angegebene Zeichenspanne dargestellte Dateipfad auf ein bestimmtes Laufwerk oder einen 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

Boolean

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

Weitere Informationen

• Formate von Dateipfaden unter Windows-Systemen

IsPathFullyQualified(String)

Quelle:

Path.cs

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

Boolean

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

Ausnahmen

ArgumentNullException

path ist null.

Hinweise

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

Weitere Informationen

• Formate von Dateipfaden unter Windows-Systemen