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, IRandomAccessStreamReference
Public 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)

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

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