Download 函式
適用於: 畫布應用 模型驅動應用
Download – 從網路下載檔案到本機裝置。
Description
Download 函式會從網路下載檔案到本機裝置。
在原生播放程式 (Windows、Android 和 iOS) 中,系統會提示使用者輸入儲存檔案的位置。
當在網上使用時,Download會視瀏覽器的設定而定,以判斷檔案發生的變化。 對於瀏覽器本身支援的影像、影片、PDF 和其他檔案類型,將開啟新的瀏覽器索引標籤來顯示檔案。 許多瀏覽器都支援將內容儲存至本機檔案系統。
只有在Windows中,Download 會傳回檔案儲存在本機做為文字字串的位置。
Download 只能在行為公式中使用。
語法
下載( 位址 )
- Address (位址 )–必填。 要下載的 URL 資源之位址。
Note
Power Apps 無法驗證 Download() 函式中提供地址的下載要求。
例如,使用此函式下載儲存在需要驗證之 SharePoint 網站上的檔案時,該要求在使用 Web 瀏覽器時可能會運作,因為瀏覽器工作階段可能會使用快取憑證針對 SharePoint 網站進行驗證。 不過,在 Power Apps 行動應用程式中,該要求將不會運作,因為行動裝置並不處理對下載要求的驗證。
範例
簡易下載
下列公式將下載 Surface 使用者指南手冊,PDF 檔案:
Download( "https://go.microsoft.com/fwlink/?linkid=827480" )
在行動裝置中執行時,會提示使用者要儲存該檔案的位置。
當您在大部分網頁瀏覽器中執行時,會開啟新的索引標籤,因為大部分瀏覽器都能以本機方式支援這種檔案類型。
逐步解說
產品展示 配置範本用於下列範例。 若要使用此範本建立應用程式,請依照 建立應用程式 文章的步驟進行,並選取 產品展示 範本。 您也可以使用自己的應用程式。
移至 Power Apps。
從左導覽窗格選取 Apps。
選取您的應用程式,然後選取 Edit。
從功能表選取 Insert,然後選取 Label。
將標籤移到畫面控制項的底部。
從右側的屬性窗格中,選取 Color 為 white,並將 Border thickness 設定為 1。
從右側選取 Text 屬性,並將文字輸入為 下載使用者指南。
從左上部的屬性清單中,選取 OnSelect。
輸入公式為
Download("https://go.microsoft.com/fwlink/?linkid=827480")
。 您也可以上傳及使用您選擇的任何URL。儲存並發佈應用程式。
播放應用程式。
選取 Download User Guide 按鈕下載本指南。
Note
您的瀏覽器設定會判斷是否要下載檔案,或直接在新索引標籤中開啟檔案。如需詳細資料,請移至 Download 函式描述。