Path.GetFileName Método

Definición

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

Sobrecargas

Nombre Description
GetFileName(ReadOnlySpan<Char>)

Devuelve el nombre de archivo y la extensión de una ruta de acceso de archivo representada por un intervalo de caracteres de solo lectura.
GetFileName(String)

Devuelve el nombre de archivo y la extensión de la cadena de ruta de acceso especificada.

GetFileName(ReadOnlySpan<Char>)

Devuelve el nombre de archivo y la extensión de una ruta de acceso de archivo representada por un intervalo de caracteres de solo lectura.

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

Parámetros

path
ReadOnlySpan<Char>

Intervalo de solo lectura que contiene la ruta de acceso desde la que obtener el nombre de archivo y la extensión.

Devoluciones

ReadOnlySpan<Char>

Caracteres después del último carácter separador de directorio en path.

Comentarios

El intervalo de solo lectura devuelto contiene los caracteres de la ruta de acceso que siguen al último separador de path. Si el último carácter de path es un carácter separador de volumen o directorio, el método devuelve ReadOnlySpan<T>.Empty. Si path no contiene ningún carácter separador, el método devuelve path.

Consulte también

Se aplica a

GetFileName(String)

Devuelve el nombre de archivo y la extensión de la cadena de ruta de acceso especificada.

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

Parámetros

path
String

Cadena de ruta de acceso desde la que se va a obtener el nombre de archivo y la extensión.

Devoluciones

String

Caracteres después del último carácter separador de directorio en path. Si el último carácter de es un carácter separador de path directorio o volumen, este método devuelve Empty. Si path es null, este método devuelve null.

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

Ejemplos

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

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

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

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

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

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

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

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

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

Comentarios

El valor devuelto es null si la ruta de acceso del archivo es null.

Los caracteres separadores usados para determinar el inicio del nombre de archivo son DirectorySeparatorChar y AltDirectorySeparatorChar.

Dado que \ es un nombre de archivo legal en Unix, GetFileName que se ejecuta en plataformas basadas en Unix no puede devolver correctamente el nombre de archivo de una ruta de acceso basada en Windows, como C:\mydir\myfile.ext, pero GetFileName que se ejecuta en plataformas basadas en Windows puede devolver correctamente el nombre de archivo desde una ruta de acceso basada en Unix, como /tmp/myfile.ext, por lo tanto, el comportamiento del método GetFileName no es estrictamente el mismo en plataformas basadas en Unix y basadas en Windows.

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

Consulte también

Se aplica a