إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تطبيقات Canvas Copilot Studio Desktop تتدفق أعمدة صيغة Dataverse التطبيقات المستندة إلى النموذج وظائف Power Platform CLI Dataverse Power Pages
Replace جزء من سلسلة نص مع سلسلة أخرى.
الوصف
Replace تحدد الدالة النص المراد استبداله بموضع البداية والطول.
Substitute تحدد الدالة النص المراد استبداله بمطابقة سلسلة. إذا تم العثور على أكثر من تطابق، يمكنك استبدالهم جميعًا أو تحديد واحد لاستبداله.
إذا قمت بتمرير سلسلة واحدة، فإن القيمة المرجعة هي السلسلة المعدلة. إذا قمت بتمرير جدول بعمود واحد يحتوي على سلاسل، فإن القيمة المرجعة تكون جدول من عمود واحد مع عمود قيمة بالسلاسل المعدلة. إذا كان لديك جدول متعدد الأعمدة، يمكنك تشكيله في جدول من عمود واحد، مثلما يصف التعامل مع الجداول.
بناء الجملة
Replace( سلسلة، موضع البدء، NumberOfCharacters، NewString )
- سلسلة - مطلوب. السلسلة المراد العمل عليها.
- بدء الموضع - مطلوب. موضع الحرف لبدء الاستبدال. الحرف الأول من السلسلة هو الموضع 1.
- عدد الأحرف - مطلوب. عدد الأحرف المطلوب استبدالها في السلسلة.
- سلسلة جديدة- مطلوب. سلسلة الاستبدال. يمكن أن يختلف عدد الأحرف في هذه الوسيطة عن وسيطة NumberOfCharacters.
Substitute( سلسلة، OldString، NewString [، InstanceNumber ] )
- سلسلة - مطلوب. السلسلة المراد العمل عليها.
- OldString - مطلوب. السلسلة المراد استبدالها.
- سلسلة جديدة- مطلوب. سلسلة الاستبدال. يمكن أن يكون ل OldString و NewString أطوال مختلفة.
- رقم المثيل- اختياري. استخدم هذه الوسيطة لتحديد مثيل OldString المراد استبداله إذا كانت السلسلة تحتوي على أكثر من مثيل واحد. إذا لم تحدد هذه الوسيطة، فسيتم استبدال كل المثيلات.
Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )
- SingleColumnTable - مطلوب. جدول من عمود واحد للسلاسل المراد العمل عليها.
- بدء الموضع - مطلوب. موضع الحرف لبدء الاستبدال. الحرف الأول من كل سلسلة في الجدول في الموضع 1.
- عدد الأحرف - مطلوب. عدد الأحرف المطلوب استبدالها في كل سلسلة.
- سلسلة جديدة- مطلوب. سلسلة الاستبدال. يمكن أن يختلف عدد الأحرف في هذه الوسيطة عن وسيطة NumberOfCharacters.
Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )
- SingleColumnTable - مطلوب. جدول من عمود واحد للسلاسل المراد العمل عليها.
- OldString - مطلوب. السلسلة المراد استبدالها.
- سلسلة جديدة- مطلوب. سلسلة الاستبدال. يمكن أن يكون ل OldString و NewString أطوال مختلفة.
- رقم المثيل- اختياري. استخدم هذه الوسيطة لتحديد مثيل OldString المراد استبداله إذا كانت السلسلة تحتوي على أكثر من مثيل واحد. إذا لم تحدد هذه الوسيطة، فسيتم استبدال كل المثيلات.
الأمثلة
| صيغة | الوصف | نتيجة |
|---|---|---|
| Replace( "abcdefghijk", 6, 5, "*" ) | استبدال خمسة أحرف في "abcdefghijk" بحرف "*" واحد، بدءًا من الحرف السادس ("f"). | "abcde*k" |
| Replace( "2019", 3, 2, "20" ) | استبدال آخر حرفين من "2019" بـ "20". | "2020" |
| Replace( "123456", 1, 3, "_" ) | استبدال الأحرف الثلاثة الأولى من "123456" بحرف "_" واحد. | "_456" |
| Substitute( "بيانات المبيعات"، "المبيعات"، "التكلفة" ) | استبدال سلسلة "التكلفة" بـ "المبيعات". | "بيانات التكلفة" |
| Substitute( "الربع الأول، 2018"، "1"، "2"، 1 ) | استبدال المثيل الأول فقط من "1" بـ "2" لأن الوسيطة الرابعة (InstanceNumber) تم توفيرها مع a 1. | "ربع السنة الثاني، 2018" |
| Substitute( "الربع الأول، 2011"، "1"، "2"، 3 ) | استبدال المثيل الثالث فقط من "1" بـ "2" لأن الوسيطة الرابعة (InstanceNumber) تم توفيرها مع a 3. | "ربع السنة الأول، 2012" |
| Substitute( "الربع الأول، 2011"، "1"، "2" ) | استبدال جميع المثيلات من "1" بـ "2" لأن الوسيطة الرابعة (InstanceNumber) لم يتم توفيرها. | "ربع السنة الثاني، 2022" |
|
Replace( [ "الربع الأول، 2018"، "الربع الثاني، 2011"، "الربع 4، 2019" ]، 9, 1, "3" ) |
استبدال الحرف التاسع في كل سجل من جدول العمود الواحد بـ "3". | جدول بعمود واحد بعمود Value يحتوي على القيم التالية: [ "Quarter 3, 2018","الربع الثالث، 2011"، "الربع الثالث، 2019" ] |
|
Substitute( [ "الربع الأول، 2018"، "الربع الأول، 2011"، "Q1, 2019" ], "1", "3", 1 ) |
لأن الوسيطة الرابعة ( InstanceNumber) متوفرة مع القيمة 1، فإنه يتم استبدال المثال الأول "1" فقط في كل سجل من جدول العمود الواحد بـ "3". | جدول بعمود واحد بعمود Value يحتوي على القيم التالية: [ "Qtr 3, 2018","الربع الثالث، 2011"، "Q3,2019"] |
|
Substitute( [ "الربع الأول، 2018"، "الربع الأول، 2011"، "Q1, 2019" ], "1", "3" ) |
نظرًا لأنه لا يتم توفير الوسيطة الرابعة ( InstanceNumber)، فإنه يتم استبدال جميع مثيلات "1" في كل سجل من جدول العمود الواحد بـ "3". | جدول بعمود واحد بعمود Value يحتوي على القيم التالية: [ "Qtr 3, 2038","الربع الثالث، 2033"، "Q3,2039"] |