Download 函数

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

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

Description

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

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

在 Web 上使用时, Download 取决于浏览器的设置和弹出阻止程序配置,以确定文件发生的情况。 对于浏览器本身支持的图像、视频、PDF 和其他文件类型,将打开一个新的浏览器标签页以显示文件。 许多浏览器支持将内容保存至本地文件系统。

仅在 Windows 上, Download 返回文件作为文本字符串在本地存储的位置。

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

语法

Download( 地址 )

  • Address(地址 )–必填。 要下载的 Web 资源的 URL 地址。

备注

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

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

示例

简单 Download

以下公式下载 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 用户指南。

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

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

    Download 例。

  10. 保存并发布应用。

  11. 播放应用。

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

备注

  • 浏览器设置确定是下载文件还是直接在新选项卡中打开文件。有关更多详细信息,请转到 Download 函数说明。
  • Download如果公式用于检索文件且文件未成功下载,则建议检查下载是否被浏览器弹出阻止程序阻止,或者浏览器正在等待用户对请求下载文件权限的对话框的响应。

另请参见

画布应用公式参考