樣板參數
更新：2007 年 11 月
所有範本都支援參數替換，因此當範本具現化時會啟用金鑰參數替換功能，例如類別名稱和命名空間。當使用者在 [新增專案] 或 [加入新項目] 對話方塊中按一下 [確定] 時，在背景中執行的範本精靈將會取代這些參數。
宣告和啟用範本參數
範本參數是以 $parameter$ 格式宣告。例如：
$safeprojectname$
$guid1$
$guid5$
若要啟用範本中的參數替換
在範本的 .vstemplate 檔中，找出與您要啟用參數替換之項目相對應的 ProjectItem 項目。
將 ProjectItem 項目的 ReplaceParameters 屬性 (Attribute) 設定為 true。
在專案項目的程式碼檔案中，在適當的位置加入參數。例如，下列參數指定 safeprojectname 用於某一檔案中的命令空間：
namespace $safeprojectname$
保留的範本參數
下表列出了保留的範本參數，它們可供任何範本使用：
.gif "注意事項") 注意事項： |
|---|
範本參數是區分大小寫的。 |
參數 |
描述 |
|---|---|
clrversion |
目前版本的 Common Language Runtime (CLR)。 |
GUID [1-10] |
GUID，用來取代專案檔的專案 GUID。您最多可以指定 10 個唯一 GUID (例如 guid1)。 |
itemname |
使用者在加入新項目對話方塊中提供的名稱。 |
machinename |
目前的電腦名稱 (例如 Computer01)。 |
projectname |
使用者在新增專案對話方塊中提供的名稱。 |
registeredorganization |
來自 HKLM\Software\Microsoft\Windows NT\CurrentVersion\RegisteredOrganization 的登錄機碼 (Registry Key) 值。 |
rootnamespace |
目前專案的根命名空間。這個參數是用來取代專案內所加入項目的命名空間。 |
safeitemname |
使用者在 [加入新項目] 對話方塊中提供的名稱，但名稱中所有的 Unsafe 字元和空格都已刪除。 |
safeprojectname |
使用者在 [新增專案] 對話方塊中提供的名稱，但名稱中所有的 Unsafe 字元和空格都已刪除。 |
time |
目前時間，其格式為 DD/MM/YYYY 00:00:00。 |
userdomain |
目前使用者的網域。 |
username |
目前使用者的名稱。 |
webnamespace |
目前網站的名稱。這個參數使用於 Web 表單範本中，以確保類別名稱是唯一的。如果網站位於 Web 伺服器的根目錄，則這個範本參數會解析至 Web 伺服器的根目錄。 |
year |
目前年份，其格式為 YYYY。 |
自訂範本參數
參數替換期間將會自動使用保留的範本參數。除了這些範本參數之外，您還可以指定自己的範本參數和值。如需詳細資訊，請參閱 HOW TO：傳遞自訂參數至樣板。
範例：取代檔名
您可以使用具有 TargetFileName 屬性的參數，為專案項目指定可變的檔名。例如，您可以指定 .exe 檔使用專案名稱做為檔案名稱，而且此專案名稱是由 $projectname$ 指定。
<TemplateContent>
<ProjectItem
ReplaceParameters="true"
TargetFileName="$projectname$.exe">
File1.exe
</ProjectItem>
...
</TemplateContent>
範例：使用專案名稱做為命名空間名稱
若要使用專案名稱做為 Visual C# 類別檔 (Class1.cs) 中的命名空間名稱，請使用以下語法：
#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
#endregion
namespace $safeprojectname$
{
public class Class1
{
public Class1()
{
}
}
}
當您在專案範本的 .vstemplate 檔中參考 Class1.cs 檔時，請加入以下的 XML：
<TemplateContent>
<ProjectItem ReplaceParameters="true">
Class1.cs
</ProjectItem>
...
</TemplateContent>