HOWTO · Csharp
Obtener el nombre de archivo de la ruta en C#
Este artículo presenta cómo extraer el nombre de archivo de una ruta determinada en C#. Incluye el método GetFileName().
En esta página
Para obtener el último componente de una ruta del sistema de archivos en C#, use Path.GetFileName de System.IO. Devuelve el nombre del archivo junto con su extensión, así que no hace falta dividir la ruta manualmente. El método extrae texto de una cadena de ruta; no abre ni comprueba el archivo.
Use Path.GetFileName para obtener el componente final de la ruta
Pase la cadena de ruta a Path.GetFileName. El resultado es el componente final después del separador de directorios que reconoce el sistema operativo actual. Si la ruta termina en summary.csv, el nombre devuelto es summary.csv.
Ejecute este ejemplo:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
using System;
using System.IO;
class Program
{
static void Main()
{
string path = "reports/2026/summary.csv";
string fileName = Path.GetFileName(path);
Console.WriteLine(fileName);
}
}
summary.csv
Este programa escribe el nombre extraído en la consola. El código es autónomo y usa una ruta separada por barras, que se reconoce como separador de directorios en las plataformas .NET habituales. El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
Manejar rutas absolutas, relativas y específicas de cada plataforma
El método funciona tanto con rutas absolutas como relativas del sistema de archivos. Una ruta absoluta incluye su ubicación desde una raíz o unidad; una ruta relativa se interpreta desde el directorio de trabajo de la aplicación. Path.GetFileName no resuelve ninguna de las dos rutas en el sistema de archivos: solo devuelve el componente final de la cadena proporcionada.
El tratamiento de los separadores sigue las reglas de Path específicas de cada plataforma. Una ruta separada por barras, como reports/summary.csv, funciona en sistemas tipo Unix y en Windows. Una ruta de Windows separada por barras invertidas, como C:\Reports\summary.csv, se interpreta como se espera en Windows. En sistemas tipo Unix, la barra invertida es un carácter ordinario, así que al pasar allí una ruta con formato de Windows podría devolverse la cadena completa en lugar de solo summary.csv. Si una aplicación procesa rutas creadas para otro sistema operativo, tenga en cuenta ese formato de forma explícita en vez de suponer que la plataforma anfitriona lo interpretará del mismo modo.
Obtener el nombre del archivo sin su extensión
Si quien llama al método necesita summary en lugar de summary.csv, use Path.GetFileNameWithoutExtension. Combina la extracción del componente final con la eliminación de la extensión final. Por ejemplo, si se le pasa reports/summary.csv en una plataforma que reconoce / como separador, devuelve summary.
Use esta API cuando la extensión no forme parte del valor que necesita mostrar o comparar. Si necesita la extensión por separado, Path.GetExtension la devuelve con el punto inicial incluido. Estos métodos operan sobre el texto de la ruta y no determinan si existe un archivo.
Distinguir las rutas de archivo de las URL y de la validación de archivos
Una URL no es necesariamente una ruta del sistema de archivos. Puede contener un esquema, un host, una consulta o un fragmento, y los segmentos de ruta de una URL siguen las reglas de las URL. No pase una URL a Path.GetFileName como sustituto del análisis de URL; si la entrada es una URL, use un analizador de URI y luego trate cualquier nombre decodificado según las necesidades de la aplicación.
Extraer un nombre tampoco valida una ruta, demuestra que sea seguro usarla ni comprueba que exista un archivo. Son tareas distintas. Use las API adecuadas de validación de rutas y del sistema de archivos para cada operación, y aplique las reglas de seguridad de la aplicación antes de abrir o crear archivos. Para la tarea más específica de obtener el último componente de una cadena de ruta del sistema de archivos, Path.GetFileName es la API directa.