KnownFolders Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к общим расположениям, содержащим содержимое пользователя. Сюда входит содержимое из локальных библиотек пользователя (например, "Документы", "Изображения", "Музыка" и "Видео"), домашней группы, съемных устройств и устройств сервера мультимедиа.
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
- Наследование
- Атрибуты
Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
В примере доступа к файлу показано, как использовать свойство PicturesLibrary для создания нового файла в библиотеке рисунков.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.
После завершения метода CreateFileAsync переменная содержит файл StorageFile, file
представляющий новый файл.
Этот класс является статическим и не может быть создан. Доступ к его свойствам напрямую, как показано в следующем примере.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
Чтобы получить доступ к папкам и библиотекам, представленным свойствами этого класса, укажите соответствующие возможности в манифесте приложения. Например, чтобы получить доступ к KnownFolders.PicturesLibrary, укажите возможность "Библиотека рисунков" в манифесте приложения. Дополнительные сведения о возможностях см. в статье Объявления возможностей приложений.
Свойства класса KnownFolders возвращают объект StorageFolder. Чтобы работать с известной папкой и ее содержимым, вызовите методы и свойства класса StorageFolder .
- Сведения об использовании изображений, музыки и видео в приложении см. в статье Звук, видео и камера.
- Общие сведения об использовании файлов и папок см. в разделе Перечисление и запрос файлов и папок.
Вот как получить доступ к некоторым другим часто используемым расположениям.
- Получите локальную папку приложения из свойства Windows.Storage.ApplicationData.Current.LocalFolder .
- Получите папку установки приложения из свойства Windows.ApplicationModel.Package.Current.InstalledLocation .
Дополнительные сведения о расположениях, к которым может получить доступ ваше приложение, см. в статье Разрешения на доступ к файлам.
Версия Windows | Версия пакета SDK | Добавленная стоимость |
---|---|---|
1511 | 10586 | GetFolderForUserAsync |
2004 | 19041 | GetFolderAsync |
2004 | 19041 | RequestAccessAsync |
2004 | 19041 | RequestAccessForUserAsync |
App |
Возвращает папку App Captures. |
Camera |
Возвращает папку Camera Roll. |
Documents |
Возвращает библиотеку документов. Библиотека документов не предназначена для общего использования. |
Home |
Возвращает папку HomeGroup. |
Media |
Возвращает папку серверов мультимедиа (DLNA) устройств. |
Music |
Возвращает библиотеку "Музыка". |
Objects3D |
Возвращает трехмерную папку Objects. |
Pictures |
Возвращает библиотеку рисунков. |
Playlists |
Возвращает папку списков воспроизведения. |
Recorded |
Возвращает папку записанных вызовов. |
Removable |
Возвращает папку съемных устройств. |
Saved |
Возвращает папку Сохраненные изображения. |
Videos |
Возвращает библиотеку видео. |
Get |
Извлекает папку для указанного folderId. |
Get |
Статический метод, возвращающий указанную известную папку для пользователя. |
Request |
Запрашивает доступ для возможности управления доступом к папке. |
Request |
Запрашивает доступ для пользователя и folderId. |