Gerencie arquivos, pastas e bibliotecas com o SDK de aplicativos Windows

O SDK de aplicativos do Windows fornece recursos poderosos de gerenciamento de arquivos para aplicativos empacotados. Você pode usar APIs dos namespaces Windows.Storage, Windows.Storage.Streams e Microsoft.Windows.Storage.Pickers para ler e gravar com eficiência vários formatos de dados em arquivos, bem como gerenciar arquivos e pastas.

Há uma grande variedade de APIs relacionadas a arquivos, pastas, bibliotecas e configurações para aplicativos da área de trabalho do Windows a partir do Windows 10. Esses recursos estão disponíveis por meio de uma combinação de SDK de Aplicativo do Windows, Tempo de Execução do Windows (WinRT) e APIs .NET fornecidas pelo SDK de Aplicativo do Windows, SDK do Windows e SDK do .NET.

Usar seletores do SDK de aplicativos Windows para ler e gravar dados

Há APIs de seletor disponíveis no SDK de Aplicativo Windows versão 1.8 e posterior. Os tópicos a seguir fornecem informações sobre como usar as APIs do seletor para permitir que os usuários abram e salvem arquivos e pastas em seu aplicativo:

Tópico	Description
Abrir arquivos e pastas com seletores no WinUI	Use os seletores de arquivos e pastas do SDK do Windows App para permitir que os usuários naveguem e selecionem arquivos ou pastas em seu aplicativo WinUI. As APIs do seletor fornecem uma experiência familiar do Windows que ajuda os usuários a navegar em seus dispositivos e locais de armazenamento em nuvem. Saiba como permitir que os usuários selecionem um arquivo ou pasta para abrir usando as classes FileOpenPicker e FolderPicker .
Salvar um arquivo com o seletor do SDK de aplicativos do Windows na WinUI	Ao criar aplicativos WinUI e outros aplicativos cliente do Windows, os usuários geralmente precisam salvar arquivos como documentos, imagens ou outro conteúdo em locais específicos em seus dispositivos. O SDK do Aplicativo Windows fornece a classe FileSavePicker para criar uma interface consistente e amigável que permite aos usuários escolher onde salvar arquivos e como nomeá-los.

Tópico

Description

Abrir arquivos e pastas com seletores no WinUI

Use os seletores de arquivos e pastas do SDK do Windows App para permitir que os usuários naveguem e selecionem arquivos ou pastas em seu aplicativo WinUI. As APIs do seletor fornecem uma experiência familiar do Windows que ajuda os usuários a navegar em seus dispositivos e locais de armazenamento em nuvem. Saiba como permitir que os usuários selecionem um arquivo ou pasta para abrir usando as classes FileOpenPicker e FolderPicker .

Salvar um arquivo com o seletor do SDK de aplicativos do Windows na WinUI

Ao criar aplicativos WinUI e outros aplicativos cliente do Windows, os usuários geralmente precisam salvar arquivos como documentos, imagens ou outro conteúdo em locais específicos em seus dispositivos. O SDK do Aplicativo Windows fornece a classe FileSavePicker para criar uma interface consistente e amigável que permite aos usuários escolher onde salvar arquivos e como nomeá-los.

Principais diferenças entre os seletores WinRT e Windows App SDK

Aqui estão algumas diferenças importantes do WinRT Windows.Storage.Pickers usado por aplicativos UWP:

