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

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

للتصريح ومن تمكين معلمات القالب

تم تعريف معلمات القالب في $ تنسيق $ المعلمة. فعلى سبيل المثال:

• $ safeprojectname $

• $ $ guid1

• $ $ guid5

إلى تمكين استبدال معلمة في قوالب

1. في ملف .vstemplate للقالب حدد موقع ProjectItemالعنصر الذي يتوافق مع العنصر الذي تريد تمكين استبدال المعلمة لأجل

2. قم بتعيين السمة ReplaceParametersالخاصة بالعنصر ProjectItem إلى true.

3. في ملف التعليمات البرمجية لعنصر مشروع قم بتضمين المعلمات في المكان المناسب. على سبيل المثال، تحدد هذه المعلمة التالية استخدام اسم المشروع آمن لأجل مساحة الاسم في ملف:

   namespace $safeprojectname$
   

معلمات القالب محجوز

يسرد الجدول التالي معلمات القالب المحجوزة التي يمكن استخدامها من قبل أي قالب.

ملاحظة

معلمات القالب حساسة لحالة الأحرف.

المعلمة	الوصف
clrversion	الإصدار الحالي من وقت تشغيل اللغة العامة (CLR).
GUID [1-10]	استخدام معرف فريد عمومي (معرّف فريد عالمي) لتحل محل المشروع معرّف فريد عالمي في ملف المشروع. يمكنك تحديد حتى إلى 10 المعرفات الفريدة العمومية (على سبيل المثال، guid1).
itemname	اسم الموفر من قبل المستخدم في "إضافة جديد" مربع حوار العنصر.
machinename	اسم الكمبيوتر الحالي (على سبيل المثال، Computer01).
projectname	اسم الموفر من قبل المستخدم في مربع حوار مشروع جديد.
registeredorganization	القيمة المفتاح السجل من NT\CurrentVersion\RegisteredOrganization HKLM\Software\Microsoft\Windows.
rootnamespace	مساحة الاسم الجذر للمشروع الحالي. يتم استخدام هذه المعلمة لاستبدال مساحة الاسم فقط في العنصر الذي يتم إضافتها إلى مشروع.
safeitemname	اسم الموفر من قبل المستخدم في إضافة العنصر مربع حوار جديد، مع إزالة كل المسافات والأحرف غير آمنة.
safeprojectname	اسم الموفر من قبل المستخدم في مشروع جديد مربع حوار جديد، مع إزالة كل المسافات والأحرف غير آمنة.
time	الوقت الحالي بالتنسيق MM/DD/YYYY 00: 00: 00.
userdomain	مجال المستخدم الحالي.
username	اسم المستخدم الحالي.
webnamespace	اسم موقع ويب الحالي. يتم استخدام هذه المعلمة في قالب نموذج ويب لضمان أسماء فئات فريدة. إذا كان موقع ويب في الدليل الجذر لخادم ويب، هذه معلمة القالب الذي يحل إلى الدليل الجذر لخادم ويب.
year	السنة الحالية في تنسيق YYYY.

معلمات القالب المخصص

بالإضافة إلى معلمات القالب المحجوزة المستخدمة تلقائياً أثناء الاستبدال المعلمة يمكنك تعيين معلمات القالب والقيم الخاصة بك. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تمرير معلمات مخصصة إلى قوالب.

مثال: استبدال أسماء الملفات

يمكنك تحديد أسماء ملفات متغير لمشروع عناصر باستخدام معلمة مع TargetFileNameالسمة. على سبيل المثال، يمكنك تحديد أستخدم الملف .exe لأسم المشروع، المحدد بواسطة $projectname$, مثل اسم ملف.

<TemplateContent>
    <ProjectItem
        ReplaceParameters="true"
        TargetFileName="$projectname$.exe">
            File1.exe
    </ProjectItem>
      ...
</TemplateContent>

مثال: استخدام اسم المشروع في "مساحة أسم" الاسم

لاستخدام اسم المشروع لمساحة الاسم في Visual Basic C# الملف فئة Class1.cs, استخدم بناء الجملة التالي:

#region Using directives

using System;
using System.Collections.Generic;
using System.Text;

#endregion

namespace $safeprojectname$
{
    public class Class1
        {
            public Class1()
                {

                }
         }
}

في ملف .vstemplate لقالب مشروع تضمين التالي XML عند الرجوع إلى ملف Class1.cs:

<TemplateContent>
    <ProjectItem ReplaceParameters="true">
        Class1.cs
    </ProjectItem>
    ...
</TemplateContent>

راجع أيضًا:

موارد أخرى

قوالب ‏‫Visual Studio