Este tema aún no ha recibido ninguna valoración - Valorar este tema

Path.GetFileName (Método)

.NET Framework 2.0

Otras versiones

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

Espacio de nombres: System.IO
Ensamblado: mscorlib (en mscorlib.dll)

Sintaxis

C++

Copiar

public static string GetFileName (
	string path
)

Copiar

public static String GetFileName (
	String path
)

JScript

Copiar

public static function GetFileName (
	path : String
) : String

Parámetros

path: Cadena de ruta de acceso de la cual se obtiene el nombre de archivo y la extensión.

Valor devuelto

String que consta de los caracteres que siguen al último carácter 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 el valor de path es referencia de objeto null (Nothing en Visual Basic), este método devuelve referencia de objeto null (Nothing en Visual Basic).

Excepciones

Tipo de excepción	Condición
ArgumentException	path contiene uno o varios caracteres no válidos de los definidos en InvalidPathChars o contiene un carácter comodín.

Comentarios

El valor devuelto es referencia de objeto null (Nothing en Visual Basic) si la ruta de acceso del archivo es referencia de objeto null (Nothing en Visual Basic).

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

Para obtener un ejemplo de cómo utilizar este método, vea la sección Ejemplo que figura a continuación. En la siguiente tabla se muestran ejemplos de otras tareas de E/S típicas o relacionadas.

Para realizar esta operación...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto.	Cómo: Escribir texto en un archivo
Leer de un archivo de texto.	Cómo: Leer texto de un archivo
Recuperar la ruta de acceso completa de un archivo	GetFullPath
Recuperar sólo el nombre de archivo de una ruta de acceso	GetFileNameWithoutExtension
Recuperar sólo el nombre de directorio de una ruta de acceso	GetDirectoryName
Cambiar la extensión de un archivo	ChangeExtension

Ejemplo

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

C++

Copiar

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 ''

Copiar

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);

JScript

Copiar

var fileName : String = "C:\\mydir\\myfile.ext";
var path : String = "C:\\mydir\\";
var result : String;

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

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

Plataformas

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión