Arquivos, pastas e bibliotecas com o SDK do Aplicativo Windows

Os aplicativos empacotados do SDK do Aplicativo Windows podem utilizar as APIs avançadas fornecidas pelos namespaces Windows.Storage, Windows.Storage.Streams e Windows.Storage.Pickers para ler e gravar com eficiência vários formatos de dados em arquivos, bem como gerenciar arquivos e pastas. Esta seção aborda tópicos essenciais, como a leitura e gravação de configurações de aplicativo, os seletores de arquivos e pastas e o acesso a locais especiais de área restrita, como a biblioteca de vídeos/músicas. Saiba como otimizar os recursos de gerenciamento de arquivos do seu aplicativo com o SDK do Aplicativo Windows.

O Windows 10 e as versões posteriores do sistema operacional fornecem uma ampla variedade de APIs relacionadas a arquivos, pastas, bibliotecas e configurações para aplicativos. Esses recursos estão disponíveis por meio de uma combinação de APIs do WinRT e do .NET fornecidas pelo SDK do Windows e pelo SDK do .NET.

Ler e gravar dados com APIs de armazenamento do WinRT

Os aplicativos empacotados têm acesso a todas as APIs de armazenamento do WinRT disponíveis para aplicativos UWP. Se você estiver migrando um aplicativo UWP existente ou criando um novo, use essas APIs para ler e gravar dados. Para obter exemplos de como usar as APIs de armazenamento em um aplicativo WinUI, confira Acessar arquivos e pastas com APIs do WinRT e o SDK do Aplicativo Windows.

Ler e gravar dados com APIs de arquivo do .NET

Além das APIs do WinRT, os aplicativos empacotados podem usar as APIs do .NET no namespace System.IO para ler e gravar dados. Quando um novo projeto do WinUI 3 é criado, o respectivo arquivo Package.appxmanifest contém a seguinte configuração:

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

Declarar essa funcionalidade restrita fornece acesso completo ao sistema de arquivos, ao registro e a outros recursos restritos. Para saber mais, confira Declarações de funcionalidades restritas. Em outras palavras, o aplicativo tem o mesmo acesso ao sistema de arquivos que qualquer outro aplicativo da área de trabalho do .NET ao usar as APIs de arquivo do .NET.

Para obter exemplos de como usar as APIs do .NET em um aplicativo WinUI, confira Acessar arquivos e pastas com APIs do .NET e o SDK do Aplicativo Windows.

Recursos adicionais para trabalhar com arquivos e pastas

Se você estiver desenvolvendo aplicativos WinUI empacotados, as APIs de armazenamento do WinRT poderão ser uma ferramenta poderosa para ler e gravar dados. Os tópicos do UWP a seguir fornecem uma grande quantidade de informações aos desenvolvedores que desejam utilizam essas APIs em seus aplicativos.

Tópico	Descrição
Enumerar e consultar arquivos e pastas	Acesse arquivos e pastas que estão em uma pasta, biblioteca, dispositivo ou local de rede. Você também pode consultar arquivos e pastas em um local por meio de consultas de arquivo e pasta.
Criar, gravar e ler um arquivo	Leia e grave um arquivo usando o objeto StorageFile.
Práticas recomendadas para gravar em arquivos	Conheça as práticas recomendadas para usar os vários métodos de gravação de arquivos das classes FileIO e PathIO.
Obter propriedades de arquivo	Obtenha as propriedades, de nível superior, básicas e estendidas, de um arquivo representado pelo objeto StorageFile.
Abrir arquivos e pastas com um seletor	Acesse arquivos e pastas permitindo que o usuário interaja com um seletor. Você pode usar o FolderPicker para obter acesso a uma pasta. Observação: em um aplicativo de área de trabalho (que inclui aplicativos WinUI 3), você pode usar seletores de arquivos e pastas a partir de Windows.Storage.Pickers. No entanto, se o aplicativo da área de trabalho exigir elevação para ser executado, você precisará de uma abordagem diferente porque essas APIs não foram projetadas para serem usadas em um aplicativo elevado. Para obter um exemplo, consulte FileSavePicker.
Salvar um arquivo com um seletor	Use o FileSavePicker para permitir que os usuários especifiquem o nome e o local onde desejam que o aplicativo salve um aplicativo.
Acessando o conteúdo do Grupo Doméstico	Acesse o conteúdo armazenado na pasta Grupo Doméstico do usuário, incluindo imagens, músicas e vídeos.
Determinando a disponibilidade de arquivos do Microsoft OneDrive	Determine se um arquivo do Microsoft OneDrive está disponível usando a propriedade StorageFile.IsAvailable.
Arquivos e pastas nas bibliotecas Música, Fotos e Vídeos	Adicione pastas existentes de música, fotos ou vídeos às bibliotecas correspondentes. Você também pode remover pastas de bibliotecas, obter a lista de pastas em uma biblioteca e descobrir fotos, músicas e vídeos armazenados.
Rastrear arquivos e pastas usados recentemente	Acompanhe os arquivos que o usuário acessa com frequência adicionando-os à lista de itens usados recentemente de seu aplicativo. A plataforma gerencia os itens usados recentemente para você classificando-os com base na data em que foram acessados pela última vez e removendo o item mais antigo quando o limite de 25 itens é atingido. Todos os aplicativos têm seus próprios itens usados recentemente.
Controlar alterações no sistema de arquivos em segundo plano	Acompanhar as alterações ao sistema de arquivos, mesmo quando o aplicativo não está em execução.
Acessar o cartão SD	Você pode armazenar e acessar dados não essenciais em um cartão microSD opcional, especialmente em dispositivos móveis de baixo custo que têm armazenamento interno limitado.
Acesso rápido às propriedades do arquivo	Colete com eficiência uma lista de arquivos e propriedades associadas de uma biblioteca para usar em APIs do Windows Runtime.

Confira também

Acessar arquivos e pastas com APIs do WinRT e o SDK do Aplicativo Windows

Acessar arquivos e pastas com APIs do .NET e o SDK do Aplicativo Windows

System.IO