Path.IsPathFullyQualified Método

Definición

Devuelve un valor que indica si una ruta de acceso de archivo es un nombre completo.

Sobrecargas

IsPathFullyQualified(ReadOnlySpan<Char>)

Devuelve un valor que indica si la ruta de acceso de archivo representada por el intervalo de caracteres especificado está fija en una unidad específica o una ruta de acceso UNC.

IsPathFullyQualified(String)

Devuelve un valor que indica si la ruta de acceso de archivo especificada está fija en una unidad específica o una ruta de acceso UNC.

Comentarios

Las sobrecargas del IsPathFullyQualified método controlan las rutas de acceso que usan los DirectorySeparatorChar caracteres y AltDirectorySeparatorChar . No realiza ninguna validación en la ruta de acceso que se le pasa como argumento. Como resultado, los URI se interpretan como rutas de acceso relativas y devuelven false.

Hay una diferencia entre una ruta de acceso completa (como se indica en el IsPathFullyQualified método) y una ruta de acceso rootada (como se indica en el IsPathRooted método ). Una ruta de acceso completa o una ruta de acceso absoluta siempre define una ruta exacta de una unidad o dispositivo determinada a un archivo o directorio de destino, y no depende de la unidad actual o del directorio actual. Por ejemplo, en los sistemas Windows, C:/users/user1/documents/reports/2019/january/highlights.pdf define una ruta de acceso absoluta desde la raíz de la unidad C: al archivo de destino, highlights.pdf. Una ruta de acceso raíz especifica una unidad inicial o un directorio raíz, pero depende del directorio actual (si está raíz por una unidad especificada) o de la unidad actual (si está raíz por el directorio raíz). En el ejemplo siguiente se muestra la diferencia entre las rutas de acceso completas y las rutas de acceso con raíz.

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

Devuelve un valor que indica si la ruta de acceso de archivo representada por el intervalo de caracteres especificado está fija en una unidad específica o una ruta de acceso 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>

Una ruta de acceso de archivo.

Devoluciones

true si la ruta de acceso se ha fijado a una unidad específica o ruta de acceso UNC; false si la ruta de acceso es relativa a la unidad actual o el directorio de trabajo.

Consulte también

Se aplica a

IsPathFullyQualified(String)

Devuelve un valor que indica si la ruta de acceso de archivo especificada está fija en una unidad específica o una ruta de acceso 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

Una ruta de acceso de archivo.

Devoluciones

true si la ruta de acceso se ha fijado a una unidad específica o ruta de acceso UNC; false si la ruta de acceso es relativa a la unidad actual o el directorio de trabajo.

Excepciones

path es null.

Comentarios

Este método controla las rutas de acceso que usan el separador de directorios alternativo. Es un error frecuente suponer que las rutas de acceso raíz (IsPathRooted(String)) no son relativas. Por ejemplo, "C:a" es relativa a la unidad, es decir, se resuelve en el directorio actual para C: (rooteado, pero relativo). "C:\a" tiene raíz y no es relativo, es decir, el directorio actual no se usa para modificar la ruta de acceso.

Consulte también

Se aplica a