Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Path

 

Publicado: octubre de 2016

Ejecuta operaciones en instancias de String que contienen información de rutas de acceso de archivos o directorios. Estas operaciones se ejecutan de forma adecuada para múltiples plataformas.

Para examinar el código fuente de .NET Framework para este tipo, vea la Reference Source.

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


[ComVisibleAttribute(true)]
public static class Path

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticChangeExtension(String, String)

Cambia la extensión de una cadena de ruta de acceso.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String)

Combina dos cadenas en una ruta de acceso.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String, String)

Combina tres cadenas en una ruta de acceso.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String, String, String, String)

Combina cuatro cadenas en una ruta de acceso.

System_CAPS_pubmethodSystem_CAPS_staticCombine(String[])

Combina una matriz de cadenas en una ruta de acceso.

System_CAPS_pubmethodSystem_CAPS_staticGetDirectoryName(String)

Devuelve la información de directorio para la cadena de ruta de acceso especificada.

System_CAPS_pubmethodSystem_CAPS_staticGetExtension(String)

Devuelve la extensión de la cadena de ruta de acceso especificada.

System_CAPS_pubmethodSystem_CAPS_staticGetFileName(String)

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

System_CAPS_pubmethodSystem_CAPS_staticGetFileNameWithoutExtension(String)

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

System_CAPS_pubmethodSystem_CAPS_staticGetFullPath(String)

Devuelve la ruta de acceso absoluta para la cadena de ruta de acceso especificada.

System_CAPS_pubmethodSystem_CAPS_staticGetInvalidFileNameChars()

Obtiene una matriz que contiene los caracteres no permitidos en los nombres de archivo.

System_CAPS_pubmethodSystem_CAPS_staticGetInvalidPathChars()

Obtiene una matriz que contiene los caracteres no permitidos en los nombres de ruta de acceso.

System_CAPS_pubmethodSystem_CAPS_staticGetPathRoot(String)

Obtiene información del directorio raíz de la ruta de acceso especificada.

System_CAPS_pubmethodSystem_CAPS_staticGetRandomFileName()

Devuelve un nombre de carpeta o de archivo aleatorio.

System_CAPS_pubmethodSystem_CAPS_staticGetTempFileName()

Crea un archivo temporal de cero bytes y nombre único en el disco y devuelve la ruta de acceso completa a ese archivo.

System_CAPS_pubmethodSystem_CAPS_staticGetTempPath()

Devuelve la ruta de acceso de la carpeta temporal del usuario actual.

System_CAPS_pubmethodSystem_CAPS_staticHasExtension(String)

Determina si una ruta de acceso incluye una extensión de nombre de archivo.

System_CAPS_pubmethodSystem_CAPS_staticIsPathRooted(String)

Obtiene un valor que indica si la cadena de ruta de acceso especificada contiene una raíz.

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticAltDirectorySeparatorChar

Proporciona un carácter alternativo específico de la plataforma, que se utiliza para separar niveles de directorios en una cadena de ruta de acceso que refleja una organización jerárquica del sistema de archivos.

System_CAPS_pubfieldSystem_CAPS_staticDirectorySeparatorChar

Proporciona un carácter específico de la plataforma, que se utiliza para separar niveles de directorios en una cadena de ruta de acceso que refleja una organización jerárquica del sistema de archivos.

System_CAPS_pubfieldSystem_CAPS_staticInvalidPathChars

Obsoleto. Proporciona una matriz de caracteres, específica de la plataforma, que no pueden especificarse en argumentos de cadena de ruta de acceso que se pasen a miembros de la clase Path.

System_CAPS_pubfieldSystem_CAPS_staticPathSeparator

Carácter separador específico de la plataforma que se utiliza para separar cadenas de ruta de acceso en variables de entorno.

System_CAPS_pubfieldSystem_CAPS_staticVolumeSeparatorChar

Proporciona un carácter separador de volúmenes específico de la plataforma.

System_CAPS_noteNota

Para ver el código fuente de .NET Framework para este tipo, consulte el Reference Source. Puede examinar el código fuente en línea, descargue la referencia para verla sin conexión y recorrer (incluidas las revisiones y actualizaciones) durante la depuración; see instructions.

.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, podría asignar una ruta de acceso a una ubicación en 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 iniciar con una letra de unidad o volumen, mientras que este elemento no está presente en otros sistemas. En algunos sistemas, las rutas de acceso de archivo pueden contener extensiones, que indican el tipo de información almacenada en el archivo. El formato de una extensión de nombre de archivo es dependiente de la plataforma; Por ejemplo, algunos sistemas limitan las extensiones a tres caracteres y otros no. La plataforma actual determina también el juego de caracteres utilizado para separar los elementos de una ruta de acceso y el conjunto de caracteres que no se puede usar al especificar las rutas de acceso. Debido a estas diferencias, los campos de la Path clase, así como el comportamiento exacto de algunos miembros de la Path clase dependen de la plataforma.

Una ruta de acceso puede contener información de ubicación absoluta o relativa. Rutas de acceso absolutas totalmente especifican una ubicación: el archivo o directorio puede identificarse de forma única independientemente de la ubicación actual. Rutas de acceso relativas especifican una ubicación parcial: la ubicación actual se usa como punto de partida al buscar un archivo especificado con una ruta de acceso relativa. Para determinar el directorio actual, llame a Directory.GetCurrentDirectory.

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

Los miembros de la Path clase permiten rápida y fácilmente realizar operaciones comunes, como determinar si una extensión de nombre de archivo es parte de una ruta de acceso y combinar dos cadenas en un nombre de ruta.

Todos los miembros de la Path clase son estática y, por tanto, se puede llamar sin tener una instancia de una ruta de acceso.

System_CAPS_noteNota

En los miembros que aceptan una ruta de acceso como una cadena de entrada, esa ruta de acceso debe ser correcto o se produce una excepción. Por ejemplo, si una ruta de acceso está completa pero comienza con un espacio, la ruta no se recorta en los métodos de la clase. Por lo tanto, la ruta de acceso es incorrecto y se produce una excepción. De forma similar, una ruta de acceso o una combinación de rutas de acceso no puede completarse dos veces. Por ejemplo, "c:\temp c:\windows" también genera una excepción en la mayoría de los casos. Asegúrese de que las rutas de acceso sean correctos cuando se utilizan los métodos que aceptan una cadena de ruta de acceso.

En los miembros que aceptan una ruta de acceso, la ruta de acceso puede hacer referencia a un archivo o solo a un directorio. La ruta de acceso especificada puede hacer referencia a una ruta de acceso relativa o una ruta de acceso de convención de nomenclatura Universal (UNC) para un nombre de servidor y recurso compartido. Por ejemplo, todos los requisitos siguientes son las rutas de acceso aceptables:

  • "c:\\MyDir\\MyFile.txt" en C# o "c:\MyDir\MyFile.txt" en Visual Basic.

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

  • "Midir\\misubdir" en C# o "Midir\misubdir" en Visual Basic.

  • "\\\MyServer\\MyShare" en C#, o "\\MyServer\MyShare" en Visual Basic.

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

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

El ejemplo de código siguiente muestra algunos de los miembros principales de la Path clase.

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.
         */
    }
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: