Visual Studio自定义模板参数、备注

模板路径： 

VS2022 x64：C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\ItemTemplates

VS2022 x86：C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\ItemTemplates

一、声明和启用模板参数

   模板参数以 $参数$ 的格式进行声明。 例如：

• $rootnamespace$

• $guid1$

• $guid5$

二、在模板中启用参数替换

1. 在模板的 .vstemplate 文件中，找到与要为之启用参数替换的项对应的 ProjectItem 元素。

2. 将 ReplaceParameters 元素的 ProjectItem 属性设置为 true。

3. 在项目项的代码文件中，在适当位置上包括参数。 例如，以下参数指定根命名空间用于文件中的命名空间：

   namespace $rootnamespace$
   

三、保留的模板参数

下表列出可供任何模板使用的保留的模板参数：

参数	说明
clrversion	公共语言运行时 (CLR) 的当前版本。
ext_*	将 ext_ 前缀添加到任何参数，以引用父模板的变量。 例如，ext_safeprojectname。
guid[1-10]	一个用于替换项目文件中的项目 GUID 的 GUID。 可指定最多 10 个唯一的 GUID（例如，guid1）。
itemname	在其中使用参数的文件的名称。
machinename	当前的计算机名称（例如，Computer01）。
projectname	创建项目时由用户提供的名称。 此参数仅适用于项目模板。
registeredorganization	来自 HKLM\Software\Microsoft\Windows NT\CurrentVersion\RegisteredOrganization 的注册表项值。
rootnamespace	当前项目的根命名空间，后跟当前项的子文件夹，用句点替换斜杠。
defaultnamespace	当前项目的根命名空间。
safeitemname	与 itemname 相同，但所有不安全字符和空格替换为了下划线。
safeitemrootname	与 safeitemname 相同。
safeprojectname	用户在创建项目时提供的名称，但名称中删除了所有不安全字符和空格。 此参数仅适用于项目模板。
targetframeworkversion	目标 .NET Framework 的当前版本。
time	格式基于 Windows 用户设置的当前时间。 以 DD/MM/YYYY 00:00:00 时间格式为例。
specifiedsolutionname	解决方案的名称。 在选中“创建解决方案目录”时，specifiedsolutionname 具有解决方案名称。 在未选中“创建解决方案目录”时，specifiedsolutionname 为空。
userdomain	当前的用户域。
username	当前的用户名称。
webnamespace	当前网站的名称。 此参数在 Web 窗体模板中用于保证类名是唯一的。 如果网站在 Web 服务器的根目录下，则此模板参数解析为 Web 服务器的根目录。
year	以 YYYY 格式表示的当前年份。

 备注：模板参数区分大小写。

说明来源地址：https://learn.microsoft.com/zh-cn/visualstudio/ide/template-parameters?view=vs-2022

四、示例

  c#示例：

/*	CLR版本:			$clrversion$
*	新建项输入的名称:	$itemname$
*	机器名称:		    $machinename$
*	注册组织:		    $registeredorganization$
*	命名空间:		    $rootnamespace$
*	文件名:			    $safeitemrootname$
*	当前系统时间:		$time$	
*	用户所在域:		    $userdomain$
*	当前登录用户名:		$username$
*	创建年份:		    $year$
*	作者:SOESC
*/

VB.NET示例： 

'***************************************************************************************************
'
' Copyright © $year$ SOESC.COM. All rights reserved.
'
' 文件名称(File Name) ：$safeitemname$
'
' 命名空间(Namespaces) ：$rootnamespace$
'
' 功能描述(Description) ：无
'
' 数据表(Tables) ：无
'
' 作者(Author) ：无
'
' 日期(Create Date) ：$time$
'
' 版本号(Version)：V1.0.0.0
'
' 修改记录(Revision History) ： 无
'
'
'***************************************************************************************************