Função Download
Aplica-se a:
Aplicativos Canvas Aplicativos baseados em modelos
Baixa um arquivo da Web para o dispositivo local.
Description
A função Download baixa um arquivo da Web para o dispositivo local.
Em jogadores nativos (Windows, Android e iOS), o usuário é solicitado a fornecer um local para salvar o arquivo.
Quando usado na Web, o download depende das configurações do navegador para determinar o que acontece com o arquivo. Para imagens, vídeos, PDFs e outros tipos de arquivo para os quais o navegador oferece suporte nativo, uma nova guia do navegador é aberta para exibir o arquivo. Muitos navegadores permitem salvar o conteúdo no sistema de arquivos local.
Somente no Windows, o Download retorna o local em que o arquivo foi armazenado localmente como uma cadeia de texto.
Download só pode ser usado em fórmulas de comportamento.
Sintaxe
Baixar( Endereço )
- Endereço – Obrigatório. O endereço de URL de um recurso da Web a ser baixado.
Nota
O Power Apps não pode autenticar solicitações de download para o endereço fornecido na função Download().
Por exemplo, ao usar esta função para fazer o download de um arquivo armazenado em um site SharePoint que requer autenticação, a solicitação pode funcionar ao usar um navegador da Web, pois a sessão do navegador pode ser autenticada no site SharePoint usando 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 é processada pelo dispositivo móvel.
Exemplos
Download simples
A seguinte fórmula baixará o guia do usuário do Surface Book, um arquivo PDF:
Download( "https://go.microsoft.com/fwlink/?linkid=827480" )
Quando o arquivo for executado em um dispositivo móvel, o usuário será solicitado a fornecer um local para salvá-lo.
Quando executado na maioria dos navegadores da Web, uma nova guia será aberta para exibir o arquivo PDF, pois a maioria dos navegadores dá suporte nativo a esse tipo de arquivo.
Passo a passo
O modelo de layout de tablet Demonstração de Produto foi usado no exemplo a seguir. Para criar um aplicativo com este modelo, siga as etapas no artigo criar um aplicativo e selecione o modelo Demonstração de Produto. Você também pode usar seu próprio aplicativo.
Vá para Power Apps.
Selecione Aplicativos no painel de navegação esquerdo.
Selecione o seu aplicativo e, depois, Editar.
Selecione Inserir e, no menu, selecione Rótulo.
Mova o rótulo para a parte inferior direita da tela.
No painel de propriedades à direita, selecione Cor como branco e defina Espessura da borda como 1.
Selecione a propriedade Text do lado direito e insira o texto como Baixar Guia do Usuário.
Na lista de propriedades na parte superior esquerda, selecione OnSelect.
Insira a fórmula como
Download("https://go.microsoft.com/fwlink/?linkid=827480"). Você também pode usar outro URL de sua preferência.
Salve e publique o aplicativo.
Reproduza o aplicativo.
Selecione o botão Baixar Guia do Usuário para baixar o guia.
Nota
As configurações do seu navegador determinam se o arquivo deve ser baixado ou aberto diretamente em uma nova guia. Para obter mais detalhes, acesse Descrição da função Download.