Path Classe

The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Um caminho é uma Cadeia de Caracteres que fornece o local de um arquivo ou diretório.Um caminho não necessariamente apontar para um local no disco; Por exemplo, um caminho pode mapear para um local na memória ou em um dispositivo.O formato exato de um caminho é determinado pela plataforma atual.Por exemplo, em alguns sistemas, um caminho pode iniciar com uma Carta de unidade ou volume, enquanto esse elemento não estiver presente em outros sistemas.Em alguns sistemas, caminhos de arquivo podem conter extensões, que indicam o tipo de informação armazenada no arquivo.O formato da extensão do nome de um arquivo é dependente da plataforma; Por exemplo, alguns sistemas limitam extensões de três caracteres e outros não.A plataforma atual também determina o conjunto de caracteres usado para separar os elementos de um caminho e o conjunto de caracteres que não podem ser usados quando especificar caminhos.Because of these differences, the fields of the Path class as well as the exact behavior of some members of the Path class are platform-dependent.

Um caminho pode conter informações de local absoluto ou relativo.Caminhos absolutos totalmente especificar um local: o arquivo ou diretório pode ser identificado com exclusividade, independentemente do local atual.Os caminhos relativos especificar um local parcial: o local atual é usado como ponto de partida quando localizar um arquivo especificado com um caminho relativo.To determine the current directory, call Directory.GetCurrentDirectory.

Most members of the Path class do not interact with the file system and do not verify the existence of the file specified by a path string. Path class members that modify a path string, such as ChangeExtension, have no effect on names of files in the file system.Membros da Path, no entanto, validam o conteúdo de uma string do caminho especificado e lançam uma ArgumentException se a string contém caracteres que não são válidos em strings de caminho, conforme definido no InvalidPathChars.Por exemplo, em plataformas de área de trabalho baseados no Windows, caracteres de caminho inválido podem incluir aspas ("), Menor que (<),maiorque(>), de pipe (|), BACKSPACE (\b), nulo (\0) e caracteres Unicode 18 até 16 e 20 a 25.

The members of the Path class enable you to quickly and easily perform common operations such as determining whether a file name extension is part of a path, and combining two strings into one path name.

All members of the Path class are static and can therefore be called without having an instance of a path.

Observação:

Em membros que aceitem um caminho como uma Cadeia de Caracteres de entrada, esse caminho deve ser bem formado ou é levantada uma exceção.Por exemplo, se um caminho é totalmente qualificado, mas começa com um espaço, o caminho não for aparado nos métodos da classe.Portanto, o caminho está malformado e é levantada uma exceção.Da mesma forma, um caminho ou uma combinação dos caminhos não pode ser totalmente qualificada duas vezes.Por exemplo, "c:\temp c:\windows" também gera uma exceção na maioria dos casos.Certifique-se de que seu caminhos estejam bem-formados quando usando métodos que aceitam uma Cadeia de Caracteres do caminho.

Em membros que aceitem um caminho, o caminho pode referir-se a um arquivo ou apenas um diretório.O caminho especificado pode também referir a um caminho relativo ou um caminho Universal Naming Convention (UNC) para um servidor e Compartilhar Nome.Por exemplo, todos os caminhos a seguir são aceitos:

• "c:\\MyDir\\MyFile.txt" em C#, ou "c:\MyDir\MyFile.txt" no Visual Basic.

• "c:\\MyDir" em C#, ou "c:\MyDir" no Visual Basic.

• "MyDir\\MySubdir" em C#, ou "MyDir\MySubDir" no Visual Basic.

• "\\\\MyServer\\MyShare" em C#, ou "\\MyServer\MyShare" no Visual Basic.

Como todos essas operações são executadas em seqüências de caracteres, é impossível verificar se os resultados são válidos em todas as situações.For example, the GetExtension method parses a string that you pass to it and returns the extension from that string.No entanto, isso não significa que existe um arquivo com essa extensão no disco.

Para obter uma lista de tarefas comuns de I/O, consulte Tarefas comuns de E/S.

The following code example demonstrates some of the main members of the Path class.

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

import System.*;
import System.IO.*;

class Test
{
    public static void main(String[] args)
    {
        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());
        Console.WriteLine("\r\nThe set of invalid characters in a path is:");
        Console.WriteLine("(Note that the wildcard characters '*' and '?' "
            + "are not invalid.):");
        char c = ' ';
        for (int iCtr = 0; iCtr < Path.InvalidPathChars.get_Length(); iCtr++) {
            c = Path.InvalidPathChars[iCtr];
            Console.WriteLine(c);
        }
    } //main
} //Test

Referência

Outros recursos