StorageFolder Kelas

Referensi

Definisi

Ruang nama:: Windows.Storage

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.

Edit

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: Object Platform::Object IInspectable StorageFolder

Atribut: ContractVersionAttribute

Penerapan: IStorageFolder IStorageFolder2 IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IStorageFolderQueryOperations

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, `JPEG image`.
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.

Berlaku untuk