StorageFile 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示檔案。 提供檔案及其內容的相關資訊，以及操作方式。
public ref class StorageFile sealed : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFile final : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFile : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProviderPublic NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider- 繼承
- 屬性
- 實作
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
| 應用程式功能 |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
範例
此範例示範如何使用 FileOpenPicker.PickSingleFileAsync 呼叫檔案選擇器，以擷取和處理使用者挑選的檔案。
var openPicker = new FileOpenPicker();
StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
// Store file for future access
Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
// The user didn't pick a file
}
PickSingleFileAsync完成之後， file 取得挑選的檔案作為 StorageFile。
在此範例中， openPicker 包含 FileOpenPicker 物件。 若要深入瞭解如何使用檔案選擇器，請參閱 使用選擇器開啟檔案和資料夾。
此外， fileToken 取得可用來從 FutureAccessList擷取檔案的識別碼。 若要深入瞭解儲存檔案和資料夾，以便稍後再存取它們，請參閱 FutureAccessList、 MostRecentlyUsedList 和 Track 最近使用的檔案和資料夾。
備註
一般而言，您會以非同步方法和/或函式呼叫的結果來存取 StorageFile 物件。 例如， GetFileFromPathAsync 和 GetFileFromApplicationUriAsync 這兩個靜態方法都會傳回代表指定檔案的 StorageFile。
此外，當您呼叫檔案選擇器以讓使用者挑選檔案 (或檔案時，) 檔案選擇器會將檔案傳回為 StorageFile。
注意
StorageFile 物件無法代表 「.lnk」、「.url」 或 「.wsh」 檔案類型的檔案。
版本歷程記錄
| Windows 版本 | SDK 版本 | 新增值 |
|---|---|---|
| 2004 | 19041 | GetFileFromPathForUserAsync |
屬性
| Attributes |
取得檔案的屬性。 |
| ContentType |
取得檔案內容的 MIME 類型。 |
| DateCreated |
取得建立目前檔案的日期和時間。 |
| DisplayName |
取得檔案的使用者易記名稱。 |
| DisplayType |
取得檔案類型的使用者易記描述。 |
| FileType |
取得檔案) (副檔名的類型。 |
| FolderRelativeId |
取得檔案的識別碼。 此識別碼對於包含檔案的查詢結果或 StorageFolder 而言是唯一的，而且可用來區別具有相同名稱的專案。 |
| IsAvailable |
指出檔案是否為本機、在本機快取，或可下載。 |
| Name |
取得檔案名，包括副檔名。 |
| Path |
如果檔案有路徑，則取得目前檔案的完整檔案系統路徑。 |
| Properties |
取得 物件，這個物件可讓您存取檔案的內容相關屬性。 |
| Provider |
取得 StorageProvider 物件，其中包含儲存目前檔案之服務的相關資訊。 |