Windows.Storage Пространство имен

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Предоставляет классы для управления файлами, папками и параметрами приложения.

Сведения об использовании объектов в Windows. Пространство имен хранилища см. в следующих разделах.

Классы

Имя.	Описание
AppDataPaths	AppDataPaths возвращает пути к часто используемым папкам приложений на основе шаблона именования KNOWNFOLDERID .
ApplicationData	Предоставляет доступ к хранилищу данных приложения. Данные приложения состоят из файлов и параметров, которые являются локальными, перемещаемыми или временными.
ApplicationDataCompositeValue	Представляет связанные параметры приложения, которые должны быть сериализованы и десериализированы атомарно.
ApplicationDataContainer	Представляет контейнер для параметров приложения. Методы и свойства этого класса поддерживают создание, удаление, перечисление и обход иерархии контейнеров.
ApplicationDataContainerSettings	Предоставляет доступ к параметрам в контейнере параметров. Свойство ApplicationDataContainer.Values возвращает объект, который можно привести к этому типу.
CachedFileManager	Позволяет приложениям управлять обновлениями в режиме реального времени для файлов.
DownloadsFolder	Создает файлы и папки в папке Downloads.
FileIO	Предоставляет вспомогательные методы для чтения и записи файлов, представленных объектами типа IStorageFile.
KnownFolders	Предоставляет доступ к общим расположениям, содержащим содержимое пользователя. Это включает содержимое из локальных библиотек пользователя (таких как документы, рисунки, музыка и видео), Домашняя группа, съемные устройства и устройства сервера мультимедиа.
PathIO	Предоставляет вспомогательные методы для чтения и записи файла с помощью абсолютного пути или универсального идентификатора ресурса (URI) файла.
SetVersionDeferral	Управляет операцией с отложенной версией набора.
SetVersionRequest	Предоставляет данные, когда приложение задает версию данных приложения в хранилище данных приложения.
StorageFile	Представляет файл. Предоставляет сведения о файле и его содержимом и способах управления ими.
StorageFolder	Управляет папками и их содержимым и предоставляет сведения о них.
StorageLibrary	Позволяет добавлять и удалять папки из библиотеки, например "Музыка" или "Видео", и позволяет получить список папок, включенных в библиотеку.
StorageLibraryChange	Представляет изменение элемента в библиотеке хранилища, например документов, музыки или видео библиотеки.
StorageLibraryChangeReader	Позволяет вызывающему приложению считывать изменения элементов в библиотеке хранилища.
StorageLibraryChangeTracker	Предоставляет API-интерфейсы, которые можно использовать для управления отслеживанием изменений для любой библиотеки (например, документов, музыки или видео) или папок.
StorageLibraryChangeTrackerOptions	Позволяет вызывающим абонентам вызывать EnableWithOptions в средстве отслеживания изменений, чтобы отслеживать все изменения, включая идентификатор последнего изменения или только последний идентификатор изменения.
StorageLibraryLastChangeId	Позволяет отслеживать изменения на основе уникального значения, представляющего последнее изменение, обработанное службой индексирования для заданного хранилищаFolder или StorageLibrary.
StorageProvider	Содержит сведения о службе, в которой хранятся файлы и папки. Файлы и папки могут храниться локальной файловой системой или удаленной службой, например Microsoft OneDrive.
StorageStreamTransaction	Представляет транзакцию записи для потока случайного доступа.
StreamedFileDataRequest	Представляет поток выходных данных с последовательным доступом, указывающий запрос на поток данных хранилища, созданный путем вызова CreateStreamedFileAsync или ReplaceWithStreamedFileAsync.
SystemAudioProperties	Вспомогательный объект, предоставляющий имена индексирования для свойств аудиофайла Windows.
SystemDataPaths	Возвращает некоторые часто используемые расположения системных папок на основе шаблона именования KNOWNFOLDERID .
SystemGPSProperties	Вспомогательный объект, предоставляющий индексирование имен для свойств файлов GPS.
SystemImageProperties	Вспомогательный объект, предоставляющий имена индексирования для свойств файла изображения Windows.
SystemMediaProperties	Вспомогательный объект, предоставляющий имена индексирования для свойств файла мультимедиа Windows.
SystemMusicProperties	Вспомогательный объект, предоставляющий имена индексирования для свойств файла музыки Windows.
SystemPhotoProperties	Вспомогательный объект, предоставляющий имена индексирования для свойств файла фотографий Windows.
SystemProperties	Предоставляет строковые значения для индексирования имен общих свойств файла Windows, таких как System.Title, а также ссылается на вспомогательные объекты, предоставляющие имена индексирования свойств определенных типов файлов (например, видеофайлы).
SystemVideoProperties	Вспомогательный объект, предоставляющий имена индексирования свойств видеофайла.
UserDataPaths	Возвращает полные пути для общих папок данных пользователя. Папки данных пользователя основаны на шаблоне именования KNOWNFOLDERID .

