Windows App SDKを使用してファイル、フォルダー、ライブラリを管理する

Windows App SDKは、パッケージ アプリの強力なファイル管理機能を提供します。 Windows.Storage、Windows.Storage.Streams、および Microsoft.Windows.Storage.Pickers 名前空間を使用して、ファイル内のさまざまなデータ形式を効率的に読み書きしたり、ファイルとフォルダーを管理したりできます。

Windows 10以降、Windows デスクトップ アプリのファイル、フォルダー、ライブラリ、設定に関連するさまざまな API があります。 これらの機能は、Windows App SDK、、および .NET SDK> によって提供されるWindows App SDK、Windows Runtime (WinRT)、および.NET API の組み合わせによって利用できます。

Windows App SDK ピッカーを使用してデータの読み取りと書き込みを行う

Windows App SDK バージョン 1.8 以降では、ピッカー API を使用できます。 次のトピックでは、ピッカー API を使用して、ユーザーがアプリ内のファイルとフォルダーを開いて保存できるようにする方法について説明します。

WinRT ピッカーと Windows App SDK ピッカーの主な違い

WinRT Windows.Storage.Pickers の UWP アプリで使用されるものとの主な相違点を次に示します。

• 既存の Windows.Storage.Pickers API が StorageFile および StorageFolder オブジェクトを返すのに対し、この新しい API は、PickFileResult および PickFolderResult クラスを介して文字列ベースのパスを返します。 これにより、API が簡略化され、昇格されたシナリオでのstorage機能の複雑さを回避できます。
• 同様に、FileSavePicker.SuggestedSaveFile プロパティ (StorageFile が返されました) が置き換えられました。 その機能は、SuggestedFolder と SuggestedFileName の 2 つの文字列プロパティでカバーされるようになりました。 これにより、保存ダイアログのフォルダーとファイル名を提案できます。
• すべての新しいピッカーはデスクトップ アプリ専用に設計されており、 WindowId プロパティを使用してピッカーをホスト ウィンドウにリンクし、 WinRT.Interop.InitializeWithWindow.Initialize パターンを置き換えます。
• 新しいピッカーを使用すると、開発者は FileTypeFilter または FileTypeChoices を指定する必要なく使用できます。 これらのプロパティが設定されていない場合、UWP ピッカーは例外をスローしますが、開発者がこれらのプロパティを明示的に構成しない場合、新しいピッカーでは既定ですべてのファイルが表示されます。
• HomeGroup の場所は、新しい PickerLocationId 列挙型から除外されました。これは、Windows 10 以降サポートされなくなりました。
• FolderPicker.FileTypeFilter はフォルダーの選択に適していないため、除外されています。
• 非推奨または "使用しない" として既にマークされているメソッドとプロパティを除外します。 たとえば、 PickSingleFileAndContinue、 ContinuationData、 ResumePickSingleFileAsync などです。
• 新しい API は現在、各ユーザーが独自の対話型セッションを持ち、各セッションがデバイス上の他のセッションから完全に独立しているデスクトップ シナリオ向けに設計されているため、マルチユーザー モードのメソッドとプロパティを除外します。 これは、Xbox やその他のマルチユーザー デバイスとは対照的です。

WinRT storage API を使用してデータをAccessする

パッケージ アプリには、UWP アプリで使用できるすべての WinRT storage API にaccessがあります。 既存の UWP アプリを移行する場合でも、新しいアプリを作成する場合でも、これらの API を使用してデータの読み取りと書き込みを行うことができます。 WinUI 3 アプリで storage API を使用する例については、「Windows App SDK API と WinRT API を使用したAccess ファイルとフォルダーを参照してください。

.NET ファイル API を使用してデータにアクセスする

パッケージ化されたデスクトップ アプリでは、WinRT API に加えて、System.IO 名前空間の.NET API を使用して、データの読み取りと書き込みを行うことができます。 新しい WinUI projectが作成されると、Package.appxmanifest ファイルには次の設定が含まれます。

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

この制限付き機能を宣言すると、ファイル システム、レジストリ、およびその他の制限付き機能に対する完全なaccessが提供されます。 詳細については、「 制限付き機能宣言」を参照してください。 つまり、.NET ファイル API を使用する場合、アプリは他の .NET デスクトップ アプリと同じaccessをファイル システムに持っています。

WinUI アプリで .NET API を使用する例については、「Access Windows App SDK API と .NET API を含むファイルとフォルダーを参照してください。

ファイルとフォルダーを操作するためのその他のリソース

パッケージ化された WinUI アプリを開発している場合、WinRT storage API は、データの読み取りと書き込みを行う強力なツールになります。 次の UWP トピックでは、アプリでこれらの API を活用しようとしている開発者向けの豊富な情報を提供します。

こちらも参照ください

Windows App SDK と WinRT API を使用してファイルやフォルダーにアクセスする

Windows App SDK と .NET API を使用してファイルとフォルダーにアクセスする

System.IO