Path.GetFileName Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Sobrecargas

GetFileName(ReadOnlySpan<Char>)	Devuelve el nombre de archivo y la extensión de una ruta de acceso de archivo que se representa mediante 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>)

Source:

Path.cs

Devuelve el nombre de archivo y la extensión de una ruta de acceso de archivo que se representa mediante 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>

Un intervalo de solo lectura que contiene la ruta de acceso de la cual se obtiene el nombre de archivo y la extensión.

Devoluciones

ReadOnlySpan<Char>

Caracteres que siguen al ú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

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

GetFileName(String)

Source:

Path.cs

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 de la cual se obtiene el nombre de archivo y la extensión.

Devoluciones

String

Caracteres que siguen al último carácter separador de directorio en path. Si el último carácter de path es un carácter separador de directorios o volúmenes, 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 GetFileName método 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 ''

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 la ejecución en plataformas basadas en Unix no puede devolver correctamente el nombre de archivo desde una ruta de acceso basada en Windows como C:\mydir\myfile.ext, pero GetFileName ejecutarse 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 que el comportamiento del GetFileName método no es estrictamente el mismo en plataformas basadas en Unix y basadas en Windows.

Para obtener una lista de 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