Função Download

Artigo
03/22/2024

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

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

Download( Address )

Address - 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.

Confira também

Referência de fórmula do aplicativo de tela

Compartilhar via