Path.GetDirectoryName Método

Definición

Espacio de nombres:
System.IO
Ensamblados:
mscorlib.dll, System.Runtime.Extensions.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Runtime.Extensions.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Sobrecargas

Nombre Description
GetDirectoryName(String)

Devuelve la información del directorio de la ruta de acceso especificada.
GetDirectoryName(ReadOnlySpan<Char>)

Devuelve la información del directorio de la ruta de acceso especificada representada por un intervalo de caracteres.

GetDirectoryName(String)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

Devuelve la información del directorio de la ruta de acceso especificada.

public:
 static System::String ^ GetDirectoryName(System::String ^ path);
public static string GetDirectoryName(string path);
public static string? GetDirectoryName(string? path);
static member GetDirectoryName : string -> string
Public Shared Function GetDirectoryName (path As String) As String

Parámetros

path
String

Ruta de acceso de un archivo o directorio.

Devoluciones

String

Información de directorio para path, o null si path indica un directorio raíz o es null. Devuelve Empty si path no contiene información de directorio.

Excepciones

ArgumentException

.NET Framework y versiones de .NET Core anteriores a la 2.1: el parámetro />

PathTooLongException

El path parámetro es mayor que la longitud máxima definida por el sistema.

Ejemplos

En el ejemplo siguiente se muestra el uso del método GetDirectoryName en una plataforma de escritorio basada en Windows.

string? filePath = @"C:\MyDir\MySubDir\myfile.ext";
string? directoryName;
int i = 0;

while (filePath != null)
{
    directoryName = Path.GetDirectoryName(filePath);
    Console.WriteLine($"GetDirectoryName(\"{filePath}\") returns {directoryName ?? "NULL"}");

    filePath = (i == 1)
        ? directoryName + @"\"  // this will preserve the previous path
        : directoryName;

    i++;
}
/*
This code produces the following output:

GetDirectoryName("C:\MyDir\MySubDir\myfile.ext") returns C:\MyDir\MySubDir
GetDirectoryName("C:\MyDir\MySubDir") returns C:\MyDir
GetDirectoryName("C:\MyDir\") returns C:\MyDir
GetDirectoryName("C:\MyDir") returns C:\
GetDirectoryName("C:\") returns NULL
*/

Dim filepath As String = "C:\MyDir\MySubDir\myfile.ext"
Dim directoryName As String
Dim i As Integer = 0

While filepath <> Nothing
    directoryName = Path.GetDirectoryName(filepath)
    Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", _
        filepath, directoryName)
    filepath = directoryName
    If i = 1 Then
       filepath = directoryName + "\"  ' this will preserve the previous path
    End If
    i = i + 1
End While

'This code produces the following output:
'
' GetDirectoryName('C:\MyDir\MySubDir\myfile.ext') returns 'C:\MyDir\MySubDir'
' GetDirectoryName('C:\MyDir\MySubDir') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir\') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir') returns 'C:\'
' GetDirectoryName('C:\') returns ''

Comentarios

En la mayoría de los casos, la cadena devuelta por este método consta de todos los caracteres de la ruta de acceso, pero no incluidos, los últimos caracteres separadores de directorio. Un carácter separador de directorio puede ser DirectorySeparatorChar o AltDirectorySeparatorChar. Si la ruta de acceso consta de un directorio raíz, como "c:\", null se devuelve.

Este método no admite rutas de acceso mediante "file:".

Dado que la ruta de acceso devuelta no incluye los últimos caracteres separadores de directorios, al pasar la ruta de acceso devuelta al GetDirectoryName método se trunca un nivel de carpeta por llamada posterior en la ruta de acceso del resultado. Por ejemplo, pasar la ruta de acceso "C:\Directory\SubDirectory\test.txt" en GetDirectoryName devuelve "C:\Directory\SubDirectory". Pasar esa ruta de acceso, "C:\Directory\SubDirectory", en GetDirectoryName devuelve "C:\Directory".

Para obtener una lista de las tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

GetDirectoryName(ReadOnlySpan<Char>)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs

Devuelve la información del directorio de la ruta de acceso especificada representada por un intervalo de caracteres.

public:
 static ReadOnlySpan<char> GetDirectoryName(ReadOnlySpan<char> path);
public static ReadOnlySpan<char> GetDirectoryName(ReadOnlySpan<char> path);
static member GetDirectoryName : ReadOnlySpan<char> -> ReadOnlySpan<char>
Public Shared Function GetDirectoryName (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Parámetros

path
ReadOnlySpan<Char>

Ruta de acceso de la que se va a recuperar la información del directorio.

Devoluciones

ReadOnlySpan<Char>

Información de directorio para path, o un intervalo vacío si path es null, un intervalo vacío o una raíz (como \, C:o \\server\share).

Comentarios

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

Consulte también

Se aplica a