Bagikan melalui


KnownFolders Kelas

Definisi

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

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 .

Info selengkapnya

Berikut cara mengakses beberapa lokasi lain yang umum digunakan.

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

Lihat juga