Path.IsPathFullyQualified Methode

  • Referenz

Definition

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.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 Methode behandeln Pfade, die sowohl die IsPathFullyQualified Zeichen als auch DirectorySeparatorChar die AltDirectorySeparatorChar Zeichen verwenden. Es führt keine Überprüfung auf dem Pfad aus, der an ihn als Argument übergeben wird. Daher werden URIs als relative Pfade interpretiert und zurückgegeben false.

Es gibt einen Unterschied zwischen einem vollqualifizierten Pfad (wie durch die Methode angegeben) und einem Wurzelpfad (wie durch die IsPathFullyQualified IsPathRooted Methode angegeben). Ein vollqualifizierter Pfad oder absoluter Pfad definiert immer einen exakten 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. Windows Beispielsweise definiert C:/users/users/documents/reports/2019/januar/highlights.pdf einen absoluten Pfad vom Stamm der C: Laufwerk zur Zieldatei, highlights.pdf. Ein Stammpfad gibt entweder ein Startlaufwerk oder ein Stammverzeichnis an, hängt jedoch entweder vom aktuellen Verzeichnis (wenn er von einem angegebenen Laufwerk wurzelt) oder dem aktuellen Laufwerk (wenn es durch das Stammverzeichnis gewurzelt ist). Im folgenden Beispiel wird der Unterschied zwischen vollqualifizierten Pfaden und wurzelten 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(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.

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.

Siehe auch

Gilt für:

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

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 behandelt Pfade, die das alternative Verzeichnistrennzeichen verwenden. Es ist ein häufiger Fehler, davon auszugehen, dass wurzelige Pfade (IsPathRooted(String)) nicht relativ sind. Beispielsweise ist "C:a" relativ, d. h., es wird gegen das aktuelle Verzeichnis für C aufgelöst: (wurzelt, aber relativ). "C:\a" ist wurzelt und nicht relativ, d. h. das aktuelle Verzeichnis wird nicht zum Ändern des Pfads verwendet.

Siehe auch

Gilt für: