Path.GetPathRoot Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Sobrecargas

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

Una cadena que contiene la ruta de acceso de la que se obtiene información del directorio raíz.

Devoluciones

String

El directorio raíz de path si está en la raíz.

o bien

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

o bien

null si path es null o está vacío de forma efectiva.

Excepciones

ArgumentException

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

o bien

Solo para .NET Framework: Empty se ha pasado 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:\'

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, la llamada a IsEmpty en esta cadena devuelve trueo todos sus caracteres son espacios (" ).
• En Unix, la llamada 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 se 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 de acceso UNC).

• "\\?\C:" (Windows: una ruta de acceso de dispositivo DOS, compatible con .NET Core 1.1 y versiones posteriores, 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 las tareas de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

• Formatos de ruta de acceso de archivo en los 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>

Un intervalo de caracteres de solo lectura que contiene la ruta de acceso desde la que se va a obtener información del directorio raíz.

Devoluciones

ReadOnlySpan<Char>

Un intervalo de solo lectura de caracteres 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> elemento está "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 se 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 de acceso UNC).

• "\\?\C:" (Windows: una ruta de acceso de dispositivo DOS, compatible con .NET Core 1.1 y versiones posteriores, 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 las tareas de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

• Formatos de ruta de acceso de archivo en los sistemas Windows