Applies ToExcel لـ Microsoft 365

استخدم الدالة PY للوصول إلى Python في Excel من شبكة Microsoft 365 Excel.  

هام: بعد إدخال =PY في خلية وتحديد الدالة PY من قائمة الإكمال التلقائي، تتحول تجربة تحرير الخلية إلى محرر Python. لمعرفة المزيد، راجع مقدمة حول Python في Excelوبدء استخدام Python في Excel

بناء الجملة 

تقوم الدالة PY بتشغيل تعليمة Python البرمجية في وقت تشغيل Microsoft Cloud آمن. يتم إرجاع النتيجة إما كعنصر Python أو قيمة Excel. 

=PY(python_code,return_type) 

الوسيطة

الوصف

python_code

(مطلوب)

التعليمة البرمجية Python لتشغيلها في وقت تشغيل Microsoft Cloud آمن. يجب أن يكون نصا ثابتا.

return_type

(مطلوب)

حدد نوع الإرجاع المطلوب. يجب أن يكون رقما ثابتا 0 أو 1. 

  • يشير 0 إلى قيمة Excel.

  • يشير 1 إلى كائن Python.

مراجع Excel 

يمكن أن تشير التعليمات البرمجية Python إلى القيم في Excel باستخدام دالة Python المخصصة xl().  

تدعم الدالةxl()الرجوع إلى عناصر Excel التالية.

  • نطاقات

  • أسماء

  • الجداول

  • اتصالات Power Query

تدعم الدالة xl() وسيطة عناوين اختيارية. تحدد وسيطة الرؤوس ما إذا كان الصف الأول يحتوي على رؤوس. على سبيل المثال، يشير xl("A1:Z10", headers=True)إلى أن الخلايا A1:Z1 هي رؤوس. 

ملاحظات 

  • لا يمكن استخدام الدالة PY مع أي دالات Excel أخرى. إذا تم استخدامه مع دالات أخرى، فلا يمكن إدخال صيغة.

  • يمكن رؤية الدالة PY بواسطة FORMULATEXT وكتابتها وقراءتها بواسطة الوظائف الإضافية.

  • يجب أن تكون الوسيطتانpython_code return_type ثابتة.

أمثلة 

يستخدم المثال 1 عامل تشغيل Python plus لإنشاء "مرحبًا بالعالم" من 3 أجزاء نصية. 

=PY('Hello' + ' ' + 'World',0) 

 ——————————————————————————— 

يستخدم المثال 2 الدالة xl() للحصول على البيانات من Table1 وإرجاع النتيجة كعنصر Python. 

=PY("xl(""Table1[#All]"", headers=True)",1) 

هل تحتاج إلى مزيد من المساعدة؟

الخروج من الخيارات إضافية؟

استكشف مزايا الاشتراك، واستعرض الدورات التدريبية، وتعرف على كيفية تأمين جهازك، والمزيد.

تساعدك المجتمعات على طرح الأسئلة والإجابة عليها، وتقديم الملاحظات، وسماعها من الخبراء ذوي الاطلاع الواسع.