Ler em inglês

Compartilhar via


Environment.GetFolderPath Método

Definição

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
Origem:
Environment.cs
Origem:
Environment.cs

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

public static string GetFolderPath (Environment.SpecialFolder folder);

Parâmetros

folder
Environment.SpecialFolder

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

Retornos

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

folder não é membro do Environment.SpecialFolder.

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

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Origem:
Environment.cs
Origem:
Environment.cs
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 string GetFolderPath (Environment.SpecialFolder folder, Environment.SpecialFolderOption option);

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

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

folder não é membro do Environment.SpecialFolder.

-ou-

option não é membro do Environment.SpecialFolderOption.

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1