Path.IsPathFullyQualified Método

Definição

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

Sobrecargas

Nome Description
IsPathFullyQualified(String)

Retorna um valor que indica se o caminho do arquivo especificado é fixo para uma unidade específica ou caminho UNC.

IsPathFullyQualified(ReadOnlySpan<Char>)

Retorna um valor que indica se o caminho do arquivo representado pelo intervalo de caracteres especificado é fixo para uma unidade específica ou caminho UNC.

Comentários

As sobrecargas do método manipulam caminhos IsPathFullyQualified que usam os caracteres e os AltDirectorySeparatorCharDirectorySeparatorChar caracteres. Ele não executa nenhuma validação no caminho que é passado para ele como um argumento. Como resultado, as URIs são interpretadas 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 ele estiver enraizado por uma unidade especificada) ou da unidade atual (se estiver com raiz no 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(String)

Retorna um valor que indica se o caminho do arquivo especificado é fixo para uma unidade específica ou caminho 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

Parâmetros

path
String

Um caminho de arquivo.

Retornos

true se o caminho for fixo para uma unidade específica ou caminho UNC; false se o caminho for relativo à unidade atual ou ao diretório de trabalho.

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 enraizados (IsPathRooted(String)) não são relativos. Por exemplo, "C:a" é relativo à unidade, ou seja, é resolvido em relação ao 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

IsPathFullyQualified(ReadOnlySpan<Char>)

Retorna um valor que indica se o caminho do arquivo representado pelo intervalo de caracteres especificado é fixo para uma unidade específica ou caminho 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

Parâmetros

path
ReadOnlySpan<Char>

Um caminho de arquivo.

Retornos

true se o caminho for fixo para uma unidade específica ou caminho UNC; false se o caminho for relativo à unidade atual ou ao diretório de trabalho.

Confira também

Aplica-se a