Partilhar via


Download Função

Aplica-se a: Aplicativos de tela Aplicativos orientados por modelos

Transfere um ficheiro da Web para o dispositivo local.

Description

A Download função baixa um arquivo da Web para o dispositivo local.

Nos leitores nativos (Windows, Android e iOS), é pedida ao utilizador uma localização para guardar o ficheiro.

Quando usado na web, Download depende das definições do navegador e da configuração do bloqueador de pop-ups para determinar o que acontece com o ficheiro. Para imagens, vídeos, PDF e outros tipos de ficheiros que o navegador suporta de forma nativa, é aberto um novo separador de navegador para exibir o ficheiro. Muitos navegadores suportam guardar o conteúdo para o sistema de ficheiros local.

Somente no Windows, Download retorna o local onde o arquivo foi armazenado localmente como uma cadeia de texto.

Download só pode ser usado em fórmulas de comportamento.

Sintaxe

Download( Endereço )

  • Endereço – Obrigatório. O endereço URL de um recurso Web a transferir.

Nota

O Power Apps não pode autenticar solicitações de download para o endereço fornecido na Downloadfunção ().

Por exemplo, ao utilizar esta função para transferir um ficheiro armazenado num site do SharePoint que necessite de autenticação, o pedido poderá funcionar ao utilizar um browser, uma vez que a sessão do browser poderá efetuar a autenticação no site do SharePoint utilizando credenciais em cache. No entanto, no aplicativo móvel Power Apps, a solicitação não funcionará, pois a autenticação da solicitação de download não é tratada pelo dispositivo móvel.

Exemplos

Simples Download

A fórmula seguinte transfere o guia do utilizador para o Surface Book, um ficheiro PDF:

Download( "https://go.microsoft.com/fwlink/?linkid=827480" )

Quando executado em um dispositivo móvel, o usuário é solicitado a fornecer um local para salvar o arquivo.

Quando executado na maioria dos navegadores da Web, uma nova guia é aberta para exibir o arquivo PDF, já que a maioria dos navegadores suporta nativamente esse tipo de arquivo.

Passo a Passo

O modelo de esquema de tablet Demonstração de Produtos foi utilizado para o exemplo seguinte. Para criar uma aplicação com este modelo, siga os passos de criar uma aplicação e selecione o modelo Demonstração de Produtos. Também pode utilizar a sua própria aplicação.

  1. Aceder a Power Apps.

  2. Selecione Aplicações no painel de navegação esquerdo.

  3. Selecione a sua aplicação e, em seguida, selecione Editar.

  4. Selecione Inserir a partir do menu e selecione Etiqueta.

  5. Mova a etiqueta para a parte inferior direita do ecrã.

  6. No painel de propriedades no lado direito, selecione Cor como branco e defina a Espessura do limite como 1.

  7. Selecione a propriedade Text no lado direito e insira o texto como Download Guia do Usuário.

  8. Na lista de propriedades na parte superior esquerda, selecione OnSelect.

  9. Introduza a fórmula como Download("https://go.microsoft.com/fwlink/?linkid=827480"). Também pode utilizar qualquer outro URL que pretender.

    Download exemplo.

  10. Guarde e publique a aplicação.

  11. Executar a aplicação.

  12. Selecione o botão Guia doDownload usuário para baixar o guia.

Nota

  • As configurações do navegador determinam se o arquivo deve ser baixado ou aberto diretamente em uma nova guia. Para obter mais detalhes, vá para a descrição daDownload função.
  • Se a Download fórmula for usada para recuperar um ficheiro e este não for descarregado com sucesso, recomenda-se verificar se o download está bloqueado por um bloqueador de pop-up do navegador ou se o navegador está à espera da resposta do utilizador a uma caixa de diálogo a pedir permissão para descarregar o ficheiro.

Consulte também

Referência de fórmula do aplicativo Canvas