KnownFolders 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

Menyediakan akses ke lokasi umum yang berisi konten pengguna. Ini termasuk konten dari pustaka lokal pengguna (seperti Dokumen, Gambar, Musik, dan Video), GrupRumah, perangkat yang dapat dilepas, dan perangkat server media.

public ref class KnownFolders abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KnownFolders final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class KnownFolders

Public Class KnownFolders

Warisan: Object Platform::Object IInspectable KnownFolders

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Sampel Akses file memperlihatkan kepada Anda cara menggunakan properti PicturesLibrary untuk membuat file baru di pustaka Gambar.

StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.

Setelah metode CreateFileAsync selesai, file variabel berisi StorageFile yang mewakili file baru.

Keterangan

Kelas ini statis dan tidak dapat diinstansiasi. Akses propertinya secara langsung, seperti yang diperlihatkan dalam contoh berikut.

StorageFolder storageFolder = KnownFolders.PicturesLibrary;

Prasyarat

Untuk mengakses folder dan pustaka yang diwakili oleh properti kelas ini, tentukan kemampuan yang sesuai dalam manifes aplikasi Anda. Misalnya, untuk mengakses KnownFolders.PicturesLibrary, tentukan kemampuan Pustaka Gambar dalam manifes aplikasi. Pelajari selengkapnya tentang kemampuan dalam Deklarasi kemampuan aplikasi.

Nilai kembali

Properti kelas KnownFolders mengembalikan StorageFolder. Untuk bekerja dengan folder yang diketahui dan kontennya, panggil metode dan properti kelas StorageFolder .

Untuk informasi tentang cara menggunakan gambar, musik, dan video di aplikasi Anda, lihat Audio, video, dan kamera.
Untuk informasi umum tentang cara menggunakan file dan folder, lihat Menghitung dan mengkueri file dan folder.

Info selengkapnya

Berikut cara mengakses beberapa lokasi lain yang umum digunakan.

Dapatkan folder lokal aplikasi dari properti Windows.Storage.ApplicationData.Current.LocalFolder .
Dapatkan folder penginstalan aplikasi dari properti Windows.ApplicationModel.Package.Current.InstalledLocation .

Untuk mempelajari selengkapnya tentang lokasi yang dapat diakses aplikasi Anda, lihat Izin akses file.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1511	10586	GetFolderForUserAsync
2004	19041	GetFolderAsync
2004	19041	RequestAccessAsync
2004	19041	RequestAccessForUserAsync

Properti

AppCaptures	Mendapatkan folder Pengambilan Aplikasi.
CameraRoll	Mendapatkan folder Rol Kamera.
DocumentsLibrary	Mendapatkan pustaka Dokumen. Pustaka Dokumen tidak ditujukan untuk penggunaan umum.
HomeGroup	Mendapatkan folder GrupRumah.
MediaServerDevices	Mendapatkan folder perangkat server media (Digital Living Network Alliance (DLNA)..
MusicLibrary	Mendapatkan pustaka Musik.
Objects3D	Mendapatkan folder 3D Objek.
PicturesLibrary	Mendapatkan pustaka Gambar.
Playlists	Mendapatkan folder daftar putar.
RecordedCalls	Mendapatkan folder panggilan yang direkam.
RemovableDevices	Mendapatkan folder perangkat yang dapat dilepas.
SavedPictures	Mendapatkan folder Gambar Tersimpan.
VideosLibrary	Mendapatkan pustaka Video.

Metode

GetFolderAsync(KnownFolderId)	Mengambil folder untuk folderId yang ditentukan.
GetFolderForUserAsync(User, KnownFolderId)	Metode statis yang mengembalikan folder yang diketahui tertentu untuk Pengguna.
RequestAccessAsync(KnownFolderId)	Meminta akses untuk kemampuan yang mengontrol akses ke folder.
RequestAccessForUserAsync(User, KnownFolderId)	Meminta akses untuk pengguna dan folderId.

Berlaku untuk