Поделиться через


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
Наследование
Object Platform::Object IInspectable 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 Версия пакета 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.

Применяется к

См. также раздел