Environment.GetFolderPath Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Возвращает путь к особой системной папке, указанной в заданном перечислении.

Перегрузки

GetFolderPath(Environment+SpecialFolder)	Возвращает путь к указанной системной специальной папке.
GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)	Возвращает путь к указанной системной специальной папке с помощью указанного параметра для доступа к специальным папкам.

GetFolderPath(Environment+SpecialFolder)

Исходный код:

Environment.cs

Возвращает путь к указанной системной специальной папке.

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

Параметры

folder

Environment.SpecialFolder

Одно из значений перечисления, указывающее особую системную папку.

Возвращаемое значение

String

Путь к указанной особой системной папке, если эта папка физически существует на компьютере; в противном случае — пустая строка ("").

Папка физически не существует, если она не была создана операционной системой, была удалена или является виртуальным каталогом, таким как "Мой компьютер", которому не сопоставлен физический путь.

Исключения

ArgumentException

folder не является членом Environment.SpecialFolder.

PlatformNotSupportedException

Текущая платформа не поддерживается.

Примеры

В следующем примере показано, как использовать GetFolderPath метод для возврата и отображения пути, связанного с параметром 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
'

Комментарии

Этот метод извлекает путь к специальной системе папке, например Program Files, Programs, System или Startup, которая может использоваться для доступа к общей информации. Специальные папки задаются по умолчанию системой или явным образом пользователем при установке версии Windows.

Параметр folder указывает специальную папку для извлечения и должен быть одним из значений в перечислении Environment.SpecialFolder ; любое другое значение вызывает исключение.

Дополнительные сведения о специальных папках см. в разделе Постоянный список специальных элементов (CSIDL).

См. также раздел

• Поведение GetFolderPath в Unix

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Исходный код:

Environment.cs

Возвращает путь к указанной системной специальной папке с помощью указанного параметра для доступа к специальным папкам.

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

Параметры

folder

Environment.SpecialFolder

Одно из значений перечисления, указывающее особую системную папку.

option

Environment.SpecialFolderOption

Одно из значений перечисления, указывающее параметры доступа к особой папке.

Возвращаемое значение

String

Путь к указанной особой системной папке, если эта папка физически существует на компьютере; в противном случае — пустая строка ("").

Папка физически не существует, если она не была создана операционной системой, была удалена или является виртуальным каталогом, таким как "Мой компьютер", которому не сопоставлен физический путь.

Исключения

ArgumentException

folder не является членом Environment.SpecialFolder.

-или-

options не является членом Environment.SpecialFolderOption.

PlatformNotSupportedException

Текущая платформа не поддерживается.

Комментарии

Этот метод извлекает путь к специальной системе папке, например Program Files, Programs, System или Startup, которая может использоваться для доступа к общей информации. Специальные папки задаются по умолчанию системой или явным образом пользователем при установке версии Windows.

Параметр folder указывает специальную папку для извлечения и должен быть одним из значений в перечислении Environment.SpecialFolder ; любое другое значение вызывает исключение.

Дополнительные сведения о специальных папках см. в разделе Постоянный список специальных элементов (CSIDL).

См. также раздел

• Поведение GetFolderPath в Unix