الدالتان Concat وConcatenate

ينطبق على: تطبيقات قماش Dataverse أعمدة الصيغة تدفقات سطح المكتب التطبيقات المستندة إلى النماذج Power Platform CLI

تسلسل سلاسل النص والسلاسل الفردية في الجداول.

‏‏الوصف

تقوم وظيفة Concatenate بدمج خليط من السلاسل الفردية وجدول عمود مفرد من السلاسل. عند استخدام هذه الدالة مع سلاسل فردية، فهي مكافئه لاستخدام عامل التشغيل&.

تعمل وظيفة Concat على تسلسل نتيجة الصيغة المطبقة عبر جميع سجلات الجدول، مما يؤدي إلى سلسلة مفردة. استخدم هذه الوظيفة لتلخيص سلاسل الجدول، مثلما تفعل وظيفة Sum تمامًا للأرقام.

تتوفر حقول السجل التي تتم معالجتها في الوقت الحالي في الصيغة. استخدم عامل ThisRecord أو ببساطة قم بالإشارة إلى الحقول بالاسم كما تفعل مع أي قيمة أخرى. كما يمكن استخدام عامل As لتسمية السجل الذي تتم معالجته والذي يمكن أن يساعد في تسهيل فهم الصيغة الخاصة بك وجعل السجلات المتداخلة قابلة للوصول. لمزيد من المعلومات، راجع الأمثلة التالية والعمل في نطاق السجلات.

استخدم وظيفة Split أو MatchAll لتقسيم سلسلة في جدول من السلاسل الفرعية.

بناء الجملة

Concat( جدول، صيغة، فاصل)

• الجدول - مطلوب. الجدول المُراد العمل عليه.
• الصيغة‏‎ - مطلوبة. الصيغة المُراد تطبيقها عبر سجلات الجدول.
• فاصل‏‎ - اختياري. قيمة نصية يتم إدخالها بين الصفوف المتسلسلة من الجدول.

Concatenate( String1 [، String2، ...] )

• سلسة (سلاسل) -مطلوبة. خليط من السلاسل الفردية أو جدول من عمود واحد للسلاسل.

الأمثلة

تستخدم الأمثلة الواردة في هذا القسم هذه المتغيرات العمومية:

• FirstName = ‏"Jane"
• LastName = ‏"Doe"
• المنتجات =

لإنشاء هذه المتغيرات العامة في تطبيق، قم بادراج عنصر تحكم Button، وقم بتعيين خاصية OnSelect الخاصة به إلى هذه الصيغة:

Set( FirstName, "Jane" ); Set( LastName, "Doe" );
Set( Products,
    Table(
        { Name: "Violin", Type: "String" },
        { Name: "Cello", Type: "String" },
        { Name: "Trumpet", Type: "Wind" }
    )
)

حدد الزر (بالنقر فوقه أثناء الضغط باستمرار على المفتاح Alt).

وظيفة التسلسل والعامل

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

صيغة	‏‏الوصف	نتيجة
Concatenate( LastName, ", ", FirstName )	يقوم بتسلسل القيمة في LastName، السلسلة "،" (فاصلة متبوعة بمسافة)، والقيمة في FirstName.	"Doe, Jane"
LastName & ", " & FirstName	تمامًا كالمثال السابق باستثناء استخدام عامل التشغيل & بدلاً من الدالة.	"Doe, Jane"
Concatenate( FirstName, " ", LastName )	يقوم بتسلسل القيمة في FirstName، السلسلة " " (مسافة واحدة)، والقيمة في FirstName.	"Jane Doe"
FirstName & " " & LastName	تمامًا كالمثال السابق، باستخدام عامل التشغيل & بدلاً من الدالة.	"Jane Doe"

التسلسل باستخدام جدول من عمود واحد

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

صيغة	‏‏الوصف	نتيجة
Concatenate( "Name: ", Products.Name, ", Type: ", Products.Type )	بالنسبة إلى كل سجل في جدول المنتجات، تتم سلسلة السلسلة "الاسم: "، اسم المنتج، والسلسلة "، النوع: "، ونوع المنتج.	جدول بعمود واحد بعمود Valueيحتوي على القيم التالية: "Name: Violin, Type: String"‏، و"Name:‏ "Cello، وType: String"، و"Name: Trumpet، وType: Wind"

وظيفة Concat

بالنسبة لهذه الأمثلة، قم بتعيين خاصية Text للتسمية إلى صيغة من العمود الأول في الجدول التالي.

الصيغة	الوصف	نتيجة
Concat( المنتجات، الاسم, ", " )	تقييم التعبير الاسم بالنسبة لكل سجل منتجات وتسلسل النتائج معًا في سلسلة نص واحدة مفصولة بـ ", ".	"'Violin', 'Cello', 'Trumpet'"
Concat( Products, "'" & Name & "'", ", " )	تقييم التعبير "'" & Name & "'" لكل سجل منتجات‏‎ وسلسلة النتائج معًا في سلسلة نص واحدة مفصولة بواسطة ", ".	"'Violin', 'Cello', 'Trumpet'"
Concat( Filter( Products, Type = "String" ), Name, ", " )	تقييم الصيغة الاسم لكل سجل منتجات يفي بعامل التصفية النوع = "السلسلة"، وتسلسل النتائج في سلسلة نص واحدة مفصولة بـ ", ".	"Violin, Cello"

التقسيم وMatchAll

إذا كنت قد استخدمت Concat مع فاصل، فيمكنك عكس العملية بدمج الوظيفة Split.

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

الصيغة	الوصف	نتيجة
Split( Concat( المنتجات، الاسم, ", " ), ", " )	تقسيم السلسلة النصية باستخدام الفاصل "، ".	جدول بعمود واحد بعمود Value يحتوي على القيم التالية: "Violin"، و"Cello"، و"Trumpet"