عنصر العنصر (‏‫MSBuild)

يحتوي على عنصر معرف من قبل المستخدم و بيانات التعريف الخاصة به. يجب تحديد كل عنصر مستخدم في المشروع MSBuild كفرع من عنصر ItemGroup.

<Item Include="*.cs"
        Exclude="MyFile.cs"
        Condition="'String A'=='String B'" >
    <ItemMetadata1>...</ItemMetadata1>
    <ItemMetadata2>...</ItemMetadata2>
</Item>

السمات والعناصر

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

السمة	الوصف
Include	سمة مطلوبة. ملف أو حرف بدل لتضمينه في العنصر.
Exclude	السمة الاختيارية ملف أو حرف بدل لإستثنائه في العنصر.
Condition	السمة الاختيارية الشرط الذي سيتم تقييمه. لمزيد من المعلومات، راجع شروط ‏‫MSBuild.

العناصر التابعة

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

العناصر الأصلية

العنصر	الوصف
مجموعة العنصر	تجميع العنصر للعناصر.

ملاحظات

عناصر Item تعرف الإدخالات إلى نظام البناء و يتم تجميعها إلى مجموعات العنصر تبعا لأسامي المجموعة المعرفة من قبل المستخدم. يمكن استخدام مجموعات العنصر هذه كمعلمات لـ tasks ، التي تستخدم العناصر الفردية المضمنة في المجموعة لتنفيذ خطوات عملية الإنشاء. لمزيد من المعلومات، راجع عناصر ‏‫MSBuild.

باستخدام منهج @(myType) يسمح لمجموعة من العناصر من النوع myType لتوسيعها إلى قائمة من السلاسل محددة بفاصلة منقوطة (;) و يتم تمريرها إلى المعلمة. إذا كانت المعلمة من النوع string، إذا قيمة المعلمة هي قائمة العناصر المفصولة بفواصل منقوطة. إذا كانت معلمة صفيف من سلاسل (string[]) ، يتم إدراج كل عنصر في الصفيف استناداً إلى موقع الفواصل المنقوطة. إذا كانت معلمة المهمة من النوع ITaskItem[]، القيمة هي محتويات مجموعة العنصر مع أية بيانات تعريف مرفقة. لتحديد كل عنصر بـ حرفاً بدلاً من الفاصلة منقوطة, استخدم بناء الجملة @(myType, 'separator').

المحرك MSBuild يكون قادراً على تقييم أحرف البدل مثل * و ? بالإضافة إلى أحرف البدل العودية مثل /**/*.cs. لمزيد من المعلومات، راجع عناصر ‏‫MSBuild.

مثال

مثال التعليمات البرمجية التالي يوضح كيفية تعريف عنصرين من النوع CSFile. العنصر المُعرف الثاني يحتوي على بيانات التعريف مع myAttribute معيّن إلى HelloWorld.

<ItemGroup>
    <CSFile Include="engine.cs; form.cs" />
    <CSFile Include="main.cs" >
        <MyMetadata>HelloWorld</MyMetadata>
    </CSFile>
</ItemGroup>

راجع أيضًا:

المبادئ

عناصر ‏‫MSBuild

خصائص ‏‫MSBuild

مرجع مخطط ملف مشروع ‏‫MSBuild