Path.GetPathRoot Método

Definición

Espacio de nombres:

System.IO

Ensamblados:

netstandard.dll, System.Runtime.dll

Sobrecargas

Nombre	Description
GetPathRoot(String)	Obtiene la información del directorio raíz de la ruta de acceso contenida en la cadena especificada.
GetPathRoot(ReadOnlySpan<Char>)	Obtiene la información del directorio raíz de la ruta de acceso contenida en el intervalo de caracteres especificado.

GetPathRoot(String)

Source:

Path.Unix.cs

Obtiene la información del directorio raíz de la ruta de acceso contenida en la cadena especificada.

public:
 static System::String ^ GetPathRoot(System::String ^ path);

public static string? GetPathRoot(string? path);

static member GetPathRoot : string -> string

Public Shared Function GetPathRoot (path As String) As String

Parámetros

path

String

Cadena que contiene la ruta de acceso desde la que se va a obtener información del directorio raíz.

Devoluciones

String

Directorio raíz de path si está raíz.

O bien

Empty si path no contiene información del directorio raíz.

O bien

null si path está null o está vacío de forma eficaz.

Excepciones

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a la 2.1: path contiene uno o varios de los caracteres no válidos definidos en GetInvalidPathChars().

O bien

Solo .NET Framework: Empty se pasó a path.

Ejemplos

En el ejemplo siguiente se muestra un uso del GetPathRoot método .

string path = @"\mydir\";
string fileName = "myfile.ext";
string fullPath = @"C:\mydir\myfile.ext";
string pathRoot;

pathRoot = Path.GetPathRoot(path);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    path, pathRoot);

pathRoot = Path.GetPathRoot(fileName);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    fileName, pathRoot);

pathRoot = Path.GetPathRoot(fullPath);
Console.WriteLine("GetPathRoot('{0}') returns '{1}'",
    fullPath, pathRoot);

// This code produces output similar to the following:
//
// GetPathRoot('\mydir\') returns '\'
// GetPathRoot('myfile.ext') returns ''
// GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

Dim pathname As String = "\mydir\"
Dim fileName As String = "myfile.ext"
Dim fullPath As String = "C:\mydir\myfile.ext"
Dim pathnameRoot As String

pathnameRoot = Path.GetPathRoot(pathname)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", pathname, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fileName)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fileName, pathnameRoot)

pathnameRoot = Path.GetPathRoot(fullPath)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fullPath, pathnameRoot)

' This code produces output similar to the following:
'
' GetPathRoot('\mydir\') returns '\'
' GetPathRoot('myfile.ext') returns ''
' GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

Comentarios

Este método no comprueba que exista la ruta de acceso o el archivo.

Este método normalizará los separadores de directorio.

Una cadena está "vacía eficazmente" si:

• En Windows, llamar a IsEmpty en esta cadena devuelve trueo todos sus caracteres son espacios (" ).
• En Unix, llamar a IsNullOrEmpty en esta cadena devuelve true.

Los patrones posibles para la cadena devuelta por este método son los siguientes:

• null (path era null o una cadena vacía).

• Cadena vacía (path se especificó una ruta de acceso relativa en la unidad o volumen actual).

• "/" (Unix: path especificó una ruta de acceso absoluta en la unidad actual).

• "X:" (Windows: path especificó una ruta de acceso relativa en una unidad, donde X representa una unidad o letra de volumen).

• "X:\" (Windows: path especificó una ruta de acceso absoluta en una unidad determinada).

• "\\NombreDeEquipo\SharedFolder" (Windows: una ruta UNC).

• "\\?\C:" (Windows: una ruta de acceso del dispositivo DOS, compatible con versiones de .NET y en .NET Framework 4.6.2 y versiones posteriores).

Para obtener más información sobre las rutas de acceso de archivo en Windows, consulte Formatos de ruta de acceso de archivo en sistemas Windows. Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

• Formatos de ruta de acceso de archivo en sistemas Windows
• E/S de archivos y secuencias
• Cómo: Leer texto de un archivo
• Cómo: Escribir texto en un archivo

GetPathRoot(ReadOnlySpan<Char>)

Source:

Path.Unix.cs

Obtiene la información del directorio raíz de la ruta de acceso contenida en el intervalo de caracteres especificado.

public:
 static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);

public static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);

static member GetPathRoot : ReadOnlySpan<char> -> ReadOnlySpan<char>

Public Shared Function GetPathRoot (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Parámetros

path

ReadOnlySpan<Char>

Intervalo de caracteres de solo lectura que contiene la ruta de acceso desde la que obtener información del directorio raíz.

Devoluciones

ReadOnlySpan<Char>

Intervalo de caracteres de solo lectura que contiene el directorio raíz de path.

Comentarios

Este método no comprueba que exista la ruta de acceso o el archivo.

A diferencia de la sobrecarga de cadena, este método no normaliza los separadores de directorios.

Un ReadOnlySpan<System.Char> valor es "vacío eficazmente" si:

• En Windows, llamar a ReadOnlySpan<T>.IsEmpty en este intervalo de caracteres devuelve trueo todos sus caracteres son espacios (" ).
• En Unix, llamar a ReadOnlySpan<T>.IsEmpty en este intervalo de caracteres devuelve true.

Los patrones posibles para el intervalo de caracteres de solo lectura devuelto por este método son los siguientes:

• ReadOnlySpan<T>.Empty (path era ReadOnlySpan<T>.Empty.

• ReadOnlySpan<T>.Empty (path especificó una ruta de acceso relativa en la unidad o volumen actual).

• "/" (Unix: path especificó una ruta de acceso absoluta en la unidad actual).

• "X:" (Windows: path especificó una ruta de acceso relativa en una unidad, donde X representa una unidad o letra de volumen).

• "X:\" (Windows: path especificó una ruta de acceso absoluta en una unidad determinada).

• "\\NombreDeEquipo\SharedFolder" (Windows: una ruta UNC).

• "\\?\C:" (Windows: una ruta de acceso del dispositivo DOS, compatible con versiones de .NET y en .NET Framework 4.6.2 y versiones posteriores).

Para obtener más información sobre las rutas de acceso de archivo en Windows, consulte Formatos de ruta de acceso de archivo en sistemas Windows. Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

• Formatos de ruta de acceso de archivo en sistemas Windows