Compartilhar via

Gerenciar arquivos, pastas e bibliotecas com o SDK do Aplicativo do Windows

O SDK do Aplicativo do Windows fornece recursos avançados 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 ampla 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 Aplicativos do Windows, WinRT (Windows Runtime) e APIs .NET fornecidas pelo SDK do Aplicativo do Windows, SDK do Windows e SDK do .NET.

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

Há APIs de seletor disponíveis no SDK do Aplicativo do 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 Aplicativo Windows 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 locais de armazenamento em nuvem e dispositivos. 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 Aplicativo do Windows no WinUI Ao criar aplicativos WinUI e outros aplicativos cliente do Windows, os usuários geralmente precisam salvar arquivos como documentos, imagens ou outros conteúdos em locais específicos em seu dispositivo. O SDK de Aplicativo do Windows fornece a classe FileSavePicker para criar uma interface consistente e amigável que permite que os usuários escolham onde salvar arquivos e como nomeá-los.

Principais diferenças entre os seletores do SDK de Aplicativos do WinRT e do Windows

Aqui estão algumas das principais diferenças em relação aos WinRT Windows.Storage.Pickers usados 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 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 string: SuggestedFolder e SuggestedFileName. Isso permite que você sugira a pasta e o nome do arquivo para a caixa de diálogo Salvar.
  • 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 . Embora os seletores UWP lancem exceções quando essas propriedades não são definidas, os novos seletores padrão para mostrar todos os arquivos quando os desenvolvedores não configuram explicitamente essas propriedades.
  • O local HomeGroup foi excluído do novo enum PickerLocationId, pois não é mais suportado a partir do Windows 10 em diante.
  • 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 marcadas como preteridas ou "Não usar". por exemplo, PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync etc.
  • Excluindo métodos e propriedades para o modo multiusuário, pois as novas APIs são projetadas atualmente para cenários de área de trabalho em que 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ários.

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. Se você estiver migrando um aplicativo UWP existente ou criando um novo aplicativo, poderá usar essas APIs para ler e gravar dados. Para obter exemplos de como usar as APIs de armazenamento em um aplicativo WinUI, consulte acessar arquivos e pastas com o Windows App SDK 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>

Declarar essa funcionalidade restrita fornece acesso total ao sistema de arquivos, ao registro e a outros recursos restritos. Para obter mais informações, consulte declarações de funcionalidade 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 .NET.

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

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 UWP a seguir fornecem uma grande quantidade de informações para desenvolvedores que buscam 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, gravar e ler um arquivo Ler e gravar um arquivo usando um objeto StorageFile .
Práticas recomendadas para gravar em arquivos Conheça as práticas recomendadas para usar vários métodos de gravação de arquivos das classes FileIO e PathIO .
Obter propriedades de arquivo Obtenha propriedades de nível superior, básico e estendido para um arquivo representado por um objeto StorageFile .
Acessando o conteúdo do HomeGroup Acesse o conteúdo armazenado na pasta HomeGroup 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, 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.
Rastrear arquivos e pastas usados recentemente Acompanhe os arquivos que o usuário acessa com frequência adicionando-os à MRU (lista usada mais recentemente) do aplicativo. A plataforma gerencia a 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 sua própria MRU.
Acompanhar as alterações do sistema de arquivos em segundo plano Acompanhe as alterações no sistema de arquivos, mesmo quando o aplicativo não estiver 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 suas propriedades de uma biblioteca para usar por meio das APIs do Windows Runtime.

Consulte também

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

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

System.IO

  • Last updated on