SD カードへのアクセス

[アーティクル]
07/13/2023

オプションの microSD カードに重要度の低いデータを保存したり、これらのデータにアクセスしたりすることができます (特に内部ストレージに制限があり、microSD カード用のスロットがある低コストのモバイルデバイスの場合)。

ほとんどの場合、アプリで SD カード上のファイルの保存とアクセスを行うには、アプリマニフェストファイルで removableStorage 機能を指定する必要があります。通常、アプリから保存したりアクセスしたりするファイルの種類を処理対象として登録することも必要です。

次の方法を使って、オプションの SD カードに対してファイルの保存とアクセスを行うことができます。

ファイルピッカー
Windows.Storage API

SD カードでアクセスできるデータとアクセスできないデータ

アクセスできるデータ

アプリでファイルの読み取りと書き込みを実行するには、そのファイルの種類が処理対象となるように、アプリでアプリマニフェストファイルに登録する必要があります。
アプリでは、フォルダーの作成と管理も実行できます。

アクセスできないデータ

アプリでは、システムフォルダーとそのフォルダー内のファイルを参照したり、アクセスしたりすることはできません。
隠し属性でマークされたファイルを参照することはできません。通常、隠し属性は、データを誤って削除するというリスクを減らすために使われます。
KnownFolders.DocumentsLibrary を使ってドキュメントライブラリを参照したり、ドキュメントライブラリにアクセスしたりすることはできません。ただしファイルシステムを走査することによって、SD カード上のドキュメントライブラリにアクセスすることはできます。

セキュリティとプライバシーに関する考慮事項

アプリが SD カードのグローバルな場所にファイルを保存する場合、それらのファイルは暗号化されないため、通常は他のアプリからアクセスすることができます。

SD カードがデバイスに挿入されている間、SD カード上のファイルは、同じファイルの種類を処理対象として登録している他のアプリからアクセスすることができます。
SD カードをデバイスから取り外し、PC で開くと、ファイルはエクスプローラーに表示されるため、他のアプリからアクセスすることができます。

アプリを SD カードにインストールし、ファイルを SD カードの LocalFolder に保存する場合、それらのファイルは暗号化されるため、他のアプリからアクセスすることはできません。

SD カード上のファイルへアクセスするための要件

SD カードのファイルにアクセスするには通常、次のことを指定する必要があります。

アプリマニフェストファイルで removableStorage 機能を指定する必要があります。
また、アクセスするメディアの種類に関連付けられたファイル拡張子を処理対象として登録する必要があります。

KnownFolders.MusicLibrary などの既知のフォルダーを参照せずに SD カード上のメディアファイルにアクセスしたり、メディアライブラリフォルダーの外部に格納されているメディアファイルにアクセスしたりするに場合にも、上記の方法を使います。

ミュージック、写真、ビデオなどのメディアライブラリに格納されているメディアファイルに既知のフォルダーを使ってアクセスする場合は、関連付けられている機能 (musicLibrary、picturesLibrary、videoLibrary) をアプリマニフェストファイルで指定するだけで十分です。 removableStorage 機能を指定する必要はありません。詳しくは、「ミュージック、画像、およびビデオライブラリのファイルとフォルダー」をご覧ください。

SD カード上のファイルへのアクセス

SD カードへの参照の取得

KnownFolders.RemovableDevices フォルダーは、デバイスに現在接続されている一連のリムーバブルデバイスに対する論理ルートである StorageFolder です。 SD カードが取り付けられている場合は、KnownFolders.RemovableDevices フォルダーの下にある、最初の (唯一の) StorageFolder が SD カードを表します。

次のようなコードを使って、SD カードが存在するかどうかを判断し、SD カードへの参照を StorageFolder として取得します。

using Windows.Storage;

// Get the logical root folder for all external storage devices.
StorageFolder externalDevices = Windows.Storage.KnownFolders.RemovableDevices;

// Get the first child folder, which represents the SD card.
StorageFolder sdCard = (await externalDevices.GetFoldersAsync()).FirstOrDefault();

if (sdCard != null)
{
    // An SD card is present and the sdCard variable now contains a reference to it.
}
else
{
    // No SD card is present.
}

Note

SD カードリーダーが内蔵のリーダー (ノート PC や PC のスロットなど) である場合、KnownFolders.RemovableDevices によってアクセスできない場合があります。

SD カードのコンテンツの照会

SD カードには、既知のフォルダーとして認識されないさまざまなフォルダーやファイルを含めることができますが、KnownFolders の場所の情報を使って照会することはできません。ファイルを検索するには、アプリでファイルシステムを再帰的に走査して、SD カードのコンテンツを列挙する必要があります。 SD カードのコンテンツを効率的に取得するには、GetFilesAsync (CommonFileQuery.DefaultQuery) と GetFoldersAsync (CommonFolderQuery.DefaultQuery) を使います。

SD カードを走査するにはバックグラウンドスレッドを使うことをお勧めします。 SD カードには、かなりのギガバイト数のデータを格納できる場合があります。

また、アプリでは、ユーザーに対してフォルダーピッカーを使って特定のフォルダーを選ぶように要求することもできます。

KnownFolders.RemovableDevices から取得したパスを使って SD カード上のファイルシステムにアクセスした場合のメソッドの動作を次に示します。

GetFilesAsync メソッドは、処理対象として登録したファイル拡張子と、指定したメディアライブラリ機能に関連付けられているファイル拡張子との和集合を返します。
アクセスしようとするファイルの拡張子を処理対象として登録しなかった場合、GetFileFromPathAsync メソッドは失敗します。

個々の SD カードの識別

SD カードが最初にマウントされると、オペレーティングシステムによって、そのカードの一意の識別子が生成されます。この ID は、カードのルートにある WPSystem フォルダー内のファイルに格納されます。アプリはこの ID を使って、カードを認識できるかどうかを判断することができます。カードがアプリによって認識されると、アプリでは、既に完了している特定の操作を後で実行できる場合があります。ただし、アプリが前回カードにアクセスした以降、カードのコンテンツが変更されている可能性があります。

たとえば、電子ブックにインデックスを付けるアプリについて考えてみましょう。アプリが以前に SD カード全体を走査して電子ブックのファイルを探し、電子ブックのインデックスを作成した場合、カードをもう一度挿入し、アプリがカードを認識すると、直ちにインデックスの一覧を表示できます。これとは別に、新しい電子ブックを検索する優先度の低いバックグラウンドスレッドを開始することもできます。また、削除された電子ブックへアクセスしようとしたとき、以前に存在していた電子ブックが見つからなかった場合のエラーを処理することもできます。

この ID を含むプロパティの名前は、WindowsPhone.ExternalStorageId です。

using Windows.Storage;

// Get the logical root folder for all external storage devices.
StorageFolder externalDevices = Windows.Storage.KnownFolders.RemovableDevices;

// Get the first child folder, which represents the SD card.
StorageFolder sdCard = (await externalDevices.GetFoldersAsync()).FirstOrDefault();

if (sdCard != null)
{
    var allProperties = sdCard.Properties;
    IEnumerable<string> propertiesToRetrieve = new List<string> { "WindowsPhone.ExternalStorageId" };

    var storageIdProperties = await allProperties.RetrievePropertiesAsync(propertiesToRetrieve);

    string cardId = (string)storageIdProperties["WindowsPhone.ExternalStorageId"];

    if (...) // If cardID matches the cached ID of a recognized card.
    {
        // Card is recognized. Index contents opportunistically.
    }
    else
    {
        // Card is not recognized. Index contents immediately.
    }
}