Path.GetFullPath (Método)
Ensamblado: mscorlib (en mscorlib.dll)
| Tipo de excepción | Condición |
|---|---|
| path es una cadena de longitud cero, contiene sólo espacios en blanco o contiene uno o varios caracteres no válidos de los que se definen en InvalidPathChars, o contiene un carácter comodín. O bien, El sistema no pudo recuperar la ruta de acceso absoluta. |
|
| El llamador no tiene los permisos requeridos. |
|
| path es referencia de objeto null (Nothing en Visual Basic). |
|
| path contiene un carácter de dos puntos (":"). |
|
| La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, las rutas de acceso deben ser inferiores a 248 caracteres y los nombres de archivo deben ser inferiores a 260 caracteres. |
.NET Framework no admite el acceso directo a discos físicos a través de rutas de acceso que sean nombres de dispositivo, como "\\.\UNIDADFÍSICA0 ".
La ruta de acceso absoluta incluye toda la información necesaria para buscar un archivo o directorio en un sistema.
No es necesario que el archivo o directorio especificado por path exista. Por ejemplo, si el directorio actual es c:\temp\newdir, al llamar a GetFullPath en un nombre de archivo como test.txt, se devuelve c:\temp\newdir\test.txt. No es necesario que exista el archivo.
Sin embargo, si path existe, el llamador debe tener permiso para obtener información de ruta de acceso para path. Observe que, a diferencia de la mayoría de los miembros de la clase Path, este método tiene acceso al sistema de archivos.
Este método utiliza la información del directorio y el volumen actuales para completar path. Si se especifica sólo un nombre de archivo en path, GetFullPath devolverá la ruta de acceso completa del directorio actual.
Si pasa un nombre de archivo corto, no se expandirá en un nombre de archivo largo.
Una ruta de acceso no es válida si no contiene caracteres significativos, excepto en el caso de que contenga uno o varios caracteres "." seguidos de cualquier número de espacios; en tal caso, se analizará como "." o "..".
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 | |
| Escribir en un archivo de texto. | |
| Leer de un archivo de texto. | |
| Recuperar una extensión de archivo | |
| Recuperar sólo el nombre de archivo de una ruta de acceso | |
| Recuperar sólo el nombre de directorio de una ruta de acceso | |
| Cambiar la extensión de un archivo | |
| Ordenar por tamaño los archivos de un directorio | |
| Determinar si un directorio existe | |
| Determinar si un archivo existe |
En el ejemplo de código siguiente se muestra el uso del método GetFullPath en una plataforma de escritorio basada en Windows.
string fileName = "myfile.ext"; string path1 = @"mydir"; string path2 = @"\mydir"; string fullPath; fullPath = Path.GetFullPath(path1); Console.WriteLine("GetFullPath('{0}') returns '{1}'", path1, fullPath); fullPath = Path.GetFullPath(fileName); Console.WriteLine("GetFullPath('{0}') returns '{1}'", fileName, fullPath); fullPath = Path.GetFullPath(path2); Console.WriteLine("GetFullPath('{0}') returns '{1}'", path2, fullPath); // Output is based on your current directory, except // in the last case, where it is based on the root drive // GetFullPath('mydir') returns 'C:\temp\Demo\mydir' // GetFullPath('myfile.ext') returns 'C:\temp\Demo\myfile.ext' // GetFullPath('\mydir') returns 'C:\mydir'
String fileName = "myfile.ext";
String path = "\\mydir\\";
String fullPath;
fullPath = Path.GetFullPath(path);
Console.WriteLine("GetFullPath('{0}') returns '{1}'",
path, fullPath);
fullPath = Path.GetFullPath(fileName);
Console.WriteLine("GetFullPath('{0}') returns '{1}'",
fileName, fullPath);
var fileName : String = "myfile.ext"; var path : String = "\\mydir\\"; var fullPath : String; fullPath = Path.GetFullPath(path); Console.WriteLine("GetFullPath('{0}') returns '{1}'", path, fullPath); fullPath = Path.GetFullPath(fileName); Console.WriteLine("GetFullPath('{0}') returns '{1}'", fileName, fullPath);
- FileIOPermission para tener acceso a la ruta de acceso. Enumeración asociada: FileIOPermissionAccess.PathDiscovery.
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.