StorageFile Класс

Ссылка

Определение

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

Важно!

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

Изменить

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

public ref class StorageFile sealed : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFile final : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFile : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Public NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Наследование: Object IInspectable StorageFile

Атрибуты: ContractVersionAttribute

Реализации: IStorageFile IStorageFile2 IStorageFilePropertiesWithAvailability IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IInputStreamReference IRandomAccessStreamReference

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)
Возможности приложения	documentsLibrary musicLibrary picturesLibrary videosLibrary

Примеры

В этом примере показано, как вызвать средство выбора файлов с помощью FileOpenPicker.PickSingleFileAsync для записи и обработки файла, выбранного пользователями.

var openPicker = new FileOpenPicker();
StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
    // Store file for future access
    Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
    // The user didn't pick a file
}

После завершения filePickSingleFileAsync получает выбранный файл в виде файла StorageFile.

В этом примере openPicker содержится объект FileOpenPicker . Дополнительные сведения об использовании средства выбора файлов см. в статье "Открытие файлов и папок" с помощью средства выбора.

Кроме того, получает идентификатор, fileToken который можно использовать для получения файла из FutureAccessList. Дополнительные сведения о хранении файлов и папок, чтобы получить к ним доступ позже, см. в статье FutureAccessList, MostRecentlyUsedList и Track, недавно использовавшиеся файлы и папки.

Как правило, доступ к объектам StorageFile выполняется в результате асинхронных вызовов методов и (или) функций. Например, оба статических метода GetFileFromPathAsync и GetFileFromApplicationUriAsync возвращают файл StorageFile, представляющий указанный файл.

Кроме того, каждый раз, когда вы вызываете средство выбора файлов, чтобы пользователь выбрал файл (или файлы), средство выбора файлов вернет файл в виде StorageFile.

Примечание

Объекты StorageFile не могут представлять файлы, которые являются типами файлов ".lnk", ".url" или ".wsh.

Журнал версий

Версия Windows	Версия пакета SDK	Добавлено значение
2004	19041	GetFileFromPathForUserAsync

Свойства

Attributes	Возвращает атрибуты файла.
ContentType	Возвращает тип MIME содержимого файла.
DateCreated	Возвращает дату и время создания текущего файла.
DisplayName	Возвращает понятное имя файла.
DisplayType	Возвращает понятное описание типа файла.
FileType	Возвращает тип (расширение имени файла) файла.
FolderRelativeId	Возвращает идентификатор файла. Этот идентификатор уникален для результата запроса или StorageFolder , содержащего файл, и может использоваться для различения элементов с одинаковым именем.
IsAvailable	Указывает, является ли файл локальным, кэширован локально или можно скачать.
Name	Возвращает имя файла, включая расширение имени файла.
Path	Получает полный путь к файловой системе текущего файла, если файл имеет путь.
Properties	Возвращает объект, предоставляющий доступ к свойствам, связанным с содержимым файла.
Provider	Возвращает объект StorageProvider , содержащий сведения о службе, в котором хранится текущий файл.

Методы

