Environment.GetFolderPath Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Obtiene la ruta de acceso a la carpeta especial del sistema identificada por la enumeración especificada.

Sobrecargas

GetFolderPath(Environment+SpecialFolder)	Obtiene la ruta de acceso a la carpeta especial del sistema especificada.
GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)	Obtiene la ruta de acceso a la carpeta especial del sistema especificada mediante una opción especificada para acceder a carpetas especiales.

GetFolderPath(Environment+SpecialFolder)

Obtiene la ruta de acceso a la carpeta especial del 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

Uno de los valores de enumeración que identifica una carpeta especial del sistema.

Devoluciones

String

Ruta de acceso a la carpeta especial del sistema especificada, si dicha carpeta existe físicamente en el equipo; de lo contrario, una cadena vacía ("").

Una carpeta no existe físicamente si el sistema operativo no la creó, la carpeta existente se eliminó o la carpeta es un directorio virtual, como Mi PC, que no se corresponde con una ruta de acceso física.

Excepciones

ArgumentException

folder no es un miembro de Environment.SpecialFolder.

PlatformNotSupportedException

No se admite la plataforma actual.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el GetFolderPath método para devolver y mostrar la ruta de acceso asociada al 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
'

Comentarios

Este método recupera la ruta de acceso a una carpeta especial del sistema, como Archivos de programa, Programas, Sistema o Inicio, que se puede usar para acceder a información común. Las carpetas especiales se establecen de forma predeterminada por el sistema, o explícitamente por el usuario, al instalar una versión de Windows.

El folder parámetro designa la carpeta especial que se va a recuperar y debe ser uno de los valores de la Environment.SpecialFolder enumeración; cualquier otro valor produce una excepción.

Para obtener más información sobre las carpetas especiales, vea Constante special item ID list (CSIDL).

Consulte también

• Comportamiento de GetFolderPath en Unix

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Obtiene la ruta de acceso a la carpeta especial del sistema especificada mediante una opción especificada para acceder a carpetas especiales.

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

Uno de los valores de enumeración que identifica una carpeta especial del sistema.

option

Environment.SpecialFolderOption

Uno de los valores de enumeración que especifica opciones que se van a usar para tener acceso a una carpeta especial.

Devoluciones

String

Ruta de acceso a la carpeta especial del sistema especificada, si dicha carpeta existe físicamente en el equipo; de lo contrario, una cadena vacía ("").

Una carpeta no existe físicamente si el sistema operativo no la creó, la carpeta existente se eliminó o la carpeta es un directorio virtual, como Mi PC, que no se corresponde con una ruta de acceso física.

Excepciones

ArgumentException

folder no es un miembro de Environment.SpecialFolder.

O bien

options no es un miembro de Environment.SpecialFolderOption.

PlatformNotSupportedException

No se admite la plataforma actual.

Comentarios

Este método recupera la ruta de acceso a una carpeta especial del sistema, como Archivos de programa, Programas, Sistema o Inicio, que se puede usar para acceder a información común. Las carpetas especiales se establecen de forma predeterminada por el sistema, o explícitamente por el usuario, al instalar una versión de Windows.

El folder parámetro designa la carpeta especial que se va a recuperar y debe ser uno de los valores de la Environment.SpecialFolder enumeración; cualquier otro valor produce una excepción.

Para obtener más información sobre las carpetas especiales, vea Constante special item ID list (CSIDL).

Consulte también

• Comportamiento de GetFolderPath en Unix