Path (Clase)

.NET Framework no admite el acceso directo a discos físicos a través de rutas de acceso que sean nombres de dispositivo, como "\\. \PHYSICALDRIVE0 ".

Una ruta de acceso es una cadena que proporciona la ubicación de un archivo o directorio. Una ruta de acceso no apunta necesariamente a una ubicación de disco; por ejemplo, una ruta de acceso puede asignarse a una ubicación en la memoria o en un dispositivo. El formato exacto de una ruta de acceso está determinado por la plataforma actual. Por ejemplo, en algunos sistemas, una ruta de acceso puede empezar por una letra de unidad o de volumen, mientras que este elemento está ausente en otros sistemas. En algunos sistemas, las rutas de acceso a archivos pueden contener extensiones, que indican el tipo de información almacenada en el archivo. El formato de la extensión del nombre de un archivo depende de la plataforma; por ejemplo, algunos sistemas limitan las extensiones a tres caracteres y otros no lo hacen así. La plataforma actual determina también el conjunto de caracteres utilizado para separar los elementos de una ruta de acceso y el conjunto de caracteres que no se pueden utilizar al especificar rutas. Debido a estas diferencias, los campos de la clase Path, así como el comportamiento exacto de algunos miembros de la clase Path, dependen de la plataforma.

Una ruta de acceso puede contener información de ubicación absoluta o relativa. Las rutas absolutas especifican por completo una ubicación: el archivo o directorio puede identificarse de forma única independientemente de la ubicación actual. Las rutas de acceso relativas especifican una ubicación parcial: la ubicación actual se utiliza como punto de inicio cuando se busca un archivo especificado mediante una ruta de acceso relativa. Para determinar el directorio actual, llame a Directory.GetCurrentDirectory.

La mayoría de los miembros de la clase Path no interactúan con el sistema de archivos y no comprueban la existencia del archivo especificado por una cadena de la ruta de acceso. Los miembros de clase Path que modifican una cadena de la ruta de acceso, como ChangeExtension, no tienen ningún efecto en los nombres de archivos del sistema de archivos. Los miembros dePath , sin embargo, validan el contenido de una cadena de ruta especificada, y producen una excepción ArgumentException si la cadena contiene caracteres que no son válidos en cadenas de ruta, según los caracteres devueltos por el método GetInvalidPathChars . Por ejemplo, en plataformas de escritorio basados en Windows, los caracteres no válidos de ruta de acceso podrían incluir signos como comillas ("), menor que (<), mayor que (>), barra vertical (|), retroceso (\b), nulo (\0) y caracteres Unicode del 16 al 18 y del 20 al 25.

Los miembros de la clase Path permiten ejecutar de forma rápida y sencilla operaciones comunes tales como determinar si una extensión de nombre de archivo forma parte de la ruta de acceso y combinar dos cadenas en un nombre de ruta.

Todos los miembros de la clase Path son estáticos y, por lo tanto, pueden recibir llamadas sin tener una instancia de una ruta de acceso.

Nota

En los miembros que aceptan una ruta como cadena de entrada, la ruta debe ser correcta o, de lo contrario, se produce una excepción. Por ejemplo, si se trata de una ruta completa pero que empieza por un espacio, la ruta no se recorta en los métodos de la clase. En consecuencia, la ruta está mal construida y se produce una excepción. De forma similar, una combinación de rutas de acceso no puede completarse dos veces. Por ejemplo, "c:\temp c:\windows" produce también una excepción en la mayoría de los casos. Asegúrese de que las rutas de acceso estén bien construidas cuando utilice métodos que acepten una cadena de ruta de acceso.

En los miembros que aceptan una ruta de acceso, esta ruta puede hacer referencia a un archivo o solo a un directorio. La ruta especificada puede hacer referencia también a una ruta relativa o a una ruta de convención de nomenclatura universal (Universal Naming Convention, UNC) de un servidor y un nombre de recurso compartido. Por ejemplo, las siguientes rutas de acceso son todas válidas:

• "c:\\MiDir\\MiArchivo.txt" en C# o "c:\MiDir\MiArchivo.txt" en Visual Basic.

• "c:\\MiDir" en C# o "c:\MiDir" en Visual Basic.

• "MiDir\\MiSubdir" en C# o "MiDir\MiSubDir" en Visual Basic.

• "\\\\MiServidor\\MiRecursoComp" en C# o "\\MiServidor\MiRecursoComp" en Visual Basic.

Dado que todas estas operaciones se ejecutan sobre cadenas, no es posible comprobar que los resultados son válidos para todos los escenarios. Por ejemplo, el método GetExtension analiza una cadena que se le pasa y devuelve la extensión de la cadena. Sin embargo, esto no significa que exista en el disco un archivo con tal extensión.

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

En el ejemplo de código siguiente se muestran algunos de los miembros principales de la clase Path.

using System;
using System.IO;

class Test 
{
	
    public static void Main() 
    {
        string path1 = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp\MyTest";
        string path3 = @"temp";

        if (Path.HasExtension(path1)) 
        {
            Console.WriteLine("{0} has an extension.", path1);
        }

        if (!Path.HasExtension(path2)) 
        {
            Console.WriteLine("{0} has no extension.", path2);
        }

        if (!Path.IsPathRooted(path3)) 
        {
            Console.WriteLine("The string {0} contains no root information.", path3);
        }

        Console.WriteLine("The full path of {0} is {1}.", path3, Path.GetFullPath(path3));
        Console.WriteLine("{0} is the location for temporary files.", Path.GetTempPath());
        Console.WriteLine("{0} is a file available for use.", Path.GetTempFileName());

        /* This code produces output similar to the following:
         * c:\temp\MyTest.txt has an extension.
         * c:\temp\MyTest has no extension.
         * The string temp contains no root information.
         * The full path of temp is D:\Documents and Settings\cliffc\My Documents\Visual Studio 2005\Projects\ConsoleApplication2\ConsoleApplication2\bin\Debug\temp.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\ is the location for temporary files.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\tmp3D.tmp is a file available for use.
         */
    }
}

.NET Framework

.NET Framework Client Profile

.NET para aplicaciones de la Tienda Windows

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

Referencia

Otros recursos