مشاركة عبر

عنصر ProjectItem (‏‫Visual Studio مشروع قوالب)

  • مقالة

تعين ملف الذي يتم تضمينه في مشروع قالب.

ملاحظة

ProjectItemيقبل عنصر السمات مختلفة استناداً إلى ما إذا كان يجب قالب لمشروع أو تشغيل العنصر. يشرح هذا المقال ProjectItemعنصر للمشروع قوالب. للحصول على توضيح ل ProjectItemرؤية العنصر لقوالب العنصر، عنصر ProjectItem (‏‫Visual Studio عنصر قوالب).

<ProjectItem
    TargetFileName="TargetFileName.ext"
    ReplaceParameters="true/false"
    OpenInEditor="true/false"
    OpenInWebBrowser="true/false"
    OpenInHelpBrowser="true/false"
    OpenOrder="Value">
        FileName.ext
</ProjectItem>

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

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

السمات

السمة

الوصف

TargetFileName

السمة الاختيارية

تحدد اسم ومسار عنصر المشروع عند تاريخ الإنشاء مشروع من قالب. Th هو سمة هو مفيدة لإنشاء بنية دليل مختلف عن بنية الدليل في ملف.zip قالب أو استخدام معلمة بديلة لإنشاء اسم عنصر.

ReplaceParameters

السمة الاختيارية

القيمة منطقية تحدد ما إذا كان العنصر يحتوي على قيم المعلمات يجب استبداله عند تاريخ الإنشاء مشروع من قالب. القيمة افتراضية هو false.

OpenInEditor

السمة الاختيارية

القيمة منطقية تحدد ما إذا كان يجب فتح العنصر في محرر الخاصة به في Visual Studioعند مشروع هو التي تم إنشاؤها من قالب.

OpenInWebBrowserو OpenInHelpBrowserويتم تجاهل السمات عنصر مع OpenInEditorالقيمة true.

القيمة الافتراضية هي false.

OpenInWebBrowser

السمة الاختيارية

القيمة منطقية تحدد ما إذا كان العنصر يجب فتح مستعرض ويب عند تاريخ الإنشاء مشروع من قالب.

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

القيمة الافتراضية هي false.

OpenInHelpBrowser

السمة الاختيارية

القيمة منطقية تحدد ما إذا كان يجب فتح العنصر في عارض التعليمات عند تاريخ الإنشاء مشروع من قالب.

ملفات HTML وملفات نصية محلية إلى يمكن فتح المشروع في تعليمات مستعرض. لا يمكن فتح محددات مواقع المعلومات خارجي مع هذا سمة.

القيمة الافتراضية هي false.

OpenOrder

السمة الاختيارية

قم بتعيين القيمة رقمية تمثل الترتيب الذي سيتم فتح عناصر في محرر الخاصة بها. يجب أن تكون الجميع قيم أكثر 10. عناصر مع السفلي OpenOrderفتح قيم أولاً.

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

لا يوجد.

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

العنصر

الوصف

Project

تعين الملفات أو الدلائل إلى إضافة للمشروع.

قيمة النص

قيمة النص تكون مطلوبة.

stringالذي يمثل اسم أو مسار إلى ملف في قالب ملف.zip.

ملاحظات

ProjectItemهو اختياري فرعProject.

TargetFileNameالسمات التي يمكن استخدامها لإنشاء بنية دليل مختلف عن بنية الدليل في قالب ملف.zip. على سبيل المثال، إذا كان الملف MyFile.vbموجود في جذر ملف.zip قالب، ولكن الملف إلى وضعها في direcإلىry يسمى CustomFilesفي الجميع مشاريع التي تم إنشاؤها من القالب، يمكنك استخدام XML التالي:

<ProjectItem TargetFileName="CustomFiles\MyFile.vb">MyFile.vb</ProjectItem>

TargetFileNameكما يمكن استخدام السمة إلى إعادة تسمية الملفات التي تحتوي على أحرف دولية في أسماء الملفات الخاصة بها. على سبيل المثال، لا يمكن أن ملف.zip قالب يتضمن أحرف Unicode مع أسماء الملفات، لذا يجب أن تتم تمت إعادة التسمية الملف قبل أن يتم ضغطها في ملف.zip. TargetFileNameسمة يمكن أن يستخدم لتعيين اسم الملف مرة أخرى إلى الأصلي Unicode ملف اسم.

TargetFileNameكما يمكن استخدام السمة إلى إعادة تسمية الملفات باستخدام معلمات. يفسر إجراء التالي كيفية إعادة تسمية الملف MyFile.vb، التي توجد في الدليل الجذر لملف.zip قالب، لاسم ملف استناداً إلى اسم مشروع.

إلى إعادة تسمية الملفات مع المعلمات

  1. استخدام XML التالية في.vstemplate ملف:

    <ProjectItem TargetFileName="$safeprojectname$.vb">MyFile.vb</ProjectItem>

  2. قم بفتح ملف مشروع (.vbproj ل Visual Basicمشروع) في محرر نصي أو Visual Studio. للحصول تشغيل مزيد من المعلومات حول ‏‏تحرير ملفات مشروع في vsprvs، راجع How to: Edit Project Files.

  3. بحث خط في ملف مشروع الذي يبدو مثل XML التالية:

    <Compile Include="MyFile.vb">

  4. قم باستبدال السطر من التعليمة البرمجية مع XML التالية:

    <Compile Include="$safeprojectname$.vb">

    عندما يتم تاريخ الإنشاء مشروع باستخدام هذا القالب، أن يعتمد اسم الملف تشغيل اسم قام مستخدم بإدخالها في صندوق الحوار مشروع جديد باستخدام الجميع حرف/ حروف غير آمنة وحذف المسافات منه. لمزيد من المعلومات، راجع قالب المعلمات.

مثال

يظهر المثال التالي ملفات التعريف الخاصة بمشروع قالب #Visual Cتطبيق.

<VSTemplate Type="Project" Version="2.0.0"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem ReplaceParameters="true">Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

راجع أيضًا:

المهام

كيفية القيام بما يلي: إنشاء قوالب مشروع يدوياً

المرجع

مرجع مخطط قالب Studio المرئي

عنصر ProjectItem (‏‫Visual Studio عنصر قوالب)

المبادئ

قالب المعلمات

كيفية القيام بما يلي: تشغيل ملفات محددة عند فتح قوالب

موارد أخرى

قوالب ‏‫Visual Studio