StorageFolder Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengelola folder dan isinya dan menyediakan informasi tentang folder tersebut.
public ref class StorageFolder sealed : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolder final : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolder : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations
Public NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
- Warisan
- Atribut
- Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Kemampuan aplikasi |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
Keterangan
Biasanya Anda mendapatkan objek StorageFolder sebagai nilai pengembalian panggilan metode asinkron. Misalnya, metode statis GetFolderFromPathAsync mengembalikan StorageFolder yang mewakili folder yang ditentukan.
Perhatikan bahwa saat Anda memanggil pemilih file untuk membiarkan pengguna memilih folder, pemilih file mengembalikan folder sebagai StorageFolder.
Saat ini tidak ada "MoveAsync" atau metode serupa. Salah satu implementasi sederhana memindahkan folder mungkin adalah mendapatkan folder yang diinginkan, menyalinnya ke lokasi yang diinginkan, lalu menghapus folder asli.
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1803 | 17134 | TryGetChangeTracker |
2004 | 19041 | GetFolderFromPathForUserAsync |
Properti
Attributes |
Mendapatkan atribut folder saat ini. |
DateCreated |
Mendapatkan tanggal dan waktu folder saat ini dibuat. |
DisplayName |
Mendapatkan nama folder yang mudah digunakan saat ini. |
DisplayType |
Mendapatkan deskripsi jenis folder yang mudah digunakan; misalnya, |
FolderRelativeId |
Mendapatkan pengidentifikasi untuk folder saat ini. ID ini unik untuk hasil kueri atau StorageFolder yang berisi folder atau grup file saat ini, dan dapat digunakan untuk membedakan antara item yang memiliki nama yang sama. |
Name |
Mendapatkan nama folder saat ini. |
Path |
Mendapatkan jalur lengkap folder saat ini dalam sistem file, jika jalur tersedia. |
Properties |
Mendapatkan objek yang menyediakan akses ke properti terkait konten folder saat ini. |
Provider |
Mendapatkan objek StorageProvider yang berisi info tentang layanan yang menyimpan folder saat ini. |
Metode
AreQueryOptionsSupported(QueryOptions) |
Menunjukkan apakah folder saat ini mendukung QueryOptions yang ditentukan. |
CreateFileAsync(String) |
Membuat file baru dengan nama yang ditentukan di folder saat ini. |
CreateFileAsync(String, CreationCollisionOption) |
Membuat file baru di folder saat ini. Metode ini juga menentukan apa yang harus dilakukan jika file dengan nama yang sama sudah ada di folder saat ini. |
CreateFileQuery() |
Mendapatkan objek hasil kueri yang berisi file di folder saat ini. |
CreateFileQuery(CommonFileQuery) |
Mendapatkan objek hasil kueri yang berisi file di folder saat ini. Juga mendapatkan file dari subfolder folder saat ini ketika nilai argumen kueri adalah sesuatu selain CommonFileQuery.DefaultQuery. File diurutkan berdasarkan CommonFileQuery yang ditentukan. |
CreateFileQueryWithOptions(QueryOptions) |
Mendapatkan objek hasil kueri yang berisi file di folder saat ini dan, secara opsional, di subfolder folder saat ini. Hasilnya didasarkan pada QueryOptions yang ditentukan. |
CreateFolderAsync(String) |
Membuat subfolder baru dengan nama yang ditentukan di folder saat ini. |
CreateFolderAsync(String, CreationCollisionOption) |
Membuat subfolder baru dengan nama yang ditentukan di folder saat ini. Metode ini juga menentukan apa yang harus dilakukan jika subfolder dengan nama yang sama sudah ada di folder saat ini. |
CreateFolderQuery() |
Mendapatkan objek hasil kueri yang berisi subfolder di folder saat ini. |
CreateFolderQuery(CommonFolderQuery) |
Mendapatkan objek hasil kueri yang berisi subfolder di folder saat ini. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, mendapatkan daftar folder virtual yang mewakili kontainer untuk grup file di subfolder folder saat ini. File dikelompokkan ke dalam folder berdasarkan nilai yang ditentukan dari enumerasi CommonFolderQuery . |
CreateFolderQueryWithOptions(QueryOptions) |
Mendapatkan objek hasil kueri yang berisi subfolder di folder saat ini dan, secara opsional, subfolder berlapis. Hasilnya didasarkan pada QueryOptions yang ditentukan. |
CreateItemQuery() |
Mendapatkan objek hasil kueri yang berisi file dan subfolder di folder saat ini. |
CreateItemQueryWithOptions(QueryOptions) |
Mendapatkan objek hasil kueri yang berisi file dan subfolder di folder saat ini dan, secara opsional, di subfolder folder saat ini. Hasilnya didasarkan pada QueryOptions yang ditentukan. |
DeleteAsync() |
Menghapus folder saat ini. |
DeleteAsync(StorageDeleteOption) |
Menghapus folder saat ini. Metode ini juga menentukan apakah akan menghapus folder secara permanen. |
GetBasicPropertiesAsync() |
Mendapatkan properti dasar folder atau grup file saat ini. |
GetFileAsync(String) |
Mendapatkan file dengan nama yang ditentukan dari folder saat ini. |
GetFilesAsync() |
Mendapatkan file dalam folder saat ini. |
GetFilesAsync(CommonFileQuery) |
Mendapatkan file dalam folder saat ini. Juga mendapatkan file dari subfolder folder saat ini ketika nilai argumen kueri adalah sesuatu selain CommonFileQuery.DefaultQuery. File diurutkan berdasarkan nilai yang ditentukan dari enumerasi CommonFileQuery . |
GetFilesAsync(CommonFileQuery, UInt32, UInt32) |
Mendapatkan rentang file berbasis indeks dari daftar semua file di folder saat ini. Juga mendapatkan file dari subfolder folder saat ini ketika nilai argumen kueri adalah sesuatu selain CommonFileQuery.DefaultQuery. File diurutkan berdasarkan nilai yang ditentukan dari enumerasi CommonFileQuery . |
GetFolderAsync(String) |
Mendapatkan subfolder dengan nama yang ditentukan dari folder saat ini. |
GetFolderFromPathAsync(String) |
Mendapatkan folder yang memiliki jalur absolut yang ditentukan dalam sistem file. |
GetFolderFromPathForUserAsync(User, String) |
Mendapatkan StorageFolder berdasarkan jalur absolut dalam sistem file untuk pengguna tertentu. |
GetFoldersAsync() |
Mendapatkan subfolder di folder saat ini. |
GetFoldersAsync(CommonFolderQuery) |
Mendapatkan subfolder di folder saat ini. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, mendapatkan daftar folder virtual yang mewakili kontainer untuk grup file di subfolder folder saat ini. File dikelompokkan ke dalam folder berdasarkan nilai yang ditentukan dari enumerasi CommonFolderQuery . |
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32) |
Mendapatkan rentang folder berbasis indeks dari daftar semua subfolder di folder saat ini. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, mendapatkan daftar folder virtual yang mewakili kontainer untuk grup file di subfolder folder saat ini. File dikelompokkan ke dalam folder berdasarkan nilai yang ditentukan dari enumerasi CommonFolderQuery . |
GetIndexedStateAsync() |
Mendapatkan status terindeks dari folder saat ini. |
GetItemAsync(String) |
Mendapatkan file atau folder dengan nama yang ditentukan dari folder saat ini. |
GetItemsAsync() |
Mendapatkan file dan subfolder di folder saat ini. |
GetItemsAsync(UInt32, UInt32) |
Mendapatkan rentang file dan folder berbasis indeks dari daftar semua file dan subfolder di folder saat ini. |
GetParentAsync() |
Mendapatkan folder induk folder saat ini. |
GetScaledImageAsThumbnailAsync(ThumbnailMode) |
Mendapatkan gambar berskala sebagai gambar mini, yang ditentukan oleh tujuan gambar mini. |
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) |
Mendapatkan gambar berskala sebagai gambar mini, ditentukan oleh tujuan gambar mini dan ukuran yang diminta. |
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Mendapatkan gambar berskala sebagai gambar mini, ditentukan oleh tujuan gambar mini, ukuran yang diminta, dan opsi yang ditentukan |
GetThumbnailAsync(ThumbnailMode) |
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan. |
GetThumbnailAsync(ThumbnailMode, UInt32) |
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan dan disesuaikan dengan ukuran yang diminta. |
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Mendapatkan gambar mini untuk folder saat ini, berukuran untuk tujuan gambar mini yang ditentukan dan disesuaikan dengan ukuran yang diminta dengan opsi yang ditentukan. |
IsCommonFileQuerySupported(CommonFileQuery) |
Menunjukkan apakah folder saat ini mendukung CommonFileQuery yang ditentukan. |
IsCommonFolderQuerySupported(CommonFolderQuery) |
Menunjukkan apakah folder saat ini mendukung CommonFolderQuery yang ditentukan. |
IsEqual(IStorageItem) |
Menunjukkan apakah folder saat ini sama dengan folder yang ditentukan. |
IsOfType(StorageItemTypes) |
Menunjukkan apakah StorageFolder saat ini cocok dengan nilai StorageItemTypes yang ditentukan. |
RenameAsync(String) |
Mengganti nama folder saat ini. |
RenameAsync(String, NameCollisionOption) |
Mengganti nama folder saat ini dan menentukan apa yang harus dilakukan jika folder dengan nama yang sama sudah ada. |
TryGetChangeTracker() |
Mendapatkan StorageLibraryChangeTracker yang terkait dengan StorageFolder. |
TryGetItemAsync(String) |
Mencoba mendapatkan file atau folder dengan nama yang ditentukan dari folder saat ini. Mengembalikan null alih-alih menaikkan FileNotFoundException jika file atau folder yang ditentukan tidak ditemukan. |