Path.IsPathFullyQualified Método

Definição

Devolve um valor que indica se o caminho do ficheiro está totalmente qualificado.

Sobrecargas

Name Description
IsPathFullyQualified(ReadOnlySpan<Char>)

Devolve um valor que indica se o caminho do ficheiro representado pelo intervalo de caracteres especificado está fixo para uma unidade específica ou caminho UNC.

IsPathFullyQualified(String)

Devolve um valor que indica se o caminho do ficheiro especificado está fixo para uma unidade específica ou para o caminho UNC.

Observações

As sobrecargas do IsPathFullyQualified método tratam caminhos que usam tanto os caracteres como DirectorySeparatorChar os AltDirectorySeparatorChar caracteres. Não realiza qualquer validação do caminho que lhe é passado como argumento. Como resultado, os URIs são interpretados como caminhos relativos e retornam false.

Existe uma diferença entre um caminho totalmente qualificado (conforme indicado pelo IsPathFullyQualified método) e um caminho enraizado (conforme indicado pelo IsPathRooted método). Um caminho totalmente qualificado ou caminho absoluto define sempre um caminho exato de um determinado disco ou dispositivo para um ficheiro ou diretório de destino, e não depende do disco ou diretório atual. Por exemplo, em sistemas Windows, C:/users/user1/documents/reports/2019/january/highlights.pdf define um caminho absoluto desde a raiz do disco C: até ao ficheiro de destino, highlights.pdf. Um caminho enraizado especifica ou um disco inicial ou diretório raiz, mas depende do diretório atual (se estiver enraizado por um disco especificado) ou do disco atual (se estiver enraizado pelo diretório raiz). O exemplo seguinte ilustra a diferença entre caminhos totalmente qualificados e caminhos enraizados.

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
Origem:
Path.cs
Origem:
Path.cs

Devolve um valor que indica se o caminho do ficheiro representado pelo intervalo de caracteres especificado está 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 ficheiro.

Devoluções

true se o caminho for fixo para um determinado disco ou caminho UNC; false se o caminho for relativo ao disco atual ou diretório de trabalho.

Ver também

Aplica-se a

IsPathFullyQualified(String)

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

Devolve um valor que indica se o caminho do ficheiro especificado está fixo para uma unidade específica ou para o 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 ficheiro.

Devoluções

true se o caminho for fixo para um determinado disco ou caminho UNC; false se o caminho for relativo ao disco atual ou diretório de trabalho.

Exceções

path é null.

Observações

Este método lida com caminhos que utilizam o separador alternativo de diretórios. É um erro frequente assumir que os caminhos enraizados (IsPathRooted(String)) não são relativos. Por exemplo, "C:a" é relativo ao disco, ou seja, está resolvido contra o diretório atual para C: (rootado, mas relativo). "C:\a" é enraizado e não relativo, ou seja, o diretório atual não é usado para modificar o caminho.

Ver também

Aplica-se a