Partilhar via


StorageFile Classe

Definição

Representa um arquivo. Fornece informações sobre o arquivo e seu conteúdo e maneiras de manipulá-los.

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
Herança
Object Platform::Object IInspectable StorageFile
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

Exemplos

Este exemplo mostra como chamar um seletor de arquivos, usando FileOpenPicker.PickSingleFileAsync para capturar e processar um arquivo escolhido pelos usuários.

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
}

Após a conclusão de PickSingleFileAsync , file o obtém o arquivo escolhido como um StorageFile.

No exemplo, openPicker contém um objeto FileOpenPicker . Para saber mais sobre como usar o seletor de arquivos, consulte Abrir arquivos e pastas com um seletor.

Além disso, fileToken obtém um identificador que você pode usar para recuperar o arquivo de FutureAccessList. Para saber mais sobre como armazenar arquivos e pastas para que você possa acessá-los novamente mais tarde, consulte FutureAccessList, MostRecentlyUsedList e Track arquivos e pastas usados recentemente.

Comentários

Normalmente, você acessa objetos StorageFile como resultado de chamadas de função e/ou método assíncrono. Por exemplo, ambos os métodos estáticos GetFileFromPathAsync e GetFileFromApplicationUriAsync retornam um StorageFile que representa o arquivo especificado.

Além disso, sempre que você chamar um seletor de arquivos para permitir que o usuário escolha um arquivo (ou arquivos), o seletor de arquivos retornará o arquivo como um StorageFile.

Observação

Os objetos StorageFile não podem representar arquivos que são tipos de arquivo ".lnk", ".url" ou ".wsh".

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
2004 19041 GetFileFromPathForUserAsync

Propriedades

Attributes

Obtém os atributos de um arquivo.

ContentType

Obtém o tipo MIME do conteúdo do arquivo.

DateCreated

Obtém a data e a hora em que o arquivo atual foi criado.

DisplayName

Obtém um nome amigável para o arquivo.

DisplayType

Obtém uma descrição amigável do tipo do arquivo.

FileType

Obtém o tipo (extensão de nome de arquivo) do arquivo.

FolderRelativeId

Obtém um identificador para o arquivo. Essa ID é exclusiva para o resultado da consulta ou StorageFolder que contém o arquivo e pode ser usada para distinguir entre itens que têm o mesmo nome.

IsAvailable

Indica se o arquivo é local, é armazenado em cache localmente ou pode ser baixado.

Name

Obtém o nome do arquivo, incluindo a extensão de nome de arquivo.

Path

Obtém o caminho completo do sistema de arquivos do arquivo atual, se o arquivo tiver um caminho.

Properties

Obtém um objeto que fornece acesso às propriedades relacionadas ao conteúdo do arquivo.

Provider

Obtém o objeto StorageProvider que contém informações sobre o serviço que armazena o arquivo atual.

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 e renomeia a cópia.

CopyAsync(IStorageFolder, String, NameCollisionOption)

Cria uma cópia do arquivo na pasta especificada e renomeia a cópia. Esse método também especifica o que fazer se um arquivo com o mesmo nome já existir na pasta de destino.

CreateStreamedFileAsync(String, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)

Cria um StorageFile para representar o fluxo de dados especificado. Esse método permite que o aplicativo produza os dados sob demanda especificando uma função a ser invocada quando o StorageFile que representa o fluxo for acessado pela primeira vez.

CreateStreamedFileFromUriAsync(String, Uri, IRandomAccessStreamReference)

Cria um StorageFile para representar um fluxo de dados do recurso URI (Uniform Resource Identifier) especificado. Esse método permite que o aplicativo baixe os dados sob demanda quando o StorageFile que representa o fluxo é acessado pela primeira vez.

DeleteAsync()

Exclui o arquivo atual.

DeleteAsync(StorageDeleteOption)

Exclui o arquivo atual, excluindo o item permanentemente.

GetBasicPropertiesAsync()

Obtém as propriedades básicas do arquivo atual.

GetFileFromApplicationUriAsync(Uri)

Obtém um objeto StorageFile para representar o recurso de aplicativo URI (Uniform Resource Identifier) especificado. Para obter exemplos de URIs de exemplo , consulte Carregar imagens e ativos personalizados para escala, tema, alto contraste e outros.

GetFileFromPathAsync(String)

Obtém um objeto StorageFile para representar o arquivo no caminho especificado.

GetFileFromPathForUserAsync(User, String)

Obtém um objeto StorageFile com base em um caminho absoluto no sistema de arquivos para um determinado usuário.

GetParentAsync()

Obtém a pasta pai do arquivo atual.

GetScaledImageAsThumbnailAsync(ThumbnailMode)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura e pelo tamanho solicitado.

GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas

GetThumbnailAsync(ThumbnailMode)

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura.

GetThumbnailAsync(ThumbnailMode, UInt32)

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura e pelo tamanho solicitado.

GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

Recupera uma imagem em miniatura ajustada para o arquivo, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas.

IsEqual(IStorageItem)

Indica se o arquivo atual é igual ao arquivo especificado.

IsOfType(StorageItemTypes)

Determina se StorageFile atual corresponde ao valor StorageItemTypes especificado.

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 com as opções especificadas sobre o arquivo especificado.

OpenAsync(FileAccessMode, StorageOpenOptions)

Abre um fluxo de acesso aleatório com as opções especificadas sobre o arquivo especificado.

OpenReadAsync()

Abre um fluxo de acesso aleatório sobre o arquivo atual para ler o conteúdo do arquivo.

OpenSequentialReadAsync()

Abre um fluxo de acesso sequencial sobre o arquivo atual para ler o conteúdo do arquivo.

OpenTransactedWriteAsync()

Abre um fluxo de acesso aleatório para o arquivo que pode ser usado para operações de gravação transacionada.

OpenTransactedWriteAsync(StorageOpenOptions)

Abre um fluxo de acesso aleatório para o arquivo que pode ser usado para operações de gravação transacionada com as opções especificadas.

RenameAsync(String)

Renomeia o arquivo atual.

RenameAsync(String, NameCollisionOption)

Renomeia o arquivo atual. Esse método também especifica o que fazer se um item existente no local do arquivo atual tiver o mesmo nome.

ReplaceWithStreamedFileAsync(IStorageFile, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)

Substitui o conteúdo do arquivo referenciado pelo objeto IStorageFile especificado por um novo fluxo de dados. Esse método permite que o aplicativo produza os dados sob demanda especificando uma função a ser invocada quando o StorageFile que representa o fluxo for acessado pela primeira vez.

ReplaceWithStreamedFileFromUriAsync(IStorageFile, Uri, IRandomAccessStreamReference)

Substitui o conteúdo do arquivo referenciado pelo objeto IStorageFile especificado por um novo fluxo de dados do URI (Uniform Resource Identifier) especificado. Esse método permite que o aplicativo baixe os dados sob demanda quando o StorageFile que representa o fluxo é acessado pela primeira vez.

O fluxo de dados é acessado por meio do StorageFile retornado e os dados são baixados sob demanda quando StorageFile é acessado pela primeira vez.

Substitui o objeto IStorageFile que representa o arquivo especificado por um novo StorageFile que fornece um fluxo do URI (Uniform Resource Identifier) especificado.

Aplica-se a

Confira também