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)

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 no computador; caso contrário, uma cadeia de caracteres vazia ("").

Uma pasta não existirá fisicamente se o sistema operacional não a criar, se a pasta existente foi 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 de Environment.SpecialFolder.

PlatformNotSupportedException

Não há suporte para a plataforma atual.

Exemplos

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

// 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 folder parâmetro designa a pasta especial a ser recuperada e deve ser um dos valores na Environment.SpecialFolder enumeração; qualquer outro valor gera uma exceção.

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

Confira também

• Comportamento de GetFolderPath no Unix

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.

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 as 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 no computador; caso contrário, uma cadeia de caracteres vazia ("").

Uma pasta não existirá fisicamente se o sistema operacional não a criar, se a pasta existente foi 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 de Environment.SpecialFolder.

- ou -

options não é membro de 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 folder parâmetro designa a pasta especial a ser recuperada e deve ser um dos valores na Environment.SpecialFolder enumeração; qualquer outro valor gera uma exceção.

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

Confira também

• Comportamento de GetFolderPath no Unix