CopyAndReplaceAsync(IStorageFile)	Заменяет указанный файл копией текущего файла.
CopyAsync(IStorageFolder)	Создает копию файла в указанной папке.
CopyAsync(IStorageFolder, String)	Создает копию файла в указанной папке и переименовывает копию.
CopyAsync(IStorageFolder, String, NameCollisionOption)	Создает копию файла в указанной папке и переименовывает копию. Этот метод также указывает, что делать, если файл с тем же именем уже существует в конечной папке.
CreateStreamedFileAsync(String, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)	Создает StorageFile для представления указанного потока данных. Этот метод позволяет приложению создавать данные по запросу, указывая функцию, вызываемую при первом обращении к StorageFile , представляющей поток.
CreateStreamedFileFromUriAsync(String, Uri, IRandomAccessStreamReference)	Создает StorageFile для представления потока данных из указанного ресурса универсального кода ресурса (URI). Этот метод позволяет приложению скачивать данные по запросу при первом обращении к StorageFile , представляющего поток.
DeleteAsync()	Удаляет текущий файл.
DeleteAsync(StorageDeleteOption)	Удаляет текущий файл, при необходимости удаляя элемент без возможности восстановления.
GetBasicPropertiesAsync()	Возвращает основные свойства текущего файла.
GetFileFromApplicationUriAsync(Uri)	Возвращает объект StorageFile для представления указанного ресурса приложения универсального кода ресурса (URI). Примеры примеров URI см. в разделе "Загрузка изображений и ресурсов", адаптированных для масштабирования, темы, высокой контрастности и других.
GetFileFromPathAsync(String)	Возвращает объект StorageFile для представления файла по указанному пути.
GetFileFromPathForUserAsync(User, String)	Возвращает объект StorageFile на основе абсолютного пути в файловой системе для заданного пользователя.
GetParentAsync()	Возвращает родительскую папку текущего файла.
GetScaledImageAsThumbnailAsync(ThumbnailMode)	Получает масштабированное изображение в виде эскиза, определяемого назначением эскиза.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	Возвращает масштабируемое изображение в виде эскиза, определяемого назначением эскиза и запрошенного размера.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Возвращает масштабируемое изображение в виде эскиза, определяемого назначением эскиза, запрошенным размером и указанными параметрами.
GetThumbnailAsync(ThumbnailMode)	Извлекает измененное изображение эскиза для файла, определяемое назначением эскиза.
GetThumbnailAsync(ThumbnailMode, UInt32)	Извлекает измененное изображение эскиза для файла, определяемое назначением эскиза и запрошенным размером.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Извлекает измененное изображение эскиза для файла, определяемое назначением эскиза, запрошенным размером и указанными параметрами.
IsEqual(IStorageItem)	Указывает, равен ли текущий файл указанному файлу.
IsOfType(StorageItemTypes)	Определяет, соответствует ли текущий файл StorageFile указанному значению StorageItemTypes .
MoveAndReplaceAsync(IStorageFile)	Перемещает текущий файл в расположение указанного файла и заменяет указанный файл в этом расположении.
MoveAsync(IStorageFolder)	Перемещает текущий файл в указанную папку.
MoveAsync(IStorageFolder, String)	Перемещает текущий файл в указанную папку и переименовывает файл в соответствии с нужным именем.
MoveAsync(IStorageFolder, String, NameCollisionOption)	Перемещает текущий файл в указанную папку и переименовывает файл в соответствии с нужным именем. Этот метод также указывает, что делать, если файл с тем же именем уже существует в указанной папке.
OpenAsync(FileAccessMode)	Открывает поток произвольного доступа с указанными параметрами по указанному файлу.
OpenAsync(FileAccessMode, StorageOpenOptions)	Открывает поток произвольного доступа с указанными параметрами по указанному файлу.
OpenReadAsync()	Открывает поток произвольного доступа по текущему файлу для чтения содержимого файла.
OpenSequentialReadAsync()	Открывает поток последовательного доступа по текущему файлу для чтения содержимого файла.
OpenTransactedWriteAsync()	Открывает поток произвольного доступа к файлу, который можно использовать для операций записи с транзакцией.
OpenTransactedWriteAsync(StorageOpenOptions)	Открывает поток произвольного доступа к файлу, который можно использовать для операций с транзакцией и записью с указанными параметрами.
RenameAsync(String)	Переименовывает текущий файл.
RenameAsync(String, NameCollisionOption)	Переименовывает текущий файл. Этот метод также указывает, что делать, если существующий элемент в расположении текущего файла имеет то же имя.
ReplaceWithStreamedFileAsync(IStorageFile, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)	Заменяет содержимое файла, на который ссылается указанный объект IStorageFile , новым потоком данных. Этот метод позволяет приложению создавать данные по запросу, указывая функцию, вызываемую при первом обращении к StorageFile , представляющей поток.
ReplaceWithStreamedFileFromUriAsync(IStorageFile, Uri, IRandomAccessStreamReference)	Заменяет содержимое файла, на который ссылается указанный объект IStorageFile , новым потоком данных указанного универсального идентификатора ресурса (URI). Этот метод позволяет приложению скачивать данные по запросу при первом обращении к StorageFile , представляющего поток. Доступ к потоку данных осуществляется через возвращаемый файл StorageFile , и данные загружаются по запросу при первом обращении к StorageFile . Заменяет объект IStorageFile , представляющий указанный файл новым файлом StorageFile , который предоставляет поток указанного универсального идентификатора ресурса (URI).

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

StorageFile Класс

Определение

Требования к Windows

Примеры

Комментарии

Журнал версий

Свойства

Методы

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

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

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

Дополнительные ресурсы