Bagikan melalui


StorageFolder Kelas

Definisi

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
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, 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

Lihat juga