Download 函数

适用于:画布应用模型驱动应用

将文件从 web 下载到本地设备。

Description

Download 函数可用于从 Web 将文件下载到本地设备。

在本机播放器(Windows、Android 和 iOS)中,系统会提示用户提供保存文件的位置。

在 web 上使用时,Download 依赖于浏览器的设置来确定文件会如何处理。 对于浏览器本身支持的图像、视频、PDF 和其他文件类型,将打开一个新的浏览器标签页以显示文件。 许多浏览器支持将内容保存至本地文件系统。

仅在 Windows 上时,Download 会返回文件的存储位置,并使用文本字符串表示。

Download 只能在行为公式中使用。

语法

Download( Address )

  • Address – 必需。 要下载的 Web 资源的 URL 地址。

备注

Power Apps 无法验证对 Download() 函数中提供的地址的下载请求。

例如,当使用此函数下载存储在 SharePoint 站点上需要身份验证的文件时,该请求可能在使用 Web 浏览器时工作,因为浏览器会话可能使用缓存的凭据对 SharePoint 站点进行验证。 但是,在 Power Apps 移动应用中,该请求将不工作,因为验证下载请求不是由移动设备处理的。

示例

下载示例

以下公式将下载 Surface Book 的用户指南(PDF 文件):

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

在移动设备上运行时,将提示用户选择保存文件的位置。

在大多数 Web 浏览器中运行时,将打开一个新标签页来显示 PDF 文件,因为大多数浏览器本身都支持此文件类型。

分步操作

以下示例使用了产品展示平板电脑布局模板。 要使用此模板创建应用,请按照创建应用文章中的步骤操作,选择产品展示模板。 您也可以使用自己的应用。

  1. 转到 Power Apps

  2. 从左侧导航窗格中选择应用

  3. 选择您的应用,然后选择编辑

  4. 从菜单中选择插入,然后选择标签

  5. 将标签移到屏幕右下角。

  6. 在右侧的属性窗格中,颜色选择白色,将边框宽度设置为 1

  7. 从右侧选择 Text 属性,然后输入文本 Download User Guide

  8. 从左上方的属性列表中,选择 OnSelect

  9. 输入公式 Download("https://go.microsoft.com/fwlink/?linkid=827480")。 您还可以使用您选择的任何其他 URL。

    下载示例。

  10. 保存并发布应用。

  11. 播放应用。

  12. 选择下载用户指南按钮下载指南。

备注

您的浏览器设置确定是下载文件还是直接在新标签页中打开文件。有关更多详细信息,请转到 Download 函数说明

另请参见

画布应用公式参考