Environment.GetFolderPath Método

Definição

Espaço de Nomes:: System

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Obtém o caminho para a pasta especial do sistema que é identificada pela enumeração especificada.

Sobrecargas

Name	Description
GetFolderPath(Environment+SpecialFolder)	Obtém o caminho para a pasta especial do sistema especificada.
GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)	Obtém o caminho para a pasta especial do sistema especificada usando uma opção específica para aceder a pastas especiais.

GetFolderPath(Environment+SpecialFolder)

Obtém o caminho para a pasta especial do sistema especificada.

public:
 static System::String ^ GetFolderPath(Environment::SpecialFolder folder);

public static string GetFolderPath(Environment.SpecialFolder folder);

static member GetFolderPath : Environment.SpecialFolder -> string

Public Shared Function GetFolderPath (folder As Environment.SpecialFolder) As String

Parâmetros

folder: Environment.SpecialFolder

Um dos valores de enumeração que identifica uma pasta especial do sistema.

Devoluções

String

O caminho para a pasta especial do sistema especificada, se essa pasta existir fisicamente no seu computador; caso contrário, uma cadeia vazia ("").

Uma pasta não existirá fisicamente se o sistema operativo não a criou, se a pasta existente foi eliminada, ou se a pasta for um diretório virtual, como O Meu Computador, que não corresponde a um caminho físico.

Exceções

ArgumentException

folder não é membro de Environment.SpecialFolder.

PlatformNotSupportedException

A plataforma atual não é suportada.

Exemplos

O exemplo seguinte demonstra como usar o GetFolderPath método para devolver e mostrar o caminho associado ao folder parâmetro.

// Sample for the Environment.GetFolderPath method
using System;

class Sample
{
    public static void Main()
    {
    Console.WriteLine();
    Console.WriteLine("GetFolderPath: {0}",
                 Environment.GetFolderPath(Environment.SpecialFolder.System));
    }
}
/*
This example produces the following results:

GetFolderPath: C:\WINNT\System32
*/

// Sample for the Environment.GetFolderPath method
open System

printfn $"\nGetFolderPath: {Environment.GetFolderPath Environment.SpecialFolder.System}"
            
// This example produces the following results:
//     GetFolderPath: C:\WINNT\System32

' Sample for the Environment.GetFolderPath method
Class Sample
   Public Shared Sub Main()
      Console.WriteLine()
      Console.WriteLine("GetFolderPath: {0}", Environment.GetFolderPath(Environment.SpecialFolder.System))
   End Sub
End Class
'
'This example produces the following results:
'
'GetFolderPath: C:\WINNT\System32
'

Observações

Este método recupera o caminho para uma pasta especial do sistema, como Ficheiros de Programação, Programas, Sistema ou Arranque, que pode ser usada para aceder a informações comuns. Pastas especiais são definidas por defeito pelo sistema, ou explicitamente pelo utilizador, ao instalar uma versão do Windows.

O folder parâmetro designa a pasta especial a recuperar e deve ser um dos valores na Environment.SpecialFolder enumeração; qualquer outro valor lança uma exceção.

Para mais informações sobre pastas especiais, consulte Lista de ID de item especial constante (CSIDL).

Ver também

Comportamento GetFolderPath no Unix

Aplica-se a

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Obtém o caminho para a pasta especial do sistema especificada usando uma opção específica para aceder a pastas especiais.

public:
 static System::String ^ GetFolderPath(Environment::SpecialFolder folder, Environment::SpecialFolderOption option);

public static string GetFolderPath(Environment.SpecialFolder folder, Environment.SpecialFolderOption option);

static member GetFolderPath : Environment.SpecialFolder * Environment.SpecialFolderOption -> string

Public Shared Function GetFolderPath (folder As Environment.SpecialFolder, option As Environment.SpecialFolderOption) As String