Environment.GetFolderPath Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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

Sobrecargas

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 especificada para acessar pastas especiais.

GetFolderPath(Environment+SpecialFolder)

Origem:

Environment.cs

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.

Retornos

String

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

Uma pasta não existirá fisicamente se o sistema operacional não a tiver criado, a pasta existente tiver sido excluída ou se a pasta for um diretório virtual, como Meu Computador, que não corresponde a um caminho físico.

Exceções

ArgumentException

folder não é membro do Environment.SpecialFolder.

PlatformNotSupportedException

Não há suporte para a plataforma atual.

Exemplos

O exemplo a seguir demonstra como usar o método GetFolderPath para retornar e exibir o caminho associado ao parâmetro folder.

// Sample for the Environment::GetFolderPath method
using namespace System;
int 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
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
'

Comentários

Esse método recupera o caminho para uma pasta especial do sistema, como Arquivos de Programas, Programas, Sistema ou Inicialização, que pode ser usado para acessar informações comuns. As pastas especiais são definidas por padrão pelo sistema ou explicitamente pelo usuário ao instalar uma versão do Windows.

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

Para obter mais informações sobre pastas especiais, consulte csidl (lista de IDs especiais de item) constante.

Confira também

• comportamento getFolderPath no Unix

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Origem:

Environment.cs

Obtém o caminho para a pasta especial do sistema especificada usando uma opção especificada para acessar 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

Parâmetros

folder

Environment.SpecialFolder

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

option

Environment.SpecialFolderOption

Um dos valores de enumeração que especifica opções a serem usadas para acessar uma pasta especial.

Retornos

String

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

Uma pasta não existirá fisicamente se o sistema operacional não a tiver criado, a pasta existente tiver sido excluída ou se a pasta for um diretório virtual, como Meu Computador, que não corresponde a um caminho físico.

Exceções

ArgumentException

folder não é membro do Environment.SpecialFolder.

-ou-

option não é membro do Environment.SpecialFolderOption.

PlatformNotSupportedException

Não há suporte para a plataforma atual.

Comentários

Esse método recupera o caminho para uma pasta especial do sistema, como Arquivos de Programas, Programas, Sistema ou Inicialização, que pode ser usado para acessar informações comuns. As pastas especiais são definidas por padrão pelo sistema ou explicitamente pelo usuário ao instalar uma versão do Windows.

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

Para obter mais informações sobre pastas especiais, consulte csidl (lista de IDs especiais de item) constante.

Confira também

• comportamento getFolderPath no Unix