Windows.Storage Namespace
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.
Fornece classes para gerenciar arquivos, pastas e configurações de aplicativo.
Para obter informações sobre como usar os objetos no Windows. Namespace de armazenamento, consulte as seções a seguir.
Classes
| Nome | Description |
|---|---|
| AppDataPaths |
AppDataPaths retorna caminhos para pastas de aplicativo comumente usadas com base no padrão de nomenclatura KNOWNFOLDERID . |
| ApplicationData |
Fornece acesso ao armazenamento de dados do aplicativo. Os dados do aplicativo consistem em arquivos e configurações que são locais, móveis ou temporários. |
| ApplicationDataCompositeValue |
Representa as configurações de aplicativo relacionadas que devem ser serializadas e desserializadas atomicamente. |
| ApplicationDataContainer |
Representa um contêiner para as configurações do aplicativo. Os métodos e as propriedades dessa classe dão suporte à criação, exclusão, enumeração e passagem da hierarquia de contêineres. |
| ApplicationDataContainerSettings |
Fornece acesso às configurações em um contêiner de configurações. A propriedade ApplicationDataContainer.Values retorna um objeto que pode ser convertido nesse tipo. |
| CachedFileManager |
Permite que os aplicativos gerenciem atualizações em tempo real para arquivos. |
| DownloadsFolder |
Cria arquivos e pastas dentro da pasta Downloads. |
| FileIO |
Fornece métodos auxiliares para ler e gravar arquivos que são representados por objetos do tipo IStorageFile. |
| KnownFolders |
Fornece acesso a locais comuns que contêm conteúdo do usuário. Isso inclui conteúdo das bibliotecas locais de um usuário (como Documentos, Imagens, Música e Vídeos), HomeGroup, dispositivos removíveis e dispositivos de servidor de mídia. |
| PathIO |
Fornece métodos auxiliares para ler e gravar um arquivo usando o caminho absoluto ou o URI (Uniform Resource Identifier) do arquivo. |
| SetVersionDeferral |
Gerencia uma operação de versão de conjunto atrasada. |
| SetVersionRequest |
Fornece dados quando um aplicativo define a versão dos dados do aplicativo no armazenamento de dados do aplicativo. |
| StorageFile |
Representa um arquivo. Fornece informações sobre o arquivo e seu conteúdo e maneiras de manipulá-los. |
| StorageFolder |
Gerencia pastas e seu conteúdo e fornece informações sobre elas. |
| StorageLibrary |
Permite adicionar e remover pastas de uma biblioteca como Música ou Vídeos e permite obter uma lista de pastas incluídas na biblioteca. |
| StorageLibraryChange |
Representa uma alteração em um item em uma biblioteca de armazenamento, como documentos, música ou biblioteca de vídeos. |
| StorageLibraryChangeReader |
Permite que o aplicativo de chamada leia as alterações nos itens em uma biblioteca de armazenamento. |
| StorageLibraryChangeTracker |
Fornece APIs que você pode usar para gerenciar o controle de alterações para qualquer biblioteca (como documentos, músicas ou vídeos) ou pasta. |
| StorageLibraryChangeTrackerOptions |
Permite que os chamadores chamem EnableWithOptions no rastreador de alterações para optar por controlar todas as alterações, incluindo a última ID de alteração ou apenas a última ID de alteração. |
| StorageLibraryLastChangeId |
Permite que você acompanhe as alterações com base em um valor exclusivo que representa a última alteração processada pelo serviço de indexação para o StorageFolder ou StorageLibrary fornecido. |
| StorageProvider |
Contém informações sobre o serviço que armazena arquivos e pastas. Arquivos e pastas podem ser armazenados pelo sistema de arquivos local ou por um serviço remoto como Microsoft OneDrive. |
| StorageStreamTransaction |
Representa uma transação de gravação para um fluxo de acesso aleatório. |
| StreamedFileDataRequest |
Representa um fluxo de saída de acesso sequencial que indica uma solicitação para o fluxo de dados de um StorageFile criado chamando CreateStreamedFileAsync ou ReplaceWithStreamedFileAsync. |
| SystemAudioProperties |
Um objeto auxiliar que fornece nomes de indexação para Windows propriedades de arquivo de áudio. |
| SystemDataPaths |
Obtém alguns locais de pastas de todo o sistema comumente usados com base no padrão de nomenclatura KNOWNFOLDERID . |
| SystemGPSProperties |
Um objeto auxiliar que fornece nomes de indexação para propriedades de arquivo GPS. |
| SystemImageProperties |
Um objeto auxiliar que fornece nomes de indexação para Windows propriedades de arquivo de imagem. |
| SystemMediaProperties |
Um objeto auxiliar que fornece nomes de indexação para Windows propriedades de arquivo de mídia. |
| SystemMusicProperties |
Um objeto auxiliar que fornece nomes de indexação para Windows propriedades de arquivo de música. |
| SystemPhotoProperties |
Um objeto auxiliar que fornece nomes de indexação para Windows propriedades de arquivo de foto. |
| SystemProperties |
Fornece valores de cadeia de caracteres para indexação de nomes de propriedades comuns de arquivo Windows, como System.Title, e também faz referência a objetos auxiliares que fornecem nomes de indexação para propriedades de tipos de arquivo específicos (por exemplo, arquivos de vídeo). |
| SystemVideoProperties |
Um objeto auxiliar que fornece nomes de indexação para propriedades de arquivo de vídeo. |
| UserDataPaths |
Retorna caminhos completos para pastas de dados comuns do usuário. As pastas de dados do usuário são baseadas no padrão de nomenclatura KNOWNFOLDERID . |
Interfaces
| Nome | Description |
|---|---|
| IStorageFile |
Representa um arquivo. Fornece informações sobre o arquivo e seu conteúdo e maneiras de manipulá-los.
|
| IStorageFile2 |
Representa um arquivo. Fornece informações sobre o arquivo e seu conteúdo e maneiras de manipulá-los.
|
| IStorageFilePropertiesWithAvailability |
Fornece acesso à propriedade IsAvailable . |
| IStorageFolder |
Manipula pastas e seu conteúdo e fornece informações sobre elas.
|
| IStorageFolder2 |
Manipula pastas e seu conteúdo e fornece informações sobre elas. Importante Se você simplesmente quiser trabalhar com pastas em seu aplicativo, consulte a classe StorageFolder . |
| IStorageItem |
Manipula itens de armazenamento (arquivos e pastas) e seu conteúdo e fornece informações sobre eles.
|
| IStorageItem2 |
Manipula itens de armazenamento (arquivos e pastas) e seu conteúdo e fornece informações sobre eles.
|
| IStorageItemProperties |
Fornece acesso a propriedades comuns e de conteúdo em itens (como arquivos e pastas). |
| IStorageItemProperties2 |
Fornece acesso a métodos que obtêm uma imagem dimensionada como uma miniatura. |
| IStorageItemPropertiesWithProvider |
Fornece acesso a propriedades comuns e de conteúdo em itens de armazenamento de um provedor específico. |
| IStreamedFileDataRequest |
Representa um fluxo de saída de acesso sequencial que indica uma solicitação para o fluxo de dados de um StorageFile criado chamando CreateStreamedFileAsync ou ReplaceWithStreamedFileAsync. |
Enumerações
| Nome | Description |
|---|---|
| ApplicationDataCreateDisposition |
Especifica as opções para criar contêineres de dados do aplicativo ou retornar contêineres existentes. Essa enumeração é usada pelo método ApplicationDataContainer.CreateContainer . |
| ApplicationDataLocality |
Especifica o tipo de armazenamento de dados de um aplicativo. |
| CreationCollisionOption |
Especifica o que fazer se um arquivo ou pasta com o nome especificado já existir na pasta atual quando você criar um novo arquivo ou pasta. |
| FileAccessMode |
Especifica se um arquivo deve ser acessado no modo somente leitura ou no modo de leitura/gravação. |
| FileAttributes |
Descreve os atributos de um arquivo ou pasta. |
| KnownFolderId |
Fornece valores que identificam pastas de armazenamento. |
| KnownFoldersAccessStatus |
Descreve o acesso de uma pasta conhecida a uma única funcionalidade. |
| KnownLibraryId |
Fornece valores que identificam bibliotecas de armazenamento. |
| NameCollisionOption |
Especifica o que fazer se já existir um arquivo ou pasta com o nome especificado na pasta atual quando você copiar, mover ou renomear um arquivo ou pasta. |
| StorageDeleteOption |
Especifica se um item excluído é movido para a Lixeira ou excluído permanentemente. |
| StorageItemTypes |
Descreve se um item que implementa a interface IStorageItem é um arquivo ou uma pasta. |
| StorageLibraryChangeType |
Descreve o tipo de alteração que ocorreu no item da biblioteca de armazenamento. |
| StorageOpenOptions |
Fornece opções a serem usadas ao abrir um arquivo. |
| StreamedFileFailureMode |
Indica o motivo pelo qual os dados não puderam ser transmitidos. |
Delegados
| Nome | Description |
|---|---|
| ApplicationDataSetVersionHandler |
Representa um método que manipula a solicitação para definir a versão dos dados do aplicativo no armazenamento de dados do aplicativo. |
| StreamedFileDataRequestedHandler |
Representa o método que transmitirá dados para um StorageFile quando esse arquivo for acessado pela primeira vez. |
Comentários
Observação
Compatibilidade da estrutura do aplicativo: O Windows. As APIs de armazenamento estão disponíveis para aplicativos da área de trabalho do SDK do Aplicativo Windows (WinUI 3) e aplicativos da área de trabalho Win32, não apenas aplicativos UWP. Os aplicativos da área de trabalho podem usar classes como StorageFile, StorageFolder e ApplicationData por meio de C#/WinRT ou C++/WinRT. Algumas APIs (como o seletor de arquivos) exigem configuração adicional em aplicativos de área de trabalho não empacotados. Para obter detalhes, consulte ApIs de chamada Windows Runtime em aplicativos da área de trabalho.
Confira também
- Exemplo de acesso a arquivos (Windows 10)
- Exemplo de enumeração de pasta (Windows 10)
- Amostra de imagem simples (Windows 10)
- Exemplo de seletor de arquivo (Windows 10)
- Exemplo de pesquisa de arquivo (Windows 10)
- Exemplo de miniatura de arquivo e pasta (Windows 10)
- Exemplo de gerenciamento de biblioteca (Windows 10)
- Exemplo de transferência em segundo plano
- Exemplo de transferência em segundo plano (Windows 8.x)
- Exemplo do indexador de conteúdo
- Exemplo de dados serializando e desserializando
- Exemplo de HomeGroup
- Exemplo de JavaScript (leitor de RSS de ponta a ponta)