Environment.GetFolderPath メソッド

.NET Framework クラス ライブラリ リファレンス

Environment.GetFolderPath メソッド

指定した列挙体によって識別されるシステムの固定フォルダへのパスを取得します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetFolderPath
 ( _
    folder As SpecialFolder _
) As String

Visual Basic (使用法)

Dim folder As SpecialFolder
Dim returnValue As String

returnValue = Environment.GetFolderPath(folder)

C#

public static string GetFolderPath
 (
    SpecialFolder folder
)

C++

public:
static String^ GetFolderPath (
    SpecialFolder folder
)

J#

public static String GetFolderPath (
    SpecialFolder folder
)

JScript

public static function GetFolderPath
 (
    folder : SpecialFolder
) : String

パラメータ

folder

システムの固定フォルダを識別する列挙定数。

戻り値
システムの指定した固定フォルダが物理的に存在する場合は、そのフォルダへのパス。それ以外の場合は空の文字列 ("")。 オペレーティング システムがフォルダを作成していない場合、存在していたフォルダを削除した場合、またはフォルダが物理パスに対応しない [マイ コンピュータ] などの仮想ディレクトリの場合、フォルダは物理的に存在しません。

例外

例外の種類	条件
ArgumentException	folder が System.Environment.SpecialFolder のメンバではありません。

解説

このメソッドは、一般的な情報にアクセスするために使用できる Program Files、Programs、System、Startup などのシステムの固定フォルダへのパスを取得します。特別なフォルダは、あるバージョンの Windows をインストールするときに、既定でシステムにより設定されるか、またはユーザーにより明示的に設定されます。

folder パラメータは取得対象の固定フォルダを指定するもので、Environment.SpecialFolder 列挙定数のいずれかの値にする必要があります。他の値を指定すると例外がスローされます。

固定フォルダの詳細については、http://msdn.microsoft.com/library/en-us/shellcc/platform/Shell/reference/enums/csidl.asp のトピック「CSIDL Values」を参照してください。

使用例

Visual Basic

' Sample for the Environment.GetFolderPath method
Imports System

Class Sample
   Public Shared Sub Main()
      Console.WriteLine()
      Console.WriteLine("GetFolderPath: {0}", Environment.GetFolderPath(Environment.SpecialFolder.System))
   End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'
'GetFolderPath: C:\WINNT\System32
'

C#

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

C++

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

.NET Framework のセキュリティ

• FileIOPermission  (ディレクトリ パスに対して読み取り、および書き込みを行うために必要なアクセス許可)。FileIOPermissionAccess.PathDiscovery (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Environment クラス
Environment メンバ
System 名前空間