IStorageFile Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет файл. Предоставляет сведения о файле и его содержимом, а также способы управления ими.
Важно!
Если вы просто хотите работать с файлами в приложении, см. класс StorageFile .
public interface class IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReference/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(4198457734, 16916, 17036, 166, 76, 20, 201, 172, 115, 21, 234)]
struct IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReference[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(4198457734, 16916, 17036, 166, 76, 20, 201, 172, 115, 21, 234)]
public interface IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReferencePublic Interface IStorageFile
Implements IInputStreamReference, IRandomAccessStreamReference, IStorageItem- Производный
- Атрибуты
- Реализации
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
| Возможности приложения |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
Свойства
| Attributes |
Возвращает атрибуты элемента хранилища. (Унаследовано от IStorageItem) |
| ContentType |
Возвращает тип MIME содержимого файла. |
| DateCreated |
Возвращает дату и время создания текущего элемента. (Унаследовано от IStorageItem) |
| FileType |
Возвращает тип (расширение имени файла) файла. |
| Name |
Возвращает имя элемента, включая расширение имени файла, если оно есть. (Унаследовано от IStorageItem) |
| Path |
Возвращает полный путь к элементу в файловой системе, если элемент имеет путь. (Унаследовано от IStorageItem) |
Методы
| CopyAndReplaceAsync(IStorageFile) |
Заменяет указанный файл копией текущего файла. |
| CopyAsync(IStorageFolder) |
Создает копию файла в указанной папке. |
| CopyAsync(IStorageFolder, String) |
Создает копию файла в указанной папке, используя нужное имя. |
| CopyAsync(IStorageFolder, String, NameCollisionOption) |
Создает копию файла в указанной папке, используя нужное имя. Этот метод также указывает, что делать, если существующий файл в указанной папке имеет то же имя. |
| DeleteAsync() |
Удаляет текущий элемент. (Унаследовано от IStorageItem) |
| DeleteAsync(StorageDeleteOption) |
Удаляет текущий элемент, при необходимости удаляя его безвозвратно. (Унаследовано от IStorageItem) |
| GetBasicPropertiesAsync() |
Возвращает основные свойства текущего элемента (например, файла или папки). (Унаследовано от IStorageItem) |
| IsOfType(StorageItemTypes) |
Определяет, соответствует ли текущий объект IStorageItem указанному значению StorageItemTypes . (Унаследовано от IStorageItem) |
| MoveAndReplaceAsync(IStorageFile) |
Перемещает текущий файл в расположение указанного файла и заменяет указанный файл в этом расположении. |
| MoveAsync(IStorageFolder) |
Перемещает текущий файл в указанную папку. |
| MoveAsync(IStorageFolder, String) |
Перемещает текущий файл в указанную папку и переименовывает файл в соответствии с нужным именем. |
| MoveAsync(IStorageFolder, String, NameCollisionOption) |
Перемещает текущий файл в указанную папку и переименовывает файл в соответствии с нужным именем. Этот метод также указывает, что делать, если файл с таким именем уже существует в указанной папке. |
| OpenAsync(FileAccessMode) |
Открывает поток произвольного доступа к файлу. |
| OpenReadAsync() |
Открывает поток для произвольного доступа. (Унаследовано от IRandomAccessStreamReference) |
| OpenSequentialReadAsync() |
Открывает поток для последовательного доступа на чтение. (Унаследовано от IInputStreamReference) |
| OpenTransactedWriteAsync() |
Открывает поток произвольного доступа с транзакцией для записи в файл. |
| RenameAsync(String) |
Переименовывает текущий элемент. (Унаследовано от IStorageItem) |
| RenameAsync(String, NameCollisionOption) |
Переименовывает текущий элемент. Этот метод также указывает, что делать, если существующий элемент в расположении текущего элемента имеет то же имя. (Унаследовано от IStorageItem) |