创建多文件模板
应用模板时,一个文件模板可以创建多个文件。 当相关数据保存在不同文件中时,这可能会很有帮助。
以下是关于多文件模板的一些注意事项:
文件模板始终包含一个主文件,并且可以选择包含任意数量的次要文件。 因此,一旦向任何文件模板添加了次要文件,您就获得了一个多文件模板。
添加次要文件时,您可以引用任何现有的文件模板(从现有模板添加文件 选项)。 请注意,如果引用的模板也包含多个文件,则在应用模板时,仅会添加引用模板的主文件。
参数 集合跨越多文件模板的所有文件。 也就是说,如果在多文件模板的多个文件中使用相同的参数
$PARAM$,则在应用模板时,该参数在所有相关文件中将具有相同的值。
向文件模板添加新文件
在 模板编辑器 底部,单击 添加新文件 或 从现有模板添加文件。 将在主文件的正文下方添加一个新部分。
默认情况下,新次要文件会添加到与主文件相同的项目中。 如果您希望将其添加到不同的项目中,请在 项目 字段中指定该项目的名称。 请注意,如果指定的项目在应用模板的解决方案中不存在,则不会添加次要文件。
如果您希望将次要文件添加到不同的文件夹中,请在 文件夹 字段中指定该文件夹。 使用反斜杠表示文件夹层级。 请注意,如果指定了某个项目,则新文件夹路径将相对于该项目,否则将相对于主模板文件。
为次要文件指定一个名称。
$NAME$将被替换为主文件的名称(不含扩展名)。 请注意,与主文件不同,您不会被提示输入次要文件的名称。如果您使用 添加新文件 添加了次要文件,请为其提供正文。 您可以使用 参数 ,这些参数在模板的所有文件中共享其值。 如果某个参数在多个文件中使用,并且您打算将其保持为 可编辑 ,请在右侧的 形参 区域中选择可编辑的实例;当用户应用模板时,该实例将在 热点会话 中可编辑。 在选择器中,实例的编号以字母为前缀:“M”表示主文件,“S0”、“S1”等表示次要文件。 表示次要文件。
如果您使用 从现有模板添加文件 添加了新文件,而不是文件正文,您将看到现有模板的参数列表。 如果需要,您可以将这些参数映射到当前模板的参数。
要保存模板,请在 Visual Studio 菜单中选择 或按 Ctrl+S 。
此功能在以下语言和技术中 受支持:
此处提供的说明和示例针对在 C# 中使用该功能。 有关其他语言的更多信息,请参阅 语言和框架 部分中的相应主题。