WinAPI メソッドSHGetKnownFolderPathは、個人用フォルダーやダウンロード フォルダーを含む特別なフォルダーへのパスを取得する唯一の正しい方法です。
同様の結果を得るための有望な方法は他にもありますが、特定のシステムでは完全に間違ったパスになってしまいます (たとえば、パスの一部を結合またはハードコーディングするか、古いレジストリ キーを悪用するなど)。その背後にある理由は、CodeProject の記事に記載されており、完全なソリューションもリストされています。既知の 94 個の特殊なフォルダすべての取得をサポートするラッピング クラスと、さらにいくつかの機能を提供します。
ここでの簡単な例として、ソリューションの短縮バージョンを貼り付けただけで、ダウンロードなどの個人用の特別なフォルダーのみを取得できます。
using System;
using System.Runtime.InteropServices;
/// <summary>
/// Class containing methods to retrieve specific file system paths.
/// </summary>
public static class KnownFolders
{
private static string[] _knownFolderGuids = new string[]
{
"{56784854-C6CB-462B-8169-88E350ACB882}", // Contacts
"{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}", // Desktop
"{FDD39AD0-238F-46AF-ADB4-6C85480369C7}", // Documents
"{374DE290-123F-4565-9164-39C4925E467B}", // Downloads
"{1777F761-68AD-4D8A-87BD-30B759FA33DD}", // Favorites
"{BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968}", // Links
"{4BD8D571-6D19-48D3-BE97-422220080E43}", // Music
"{33E28130-4E1E-4676-835A-98395C3BC3BB}", // Pictures
"{4C5C32FF-BB9D-43B0-B5B4-2D72E54EAAA4}", // SavedGames
"{7D1D3A04-DEBB-4115-95CF-2F29DA2920DA}", // SavedSearches
"{18989B1D-99B5-455B-841C-AB7C74E4DDFC}", // Videos
};
/// <summary>
/// Gets the current path to the specified known folder as currently configured. This does
/// not require the folder to be existent.
/// </summary>
/// <param name="knownFolder">The known folder which current path will be returned.</param>
/// <returns>The default path of the known folder.</returns>
/// <exception cref="System.Runtime.InteropServices.ExternalException">Thrown if the path
/// could not be retrieved.</exception>
public static string GetPath(KnownFolder knownFolder)
{
return GetPath(knownFolder, false);
}
/// <summary>
/// Gets the current path to the specified known folder as currently configured. This does
/// not require the folder to be existent.
/// </summary>
/// <param name="knownFolder">The known folder which current path will be returned.</param>
/// <param name="defaultUser">Specifies if the paths of the default user (user profile
/// template) will be used. This requires administrative rights.</param>
/// <returns>The default path of the known folder.</returns>
/// <exception cref="System.Runtime.InteropServices.ExternalException">Thrown if the path
/// could not be retrieved.</exception>
public static string GetPath(KnownFolder knownFolder, bool defaultUser)
{
return GetPath(knownFolder, KnownFolderFlags.DontVerify, defaultUser);
}
private static string GetPath(KnownFolder knownFolder, KnownFolderFlags flags,
bool defaultUser)
{
int result = SHGetKnownFolderPath(new Guid(_knownFolderGuids[(int)knownFolder]),
(uint)flags, new IntPtr(defaultUser ? -1 : 0), out IntPtr outPath);
if (result >= 0)
{
string path = Marshal.PtrToStringUni(outPath);
Marshal.FreeCoTaskMem(outPath);
return path;
}
else
{
throw new ExternalException("Unable to retrieve the known folder path. It may not "
+ "be available on this system.", result);
}
}
[DllImport("Shell32.dll")]
private static extern int SHGetKnownFolderPath(
[MarshalAs(UnmanagedType.LPStruct)]Guid rfid, uint dwFlags, IntPtr hToken,
out IntPtr ppszPath);
[Flags]
private enum KnownFolderFlags : uint
{
SimpleIDList = 0x00000100,
NotParentRelative = 0x00000200,
DefaultPath = 0x00000400,
Init = 0x00000800,
NoAlias = 0x00001000,
DontUnexpand = 0x00002000,
DontVerify = 0x00004000,
Create = 0x00008000,
NoAppcontainerRedirection = 0x00010000,
AliasOnly = 0x80000000
}
}
/// <summary>
/// Standard folders registered with the system. These folders are installed with Windows Vista
/// and later operating systems, and a computer will have only folders appropriate to it
/// installed.
/// </summary>
public enum KnownFolder
{
Contacts,
Desktop,
Documents,
Downloads,
Favorites,
Links,
Music,
Pictures,
SavedGames,
SavedSearches,
Videos
}
(完全にコメントされたバージョンは、上記のリンク先の CodeProject 記事にあります。)
これは厄介なコードの壁にすぎませんでしたが、対処しなければならない表面は非常に単純です。ダウンロード フォルダーのパスを出力するコンソール プログラムの例を次に示します。
private static void Main()
{
string downloadsPath = KnownFolders.GetPath(KnownFolder.Downloads);
Console.WriteLine("Downloads folder path: " + downloadsPath);
Console.ReadLine();
}
たとえば、クエリするパスのフォルダーKnownFolders.GetPath()の列挙値を使用して呼び出すだけです。KnownFolder
NuGet パッケージ
この面倒なことをすべてやりたくない場合は、最近作成した NuGet パッケージをインストールしてください。プロジェクト サイトはこちら、ギャラリー リンクはこちらです(使用方法が異なり、洗練されていることに注意してください。詳細については、プロジェクト サイトの使用セクションを参照してください)。
PM> Install-Package Syroot.Windows.IO.KnownFolders
使用法：
using System;
using Syroot.Windows.IO;
class Program
{
static void Main(string[] args)
{
string downloadsPath = new KnownFolder(KnownFolderType.Downloads).Path;
Console.WriteLine("Downloads folder path: " + downloadsPath);
Console.ReadLine();
}
}