IStorageFile Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um arquivo. Fornece informações sobre o arquivo e seu conteúdo e maneiras de manipulá-los.
Importante
Se você simplesmente quiser trabalhar com arquivos em seu aplicativo, consulte a classe 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- Derivado
- Atributos
- Implementações
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
| Funcionalidades do aplicativo |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
Propriedades
| Attributes |
Obtém os atributos de um item de armazenamento. (Herdado de IStorageItem) |
| ContentType |
Obtém o tipo MIME do conteúdo do arquivo. |
| DateCreated |
Obtém a data e a hora em que o item atual foi criado. (Herdado de IStorageItem) |
| FileType |
Obtém o tipo (extensão de nome de arquivo) do arquivo. |
| Name |
Obtém o nome do item, incluindo a extensão de nome de arquivo, se houver um. (Herdado de IStorageItem) |
| Path |
Obtém o caminho completo do sistema de arquivos do item, se o item tiver um caminho. (Herdado de IStorageItem) |
Métodos
| CopyAndReplaceAsync(IStorageFile) |
Substitui o arquivo especificado por uma cópia do arquivo atual. |
| CopyAsync(IStorageFolder) |
Cria uma cópia do arquivo na pasta especificada. |
| CopyAsync(IStorageFolder, String) |
Cria uma cópia do arquivo na pasta especificada, usando o nome desejado. |
| CopyAsync(IStorageFolder, String, NameCollisionOption) |
Cria uma cópia do arquivo na pasta especificada, usando o nome desejado. Esse método também especifica o que fazer se um arquivo existente na pasta especificada tiver o mesmo nome. |
| DeleteAsync() |
Exclui o item atual. (Herdado de IStorageItem) |
| DeleteAsync(StorageDeleteOption) |
Exclui o item atual, excluindo-o permanentemente. (Herdado de IStorageItem) |
| GetBasicPropertiesAsync() |
Obtém as propriedades básicas do item atual (como um arquivo ou pasta). (Herdado de IStorageItem) |
| IsOfType(StorageItemTypes) |
Determina se o IStorageItem atual corresponde ao valor StorageItemTypes especificado. (Herdado de IStorageItem) |
| MoveAndReplaceAsync(IStorageFile) |
Move o arquivo atual para o local do arquivo especificado e substitui o arquivo especificado nesse local. |
| MoveAsync(IStorageFolder) |
Move o arquivo atual para a pasta especificada. |
| MoveAsync(IStorageFolder, String) |
Move o arquivo atual para a pasta especificada e renomeia o arquivo de acordo com o nome desejado. |
| MoveAsync(IStorageFolder, String, NameCollisionOption) |
Move o arquivo atual para a pasta especificada e renomeia o arquivo de acordo com o nome desejado. Esse método também especifica o que fazer se já existir um arquivo com o mesmo nome na pasta especificada. |
| OpenAsync(FileAccessMode) |
Abre um fluxo de acesso aleatório sobre o arquivo. |
| OpenReadAsync() |
Abre um fluxo para acesso aleatório. (Herdado de IRandomAccessStreamReference) |
| OpenSequentialReadAsync() |
Abre um fluxo para acesso de leitura sequencial. (Herdado de IInputStreamReference) |
| OpenTransactedWriteAsync() |
Abre um fluxo de acesso aleatório transacionado para gravação no arquivo. |
| RenameAsync(String) |
Renomeia o item atual. (Herdado de IStorageItem) |
| RenameAsync(String, NameCollisionOption) |
Renomeia o item atual. Esse método também especifica o que fazer se um item existente no local do item atual tiver o mesmo nome. (Herdado de IStorageItem) |