Partilhar 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 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

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

Aplica-se a

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

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