Partilhar via

Gerir ficheiros, pastas e bibliotecas com o Windows App SDK

O Windows App SDK oferece capacidades poderosas de gestão de ficheiros para aplicações empacotadas. Podes usar APIs dos Windows.Storage, Windows.Storage.Streams e Microsoft.Windows.Storage.Pickers espaços de nomes para ler e escrever eficientemente vários formatos de dados em ficheiros, bem como gerir ficheiros e pastas.

Existe uma grande variedade de APIs relacionadas com ficheiros, pastas, bibliotecas e definições para aplicações de ambiente de trabalho Windows a partir do Windows 10. Estas funcionalidades estão disponíveis por intermédio de uma combinação de APIs Windows App SDK, Windows Runtime (WinRT) e .NET fornecidas pelo Windows App SDK, Windows SDK e .NET SDK.

Usar seletores do Windows App SDK para ler e gravar dados

Existem APIs de seletor disponíveis no Windows App SDK versão 1.8 e posteriores. 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 seletores de ficheiros e pastas do Windows App SDK para permitir que os utilizadores naveguem e selecionem ficheiros ou pastas na sua aplicação WinUI. As APIs do seletor proporcionam uma experiência Windows familiar que ajuda os utilizadores a navegar nos seus dispositivos e locais de armazenamento na cloud. Aprenda como permitir que os utilizadores selecionem um ficheiro ou pasta para abrir usando as classes FileOpenPicker e FolderPicker.
Guardar um ficheiro com o seletor do Windows App SDK no 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 Windows App SDK fornece a classe FileSavePicker para criar uma interface consistente e fácil de usar que permite aos utilizadores escolher onde guardar os ficheiros e que nomes lhes devem dar.

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

Aqui estão algumas diferenças-chave em relação ao WinRT Windows.Storage.Pickers usados por aplicativos UWP:

  • Ao contrário do existente Windows. Storage. API Pickers que retorna os objetos StorageFile e StorageFolder, esta nova API retorna caminhos baseados em strings através das classes PickFileResult e PickFolderResult. Isto simplifica a API e evita complicações com as capacidades de storage em cenários elevados.
  • De forma semelhante, a propriedade FileSavePicker.SuggestedSaveFile (que devolveu um StorageFile) foi substituída. A sua funcionalidade é agora coberta por duas propriedades de cadeia: 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 selectores permitem que os programadores os utilizem sem precisar de especificar FileTypeFilter ou FileTypeChoices. 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.
  • A localização HomeGroup foi excluída do novo enum PickerLocationId pois já não é suportado a partir de Windows 10.
  • FolderPicker.FileTypeFilter foi excluído por não ser funcionalmente apropriado para 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.

Aceda aos dados com as APIs de armazenamento do WinRT

As aplicações empacotadas têm acesso a todas as APIs de storage do WinRT disponíveis para aplicações 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 exemplos de utilização das APIs de armazenamento numa aplicação WinUI 3, consulte Aceder a ficheiros e pastas com o SDK de Aplicações do Windows e APIs WinRT.

Use APIs de ficheiros .NET para acesso a dados

Para além das APIs WinRT, as aplicações de ambiente de trabalho empacotadas podem usar as APIs .NET no espaço de nomes System.IO para ler e escrever dados. Quando um novo project WinUI é criado, o seu ficheiro Package.appxmanifest contém a seguinte definição:

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

Declarar esta capacidade restrita proporciona acesso total ao sistema de ficheiros, registo e outras capacidades restritas. Para saber mais, veja Declarações de capacidade restrita. Ou seja, a aplicação tem o mesmo acesso ao sistema de ficheiros que qualquer outra aplicação desktop .NET ao usar as APIs de ficheiros .NET.

Para obter exemplos de utilização das APIs .NET numa aplicação WinUI, veja Aceder a ficheiros e pastas com APIs do Windows App SDK e do .NET.

Recursos adicionais para trabalhar com ficheiros e pastas

Se está a desenvolver aplicações WinUI empacotadas, as APIs de storage do WinRT podem ser uma ferramenta poderosa para ler e escrever 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 Aceda a ficheiros e pastas numa pasta, biblioteca, dispositivo ou localização 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 usando um objeto StorageFile.
Práticas recomendadas para gravar em arquivos Aprenda as melhores práticas para usar vários métodos de escrita de ficheiros das classes FileIO e PathIO.
Obter propriedades do arquivo Obtenha propriedades — de topo, básicas e avançadas — para um ficheiro representado por um objeto StorageFile.
Aceder ao conteúdo do Grupo Doméstico Aceder a conteúdos armazenados na pasta Grupo Doméstico do utilizador, incluindo imagens, música e vídeos.
Determinação da disponibilidade de ficheiros Microsoft OneDrive Determine se um ficheiro 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.
Access o cartão SD Pode armazenar e acess dados não essenciais num cartão microSD opcional, especialmente em dispositivos móveis de baixo custo que têm storage interno limitado.
Acesso rápido às propriedades do arquivo Recolha eficientemente uma lista de ficheiros e as suas propriedades a partir de uma biblioteca para usar através das APIs do Windows Runtime.

Consulte também

Acesse ficheiros e pastas com o SDK de Aplicações do Windows e as APIs WinRT

Access ficheiros e pastas com APIs Windows App SDK e .NET

System.IO

  • Last updated on