Интерфейсы

Имя.	Описание
IStorageFile	Представляет файл. Предоставляет сведения о файле и его содержимом и способах управления ими. Important Если вы просто хотите работать с файлами в приложении, см. класс StorageFile .
IStorageFile2	Представляет файл. Предоставляет сведения о файле и его содержимом и способах управления ими. Important Если вы просто хотите работать с файлами в приложении, см. класс StorageFile .
IStorageFilePropertiesWithAvailability	Предоставляет доступ к свойству IsAvailable .
IStorageFolder	Управляет папками и их содержимым и предоставляет сведения о них. Important Если вы просто хотите работать с папками в приложении, см. класс StorageFolder .
IStorageFolder2	Управляет папками и их содержимым и предоставляет сведения о них. Important Если вы просто хотите работать с папками в приложении, см. класс StorageFolder .
IStorageItem	Управляет элементами хранилища (файлами и папками) и их содержимым и предоставляет сведения о них. Important Если вы просто хотите работать с файлами и папками в приложении, см. классы StorageFile и StorageFolder .
IStorageItem2	Управляет элементами хранилища (файлами и папками) и их содержимым и предоставляет сведения о них. Important Если вы просто хотите работать с файлами и папками в приложении, см. классы StorageFile и StorageFolder .
IStorageItemProperties	Предоставляет доступ к общим свойствам содержимого для элементов (например, файлов и папок).
IStorageItemProperties2	Предоставляет доступ к методам, которые получают масштабируемое изображение в виде эскиза.
IStorageItemPropertiesWithProvider	Предоставляет доступ к общим и свойствам содержимого для элементов хранения из определенного поставщика.
IStreamedFileDataRequest	Представляет поток выходных данных с последовательным доступом, указывающий запрос на поток данных хранилища, созданный путем вызова CreateStreamedFileAsync или ReplaceWithStreamedFileAsync.

Перечисления

Имя.	Описание
ApplicationDataCreateDisposition	Задает параметры для создания контейнеров данных приложения или возврата существующих контейнеров. Это перечисление используется методом ApplicationDataContainer.CreateContainer .
ApplicationDataLocality	Указывает тип хранилища данных приложения.
CreationCollisionOption	Указывает, что делать, если файл или папка с указанным именем уже существует в текущей папке при создании нового файла или папки.
FileAccessMode	Указывает, следует ли получить доступ к файлу в режиме только для чтения или записи.
FileAttributes	Описывает атрибуты файла или папки.
KnownFolderId	Предоставляет значения, определяющие папки хранилища.
KnownFoldersAccessStatus	Описывает доступ известной папки к одной возможности.
KnownLibraryId	Предоставляет значения, определяющие библиотеки хранилища.
NameCollisionOption	Указывает, что делать, если файл или папка с указанным именем уже существует в текущей папке при копировании, перемещении или переименовании файла или папки.
StorageDeleteOption	Указывает, перемещается ли удаленный элемент в корзину или окончательно удаляется.
StorageItemTypes	Описывает, является ли элемент, реализующий интерфейс IStorageItem , файлом или папкой.
StorageLibraryChangeType	Описывает тип изменения, которое произошло с элементом библиотеки хранилища.
StorageOpenOptions	Предоставляет параметры для использования при открытии файла.
StreamedFileFailureMode	Указывает причину, по которой не удалось передавать данные.

Делегаты

Имя.	Описание
ApplicationDataSetVersionHandler	Представляет метод, который обрабатывает запрос, чтобы задать версию данных приложения в хранилище данных приложения.
StreamedFileDataRequestedHandler	Представляет метод, который будет передавать данные в StorageFile при первом доступе к файлу.

Совместимость платформы приложений: Windows. API хранилища доступны для классических приложений Windows App SDK (WinUI 3) и классических приложений Win32, а не только приложений UWP. Классические приложения могут использовать такие классы, как StorageFile, StorageFolder и ApplicationData с помощью C#/WinRT или C++/WinRT. Для некоторых API (например, средства выбора файлов) требуется дополнительная настройка в распакованных классических приложениях. Дополнительные сведения см. в разделе "Вызов среда выполнения Windows API" в классических приложениях.

См. также

Обратная связь

Были ли сведения на этой странице полезными?