Ao contrário da API Windows.Storage.Pickers existente que retorna objetos StorageFile e StorageFolder , essa nova API retorna caminhos baseados em cadeia de caracteres por meio das classes PickFileResult e PickFolderResult . Isso simplifica a API e evita complicações com os recursos de armazenamento em cenários elevados.
Da mesma forma, a propriedade FileSavePicker.SuggestedSaveFile (que retornou um StorageFile) foi substituída. Sua funcionalidade agora é coberta por duas propriedades de cadeia de caracteres: SuggestedFolder e SuggestedFileName. Eles permitem que você sugira a pasta e o nome do arquivo para a caixa de diálogo de salvamento.
Todos os novos seletores são projetados especificamente para aplicativos da área de trabalho e usam uma propriedade WindowId para vincular o seletor à janela do host, substituindo o WinRT.Interop.InitializeWithWindow.Initialize padrão.
Os novos seletores permitem que os desenvolvedores os usem sem exigir que FileTypeFilter ou FileTypeChoices sejam especificados. Enquanto os seletores de UWP lançam exceções quando essas propriedades não estão definidas, os novos seletores usam como padrão mostrar todos os arquivos quando os desenvolvedores não configuram explicitamente essas propriedades.
O local do Grupo Doméstico foi excluído do novo enum PickerLocationId , pois não é mais suportado a partir do Windows 10.
FolderPicker.FileTypeFilter foi excluído, pois não era funcionalmente apropriado para a seleção de pastas.
Excluindo métodos e propriedades que já estão marcados como preteridos ou "Não usar". por exemplo, PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync, etc.
Excluindo métodos e propriedades para o modo multiusuário, porque as novas APIs são atualmente projetadas para cenários de área de trabalho onde cada usuário tem sua própria sessão interativa e cada sessão é completamente independente das outras sessões no dispositivo. Isso contrasta com o Xbox ou outros dispositivos multiusuário.

Acessar 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. Quer esteja a migrar uma aplicação UWP existente ou a criar uma nova aplicação, pode utilizar estas APIs para ler e escrever dados. Para obter exemplos de como usar as APIs de armazenamento em um aplicativo WinUI, consulte Acessar arquivos e pastas com o SDK do Windows App e APIs do WinRT.

Usar APIs de arquivo .NET para acesso a dados

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

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

A declaração desse recurso restrito fornece acesso total ao sistema de arquivos, ao registro e a outros recursos restritos. Para saber mais, veja Declarações de capacidade restrita. Em outras palavras, o aplicativo tem o mesmo acesso ao sistema de arquivos que qualquer outro aplicativo de área de trabalho .NET ao usar as APIs de arquivo .NET.

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

Recursos adicionais para trabalhar com ficheiros e pastas

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

Tópico	Description
Enumerar e consultar arquivos e pastas	Acesse arquivos e pastas em uma pasta, biblioteca, dispositivo ou local de rede. Você também pode consultar os arquivos e pastas em um local construindo consultas de arquivo e pasta.
Criar, escrever e ler um ficheiro	Leia e escreva um ficheiro utilizando um objeto StorageFile .
Práticas recomendadas para gravar em arquivos	Aprenda as práticas recomendadas para usar vários métodos de gravação de arquivos das classes FileIO e PathIO .
Obter propriedades do arquivo	Obtenha propriedades — de nível superior, básicas e estendidas — para um arquivo representado por um objeto StorageFile .
Aceder ao conteúdo do Grupo Doméstico	Aceda ao conteúdo armazenado na pasta Grupo Doméstico do utilizador, incluindo imagens, música 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 .
Ficheiros e pastas nas bibliotecas de Música, Imagens e Vídeos	Adicione pastas existentes de música, imagens 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.
Rastreie arquivos e pastas usados recentemente	Rastreie os arquivos que o usuário acessa com frequência adicionando-os à lista de usados mais recentemente (MRU) do seu aplicativo. A plataforma gerencia o MRU para você classificando os itens com base em quando eles foram acessados pela última vez e removendo o item mais antigo quando o limite de 25 itens da lista é atingido. Todos os aplicativos têm seu próprio MRU.
Monitorizar alterações no sistema de arquivos em segundo plano	Rastreie alterações no sistema de arquivos, mesmo quando o aplicativo não estiver em execução.
Aceda ao 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	Reúna com eficiência uma lista de arquivos e suas propriedades de uma biblioteca para usar por meio das APIs do Tempo de Execução do Windows.