الدالة Download
ينطبق على:
تطبيقات اللوحة التطبيقات المستندة إلى النموذج
تنزيل ملف من الويب إلى الجهاز المحلي.
الوصف
تقوم وظيفة Download بتنزيل ملف من الويب إلى الجهاز المحلي.
في المشغلات الأصلية (Windows، وAndroid، وiOS)، تتم مطالبة المستخدم بموقع لحفظ الملف.
عند استخدام وظيفة التنزيل على الويب، تعتمد هذه الوظيفة على إعدادات المستعرض لتحديد ما يحدث مع الملف. بالنسبة للصور ومقاطع الفيديو وملفات PDF وأنواع الملفات الأخرى التي يدعمها المستعرض في الأصل، يتم فتح علامة تبويب جديدة في المستعرض لعرض الملف. تدعم العديد من المستعرضات حفظ المحتويات إلى نظام الملفات المحلي.
فقط على Windows، تقوم وظيفة التنزيل بإرجاع الموقع الذي تم تخزين الملف فيه محليًا كسلسلة نصية.
لا يمكن استخدام التنزيل إلا في صيغ السلوك.
بناء الجملة
تحميل( العنوان )
- العنوان - مطلوب. عنوان URL لمورد ويب لتنزيله.
ملاحظة
يتعذر على Power Apps مصادقة طلبات التنزيل المصادقة إلى العنوان الذي تم توفيره في الدالة Download().
على سبيل المثال، عند استخدام هذه الدالة لتنزيل ملف مخزّن في موقع SharePoint يتطلب المصادقة، قد يعمل الطلب عند استخدام مستعرض ويب بما أن جلسة عمل المستعرض قد تجري المصادقة في مقابل موقع SharePoint الذي يستخدم بيانات الاعتماد المخزنة مؤقتًا. ومع ذلك، في تطبيق Power Apps للأجهزة المحمولة، نظرًا لعدم معالجة طلب التنزيل من خلال الجهاز المحمول.
الأمثلة
التنزيل البسيط
ستقوم الصيغة التالية بتنزيل دليل المستخدم لملف Surface Book، وهو ملف PDF:
Download( "https://go.microsoft.com/fwlink/?linkid=827480" )
عند التشغيل في جهاز محمول، سيُطلب من المستخدم تحديد موقع لحفظ الملف.
عند التشغيل في معظم متصفحات الويب، سيتم فتح علامة تبويب جديدة لعرض ملف PDF لأن معظم المتصفحات تدعم نوع الملف هذا أصلاً.
خطوة بخطوة
تم استخدام قالب تخطيط كمبيوتر لوحي عرض المنتج للمثال التالي. لإنشاء تطبيق باستخدام هذا القالب، اتبع الخطوات من مقالة إنشاء تطبيق وحدد قالب عرض المنتج. كما يمكنك استخدام التطبيق الخاص بك.
انتقل إلى Power Apps.
من جزء التنقل الأيسر، حدد التطبيقات.
حدد تطبيقك ثم حدد تحرير.
حدد إدراج من القائمة، ثم حدد Label.
انقل التسمية إلى أسفل يمين الشاشة.
من جزء الخصائص على الجانب الأيسر، حدد اللون على أنه أبيض وقم بتعيين سمك الحد عند 1.
حدد خاصية Text من الجانب الأيمن وأدخل نصًا كـ تنزيل دليل المستخدم.
من قائمه الخصائص في الجزء الأيسر العلوي، حدد OnSelect.
أدخل صيغة كـ
Download("https://go.microsoft.com/fwlink/?linkid=827480"). كما يمكنك استخدام أي عنوان URL آخر من اختيارك.
احفظ التطبيق وانشره.
قم بتشغيل التطبيق.
حدد الزر تنزيل دليل المستخدم لتنزيل الدليل.
ملاحظة
تحدد إعدادات المتصفح ما إذا كنت تريد تنزيل الملف أو فتحه مباشرة في علامة تبويب جديدة. لمزيد من التفاصيل، انتقل إلى وصف وظيفة التنزيل.