إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تطبيقات Canvas Copilot Studio Desktop تتدفق أعمدة صيغة Dataverse التطبيقات المستندة إلى النموذج وظائف Power Platform CLI Dataverse Power Pages
اختبار ما إذا كانت السلسلة النصية تبدا أو تنهي سلسله نصيه أخرى.
الوصف
تختبر الدالة EndsWith ما إذا كانت سلسلة نصية تنتهي بأخرى.
تختبر الدالة StartsWith ما إذا كانت سلسلة نصية تبدأ بأخرى.
بالنسبة لكلا الوظيفتين، تكون الاختبارات غير حساسة لحالة الأحرف إذا كان مصدر البيانات الخلفي يدعمها بشكل افتراضي. على سبيل المثال، تدعم المجموعات، وDataverse، وSharePoint، وSQL Server عدم حساسية حالة الأحرف بشكل افتراضي. لا تفعل Oracle ذلك. وتكون قيمة الإرجاع لكل منهما هي القيمة المنطقية صواب أو خطأ.
استخدم EndsWith و StartsWith مع الدالة Filter للبحث في البيانات داخل تطبيقك. يمكنك أيضًا استخدام عامل في أو وظيفة Search للبحث في أي مكان داخل السلاسل النصية، ليس فقط في البداية أو النهاية. سيعتمد اختيارك للوظائف علي احتياجات تطبيقك وأي الوظائف يمكن تفويضها لمصدر البيانات الخاصة بك. إذا تعذر تفويض إحدى هذه الوظائف ، فسيظهر تحذير تفويض في وقت التأليف لتحذيرك من هذا القيد.
بناء الجملة
EndsWith( Text, EndText )
- النص – مطلوب. النص المراد اختباره.
- EndText – مطلوب. النص المراد البحث عنه في نهاية النص. إذا كانت EndText عبارة عن سلسلة فارغة، EndsWith فترجع true.
StartsWith( نص، نص البدء )
- النص – مطلوب. النص المراد اختباره.
- StartText – مطلوب. النص المراد البحث عنه في بداية النص. إذا كانت StartText عبارة عن سلسلة فارغة، StartsWith فترجع true.
الأمثلة
| صيغة | الوصف | نتيجة |
|---|---|---|
| EndsWith( "مرحبا بالعالم"، "العالم") | اختبار ما إذا كانت "Hello World" تنتهي بـ "World". الاختبار غير حساس لحالة الأحرف. | true |
| EndsWith( "وداعا"، "جيد" ) | اختبار ما إذا كان "Good bye" ينتهي بـ "good". تظهر وسيطة EndText وهي ("good") في النص وليس في النهاية. | false |
| EndsWith( "قل دائما مرحبا"، "مرحبا") | اختبار ما إذا كانت "Always say hello" تنتهي بـ "hello". | true |
| EndsWith( "Bye bye", "" ) | اختبار ما إذا كان "Bye bye" ينتهي بسلسلة نصية فارغة (يقوم Len بإرجاع 0). يتم تعريف تخفيف استخدامه في تعبيرات التصفية لإرجاع EndsWithtrue في هذه الحالة. | true |
| صيغة | الوصف | نتيجة |
|---|---|---|
| StartsWith( "مرحبا بالعالم"، "مرحبا") | اختبار ما إذا كانت "Hello World" تبدأ بـ "hello". الاختبار غير حساس لحالة الأحرف. | true |
| StartsWith( "وداعا"، "مرحبا") | اختبار ما إذا كانت "Good bye" تبدأ بـ "hello". | false |
| StartsWith( "قل دائما مرحبا"، "مرحبا") | اختبار ما إذا كانت "Always say hello" تبدأ بـ "hello". على الرغم من ظهور "hello" في النص، فانه لا يظهر في البداية. | false |
| StartsWith( "Bye bye", "" ) | اختبار ما إذا كان "Bye bye" يبدأ بسلسلة نصية فارغة (يقوم Len بإرجاع 0). يتم تعريف تخفيف استخدامه في تعبيرات التصفية لإرجاع StartsWithtrue في هذه الحالة. | true |
تجربة البحث عن المستخدم
في العديد من التطبيقات، يمكنك كتابة حرف أو أكثر في مربع البحث لتصفية قائمة السجلات في مجموعة بيانات كبيرة. أثناء الكتابة، تعرض القائمة فقط تلك السجلات التي تطابق معايير البحث.
توضح الأمثلة في بقية هذا الموضوع نتائج البحث في قائمة العملاء، والتي تحتوي على هذه البيانات:
لإنشاء مصدر البيانات هذا كمجموعة، أنشئ عنصر تحكم Button وقم بتعيين خصائص OnSelect الخاص به إلى هذه الصيغة:
ClearCollect(Customers, Table({ Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" }) )
كما هو موضح في هذا المثال، يمكنك إظهار قائمة بالسجلات الموجودة في عنصر تحكم Gallery في الجزء السفلي من الشاشة. بالقرب من أعلى الشاشة، يمكنك إضافة عنصر تحكم Text input تُسمى SearchInput، بحيث يمكن للمستخدمين تحديد السجلات التي تثير اهتمامهم.
عندما يكتب المستخدم الأحرف في SearchInput، تتم تصفية النتائج في المعرض تلقائيًا. في هذه الحالة ، يتم تكوين المعرض لإظهار السجلات التي يبدأ فيها اسم العميل (وليس اسم الشركة) بتسلسل الأحرف في SearchInput.إذا كتب المستخدم co في مربع البحث، يُظهر المعرض هذه النتائج:
للتصفية استنادًا إلى عمود الاسم، قم بتعيين خاصية Items الخاصة بعنصر تحكم gallery إلى إحدى هذه الصيغ:
| صيغة | الوصف | نتيجة |
|---|---|---|
| Filter( Customers, StartsWith( Name, SearchInput.Text ) ) | تصفية مصدر بيانات العملاء للسجلات التي تظهر فيها سلسلة البحث في بداية عمود الاسم. الاختبار غير حساس لحالة الأحرف. في حالة قيام المستخدم بكتابة co في مربع البحث، tسيعرض المعرض Colleen Jones وCole Miller. لا يعرض المعرض Mike Collins لأن عمود الاسم لهذا السجل لا يبدأ بسلسلة البحث. |
|
| Filter( Customers, SearchInput.Text in Name ) | تصفية مصدر بيانات العملاء للسجلات التي تظهر فيها سلسلة البحث في أي موضع في عمود الاسم. الاختبار غير حساس لحالة الأحرف. في حالة قيام المستخدم بكتابة co في مربع البحث، يعرض المعرض Colleen Jones،Cole Miller،Mike Collins لأن سلسلة البحث تظهر في أي موضع في عمود الاسم لجميع هذه السجلات. |
|
| Search( Customers, SearchInput.Text, "Name") | وبنفس طريقة استخدام عامل in، تبحث وظيفة Search عن تطابق في أي موضع داخل عمود الاسم لكل سجل. لاحظ أنه يجب إحاطة اسم العمود بعلامات اقتباس مزدوجة. |
|
يمكنك توسيع نطاق البحث ليشمل عمود الشركة فضلاً عن عمود الاسم:
| صيغة | الوصف | نتيجة |
|---|---|---|
| Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) | تصفية مصدر بيانات العملاء للسجلات التي يبدأ فيها عمود الاسم أو عمود الشركة بسلسلة البحث (على سبيل المثال، co). || يكون عامل التشغيلصحيحا إذا كانت أي من الدالتين StartsWithصحيحة. |
|
| Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company ) | تصفية مصدر بيانات العملاء للسجلات التي يحتوي فيها عمود الاسم أو عمود الشركة على سلسلة البحث (على سبيل المثال، co) في أي موضع بها. |
|
| Search( Customers, SearchInput.Text, "Name", "Company" ) | بنفس طريقة استخدام عامل in، تبحث وظيفة Search عنمصدر بيانات العملاء للسجلات التي يحتوي فيها عمود الاسم أو عمود الشركة على سلسلة البحث (على سبيل المثال، co) في أي موضع فيها. وظيفة Search أسهل في القراءة والكتابة من وظيفة Filter إذا كنت تريد تحديد أعمدة متعددة وعوامل in متعددة. لاحظ أنه يجب إحاطة أسماء الأعمدة بعلامات اقتباس مزدوجة. |
|