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 KnownFoldersPublic Class KnownFolders- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
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 |
Свойства
| AppCaptures |
Возвращает папку App Captures. |
| CameraRoll |
Возвращает папку Camera Roll. |
| DocumentsLibrary |
Возвращает библиотеку документов. Библиотека документов не предназначена для общего использования. |
| HomeGroup |
Возвращает папку HomeGroup. |
| MediaServerDevices |
Возвращает папку серверов мультимедиа (DLNA) устройств. |
| MusicLibrary |
Возвращает библиотеку "Музыка". |
| Objects3D |
Возвращает трехмерную папку Objects. |
| PicturesLibrary |
Возвращает библиотеку рисунков. |
| Playlists |
Возвращает папку списков воспроизведения. |
| RecordedCalls |
Возвращает папку записанных вызовов. |
| RemovableDevices |
Возвращает папку съемных устройств. |
| SavedPictures |
Возвращает папку Сохраненные изображения. |
| VideosLibrary |
Возвращает библиотеку видео. |
Методы
| GetFolderAsync(KnownFolderId) |
Извлекает папку для указанного folderId. |
| GetFolderForUserAsync(User, KnownFolderId) |
Статический метод, возвращающий указанную известную папку для пользователя. |
| RequestAccessAsync(KnownFolderId) |
Запрашивает доступ для возможности управления доступом к папке. |
| RequestAccessForUserAsync(User, KnownFolderId) |
Запрашивает доступ для пользователя и folderId. |