Path.IsPathFullyQualified Método

Definição

Retorna um valor que indica se um caminho de arquivo é totalmente qualificado.

Sobrecargas

IsPathFullyQualified(ReadOnlySpan<Char>)

Retorna um valor que indica se o caminho de arquivo representado pelo intervalo de caracteres especificado está fixo em uma unidade ou um caminho UNC específico.

IsPathFullyQualified(String)

Retorna um valor que indica se o caminho de arquivo especificado está fixo em uma unidade ou um caminho UNC específico.

Comentários

As sobrecargas do método manipulam caminhos IsPathFullyQualified que usam os DirectorySeparatorChar caracteres e AltDirectorySeparatorChar . Ele não executa nenhuma validação no caminho que é passado para ele como um argumento. Como resultado, os URIs são interpretados como caminhos relativos e retornam false.

Há uma diferença entre um caminho totalmente qualificado (conforme indicado pelo IsPathFullyQualified método) e um caminho com raiz (conforme indicado pelo IsPathRooted método ). Um caminho totalmente qualificado ou um caminho absoluto sempre define um caminho exato de uma unidade ou dispositivo específico para um arquivo ou diretório de destino e não depende da unidade atual ou do diretório atual. Por exemplo, em sistemas Windows, C:/users/user1/documents/reports/2019/january/highlights.pdf define um caminho absoluto da raiz da unidade C: para o arquivo de destino, highlights.pdf. Um caminho com raiz especifica uma unidade inicial ou um diretório raiz, mas depende do diretório atual (se estiver com raiz por uma unidade especificada) ou da unidade atual (se estiver raiz pelo diretório raiz). O exemplo a seguir ilustra a diferença entre caminhos totalmente qualificados e caminhos com raiz.

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>)

Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs

Retorna um valor que indica se o caminho de arquivo representado pelo intervalo de caracteres especificado está fixo em uma unidade ou um caminho UNC específico.

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

Parâmetros

path
ReadOnlySpan<Char>

Um caminho de arquivo.

Retornos

true se o caminho está fixo em uma unidade ou um caminho UNC específico; false se o caminho é relativo à unidade ou ao diretório de trabalho atual.

Confira também

Aplica-se a

IsPathFullyQualified(String)

Origem:
Path.cs
Origem:
Path.cs
Origem:
Path.cs

Retorna um valor que indica se o caminho de arquivo especificado está fixo em uma unidade ou um caminho UNC específico.

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

Parâmetros

path
String

Um caminho de arquivo.

Retornos

true se o caminho está fixo em uma unidade ou um caminho UNC específico; false se o caminho é relativo à unidade ou ao diretório de trabalho atual.

Exceções

path é null.

Comentários

Esse método manipula caminhos que usam o separador de diretório alternativo. É um erro frequente assumir que caminhos com raiz (IsPathRooted(String)) não são relativos. Por exemplo, "C:a" é relativo à unidade, ou seja, é resolvido no diretório atual para C: (raiz, mas relativo). "C:\a" tem raiz e não é relativo, ou seja, o diretório atual não é usado para modificar o caminho.

Confira também

Aplica-se a