Path.IsPathFullyQualified Metoda

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca wartość wskazującą, czy ścieżka pliku jest w pełni kwalifikowana.

Przeciążenia

Nazwa	Opis
IsPathFullyQualified(String)	Zwraca wartość wskazującą, czy określona ścieżka pliku jest stała dla określonego dysku, czy ścieżki UNC.
IsPathFullyQualified(ReadOnlySpan<Char>)	Zwraca wartość wskazującą, czy ścieżka pliku reprezentowana przez określony zakres znaków jest stała dla określonego dysku lub ścieżki UNC.

Uwagi

Przeciążenia IsPathFullyQualified ścieżek metody, które używają znaków DirectorySeparatorChar i AltDirectorySeparatorChar . Nie wykonuje żadnej walidacji na ścieżce, która jest przekazywana do niej jako argument. W rezultacie identyfikatory URI są interpretowane jako ścieżki względne i zwracają wartość false.

Istnieje różnica między w pełni kwalifikowaną ścieżką (wskazaną przez IsPathFullyQualified metodę) i ścieżką rooted (wskazaną przez metodę IsPathRooted ). W pełni kwalifikowana ścieżka lub ścieżka bezwzględna zawsze definiuje dokładną ścieżkę z określonego dysku lub urządzenia do pliku docelowego lub katalogu i nie zależy od bieżącego dysku lub bieżącego katalogu. Na przykład w systemach Windows C:/users/user1/documents/reports/2019/january/highlights.pdf definiuje ścieżkę bezwzględną z katalogu głównego dysku C: do pliku docelowego, highlights.pdf. Ścieżka rooted określa dysk początkowy lub katalog główny, ale zależy od bieżącego katalogu (jeśli jest zakorzeniony przez określony dysk) lub bieżącego dysku (jeśli jest zakorzeniony przez katalog główny). Poniższy przykład ilustruje różnicę między w pełni kwalifikowanymi ścieżkami i ścieżkami rooted.

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)

Zwraca wartość wskazującą, czy określona ścieżka pliku jest stała dla określonego dysku, czy ścieżki UNC.

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

Parametry

path: String

Ścieżka pliku.

Zwraca

Boolean

true jeśli ścieżka jest stała do określonego dysku lub ścieżki UNC; false jeśli ścieżka jest względna względem bieżącego dysku lub katalogu roboczego.

Wyjątki

ArgumentNullException

Parametr path ma wartość null.

Uwagi

Ta metoda obsługuje ścieżki używające separatora katalogu alternatywnego. Częstym błędem jest założenie, że ścieżki rooted (IsPathRooted(String)) nie są względne. Na przykład wartość "C:a" jest względna, czyli jest rozpoznawana względem bieżącego katalogu dla języka C: (rooted, ale względne). "C:\a" jest zakorzeniony, a nie względny, czyli bieżący katalog nie jest używany do modyfikowania ścieżki.

Zobacz też

formaty ścieżek File w systemach Windows

Dotyczy

IsPathFullyQualified(ReadOnlySpan<Char>)

Zwraca wartość wskazującą, czy ścieżka pliku reprezentowana przez określony zakres znaków jest stała dla określonego dysku lub ścieżki UNC.

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