Download 函数
适用于: 画布应用 模型驱动应用
将文件从 web 下载到本地设备。
Description
Download 函数可用于从 Web 将文件下载到本地设备。
在本机播放器(Windows、Android 和 iOS)中,系统会提示用户提供保存文件的位置。
在 web 上使用时,Download 依赖于浏览器的设置来确定文件会如何处理。 对于浏览器本身支持的图像、视频、PDF 和其他文件类型,将打开一个新的浏览器标签页以显示文件。 许多浏览器支持将内容保存至本地文件系统。
仅在 Windows 上时,Download 会返回文件的存储位置,并使用文本字符串表示。
Download 只能在行为公式中使用。
语法
下载( 地址 )
- Address(地址 )– 必填。 要下载的 Web 资源的 URL 地址。
备注
Power Apps 无法验证对 Download() 函数中提供的地址的下载请求。
例如,当使用此函数下载存储在 SharePoint 站点上需要身份验证的文件时,该请求可能在使用 Web 浏览器时工作,因为浏览器会话可能使用缓存的凭据对 SharePoint 站点进行验证。 但是,在 Power Apps 移动应用中,该请求将不工作,因为验证下载请求不是由移动设备处理的。
示例
下载示例
以下公式将下载 Surface Book 的用户指南(PDF 文件):
Download( "https://go.microsoft.com/fwlink/?linkid=827480" )
在移动设备上运行时,将提示用户选择保存文件的位置。
在大多数 Web 浏览器中运行时,将打开一个新标签页来显示 PDF 文件,因为大多数浏览器本身都支持此文件类型。
分步操作
以下示例使用了产品展示平板电脑布局模板。 要使用此模板创建应用,请按照创建应用文章中的步骤操作,选择产品展示模板。 您也可以使用自己的应用。
转到 Power Apps。
从左侧导航窗格中选择应用。
选择您的应用,然后选择编辑。
从菜单中选择插入,然后选择标签。
将标签移到屏幕右下角。
在右侧的属性窗格中,颜色选择白色,将边框宽度设置为 1。
从右侧选择 Text 属性,然后输入文本 Download User Guide。
从左上方的属性列表中,选择 OnSelect。
输入公式
Download("https://go.microsoft.com/fwlink/?linkid=827480")
。 您还可以使用您选择的任何其他 URL。保存并发布应用。
播放应用。
选择下载用户指南按钮下载指南。
备注
您的浏览器设置确定是下载文件还是直接在新标签页中打开文件。有关更多详细信息,请转到 Download 函数说明。