適用対象:
キャンバス アプリ モデル駆動型アプリ
ローカル デバイスに Web からファイルをダウンロードします。
Description
Download関数は、Web からローカル デバイスにファイルをダウンロードします。
ネイティブ プレイヤー (Windows、Android、および iOS) で、ユーザーはファイルを保存する場所を求められます。
Web で使用する場合、 Download はブラウザーの設定とポップアップ ブロックの構成に依存して、ファイルで何が起こるかを判断します。 ブラウザがネイティブにサポートする画像、ビデオ、PDF、およびその他のファイル タイプの場合、ファイルを表示するために新しいブラウザ タブが開きます。 多くのブラウザは、コンテンツをローカル ファイル システムに保存することをサポートしています。
Windows でのみ、 Download はファイルがテキスト文字列としてローカルに格納された場所を返します。
Download は動作 式でのみ使用できます。
構文
Download( アドレス )
- 住所 – 必須。 ダウンロードする Web リソースの URL アドレス。
Note
Power Apps では、 Download() 関数で指定されたアドレスに対するダウンロード要求を認証できません。
たとえば、この関数を使用して認証を必要とする SharePoint サイトに格納されているファイルをダウンロードする場合、ブラウザー セッションがキャッシュされた資格情報を使用して SharePoint サイトに対して認証を行う可能性があるため web ブラウザーを使用すると要求が機能することがあります。 ただし、Power Apps モバイル アプリでは、ダウンロード要求の認証はモバイル デバイスによって処理されないため、要求は機能しません。
使用例
簡単 Download
次の数式は、Surface Book のユーザー ガイド (PDF ファイル) をダウンロードします。
Download( "https://go.microsoft.com/fwlink/?linkid=827480" )
モバイル デバイスで実行すると、ユーザーはファイルを保存する場所の入力を求められます。
ほとんどの Web ブラウザーで実行すると、新しいタブが開き、ほとんどのブラウザーがこのファイルの種類をネイティブにサポートするため、PDF ファイルが表示されます。
手順
製品ショーケースタブレット レイアウト テンプレートは、次の例で使用されました。 このテンプレートを使用してアプリを作成するには、アプリの作成 の記事の手順に従い、製品ショーケース テンプレートを選択します。 自分のアプリを使用することもできます。
Power Apps に移動します。
左側のナビゲーション ウィンドウから、アプリを選択します。
アプリを選択し、編集を選択します。
メニューから挿入を選択し、ラベルを選択します。
ラベルを画面右下に移動します。
右側のプロパティ ウィンドウから、色を白に選択し、境界線の太さを 1 に設定します。
右側から Text プロパティを選択し、ユーザー ガイドDownloadテキストを入力します。
左上のプロパティ リストから、OnSelect を選択します。
数式を
Download("https://go.microsoft.com/fwlink/?linkid=827480")と入力します。 他の使用したい URL を使用することもできます。
アプリを保存し、公開します。
アプリを再生します。
[Download ユーザー ガイド] ボタンを選択して、ガイドをダウンロードします。
Note
- ブラウザーの設定によって、ファイルをダウンロードするか、新しいタブで直接ファイルを開くかが決まります。詳細については、 Download 関数の説明を参照してください。
- Download数式を使用してファイルを取得し、ファイルが正常にダウンロードされない場合は、ブラウザーのポップアップ ブロックによってダウンロードがブロックされているかどうか、またはブラウザーがファイルのダウンロードのアクセス許可を求めるダイアログ ボックスに対するユーザーの応答を待機しているかどうかを確認することをお勧めします。