الدالة Copy

ينطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

ينسخ النص إلى الحافظة على الجهاز حيث يتم تشغيل التطبيق.

الوصف

تأخذ وظيفة النسخ أية قيمة نصية وتنسخها إلى الحافظة. بغض النظر عن محتويات النص، ستحتوي الحافظة على نص عادي بدون أي نوع mime خاص. تعتبر هذه الوظيفة وظيفة تأثيرات جانبيه ونتيجة لذلك لا يمكن استخدامها إلا في خصائص السلوك.

‏‫ملاحظة‬

تقتصر وظيفة Copy() على الوصول المعطى للحافظة بواسطة مضيف التطبيق. ونتيجة لذلك، فإن سيناريوهات التطبيقات المضمنة مثل Power Apps في SharePoint، والتطبيقات المضمنة في Power BI، و Teams، وغيرها لا تدعم Copy(). قد لا تدعم السيناريوهات المضمنة الأخرى الوظيفة أيضًا. ينبغي على المنشئين استخدام IfError() للتأكد من أن إجراء النسخ إلى الحافظة كان فعالاً، وإذا لم يكن كذلك، لتنبيه المستخدم بشكل صحيح بفشل النسخ.

بناء الجملة

نسخ ( نص )

• النص - مطلوب. النص المراد نسخه إلى الحافظة.

الأمثلة

إدخال نصي مع زر نسخ

يمكن استخدام وظيفة النسخ لإنشاء نمط من عناصر تحكم الإدخال كما هو مشاهد في العديد من التطبيقات، حيث يسمح زر في الوقت الحالي في نص الإدخال بنسخة سريعة من نص الإدخال إلى الحافظة.

1. أدخل عنصر تحكم Text input على شاشة. سيكون الاسمTextInput1 بشكل افتراضي.
2. إدراج عنصر تحكم زر على الشاشة، بجوار عنصر تحكم الإدخال.
3. قم بتعيين خاصية OnSelect الخاصة بالزر إلى نسخ (TextInput1.Text).

عند تحديد الزر، يتم نسخ النص من عنصر تحكم إدخال النص إلى الحافظة.

نص المعالجة لوضعه في الحافظة

تقبل وظيفة النسخ النص، والذي يمكن أن يكون في حد ذاته تعبيرا يعالج النص من تطبيقك بطريقة أو أخرى. على سبيل المثال، قد يحتوي التطبيق على سجل موظف يحتوي على الاسم الأول الموظف اسم العائلة وعنوانه. قد تضع صيغة هذه المعلومات في الحافظة كنص واحد. يستخدم المثال التالي سلسلة دمج البيانات في سلسلة واحدة:

Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )