通过

模板内容 (声明。Vsdir 文件)

模板内容文档 (.vsdir) 是使集成开发环境将显示文件夹 (IDE)，向导 .vsz 文件和模板文件与对话框项的文本文件。 目录包括每个文件或文件夹一个记录。 所有 .vsdir 文件中引用的位置合并，不过，通常仅提供了 .vsdir 文件描述多个文件夹、向导或模板文件。

在 .vsdir 文件中引用的文件夹 (子目录)，文件和 .vsdir 文件都位于同一目录。 当 IDE 运行向导或显示一个文件夹或文件。 新项目 或 添加新项目 对话框时， IDE 检查包含执行的文件确定的内容 .vsdir 文件是否存在。 如果找到 .vsdir 文件， IDE 读取它确定其是否包含执行的或显示的文件夹或文件的项。 如果找到该项， IDE 在目录的向导或显示的执行使用信息。

下面的代码示例是从在 \BscPrj\BscPrj\BscPrjProjectItems\Source_Files 注册表项的 EnvSDK文件 SourceFiles.vsdir:

HeaderFile.h|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#125|130|#126|0|0|0|#127
SourceFile.cpp|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#122|110|#123|0|0|0|#124

在这种情况下，两个记录在一个文件。 新行 (回车符) 分隔每个记录。 每一行代表一个不同的文件类型。 一个管道 (|) 字符分隔。每个记录中的字段。 一个目录中可以包含具有不同的文件名的多个 .vsdir 文件，也可以具有每个文件类型创建一个名为 .vsdir 文件。

字段

下表列出了为每个记录指定的字段。

字段

说明

相对路径名 (RelPathName)

文件夹、模板或 .vsz 文件的名称，例如 HeaderFile.h 或 MyWizard.vsz。 此字段也可以是用于的名称表示文件夹。

{clsidPackage}

启用对本地化的字符串的访问，例如 LocalizedName、说明、 IconResourceId 和 SuggestedBaseName VSPackage 的 GUID，在 VSPackage 的附属动态链接库 (DLL)资源。 ，如果未提供， IconResourceId 应用 DLLPath。

备注

，除非一个或多个字段是资源标识符，此字段是可选的。此字段为符合第三方向导不本地化其文本的 .vsdir 文件通常是空。

LocalizedName

模板文件或向导的本地化名称。 此字段可以是字符串或窗体 “#ResID”的资源标识符。 此名称在 添加新项目 显示对话框。

备注

如果 LocalizedName 是资源标识符，则 {clsidpackage} 需要。

SortPriority

表示此模板文件或向导的相对优先级整数。 例如，在中，如果该项的值为 1，则此项目中与值的其他项目旁边显示的 1 中和与排序值的所有项目之前为 2 或更大。

排序优先级相对于在同一目录的项目。 可以具有多在同一目录中一个名为 .vsdir 文件。 在这种情况下，项目从该目录中的所有 .vsdir文件合并。 项目必须具有相同的优先级列表不区分大小写的字典按所显示的名称的序列。 _wcsicmp 函数用于对项目。

在 .vsdir 文件未描述的项目在 .vsdir 文件大于列表的最高优先级的数量包括由一个优先级。 结果为无论其名称，这些项是所显示的列表的末尾。

说明

模板文件或向导的本地化的说明。 此字段可以是字符串或窗体 “#ResID”的资源标识符。 ，在中选择时，此字符串出现在 新项目 或 添加新项目 对话框。

DLLPath 或 {clsidPackage}

用于加载模板文件或向导的图标。 使用 IconResourceId，图标加载作为资源在外部 .dll 或 .exe 文件。 使用 VSPackage 的 GUID，该 .dll 或 .exe 文件中标识使用完整路径或。 VSPackage 中实现 DLL 来加载图标 (不是附属 DLL)。

IconResourceId

在确定要显示的图标 DLL 或 VSPackage 实现 DLL 的资源标识符。

标志 (__VSDIRFLAGS)

用于禁用或启用 添加新项目 在对话框的 名称 和 位置 字段。 标志 字段的值是所需位标志的组合等效十进制数字。

当用户在 新 选项项目时，项目将决定名称字段和位置字段是否显示，当 添加新项目 对话框首次显示时。 一个项目，通过 .vsdir 文件，可以控制字段仅是否启用和禁用，在中选择时。

SuggestedBaseName

表示默认名称文件、向导或模板。 此字段为字符串或窗体 “#ResID”的资源标识符。 IDE 使用此值为项提供默认名称。 此基础值追加以整数值使该名称唯一，例如 MyFile21.asp。

在前面的列表，说明， DLLPath， IconResourceId，标志，并且， SuggestedBaseNumber 仅适用于模板和向导文件。 这些字段不适用于文件夹。 此条件在 BscPrjProjectItems 文件中的代码阐释了在 EnvSDK\BscPrj\BscPrj\BscPrjProjectItems 注册表项。 此文件包含三条记录 (每个文件夹) 与每个记录的四个字段:RelPathName， {clsidpackage}， LocalizedName 和 SortPriority。

General|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#110|100

Source_Files|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#111|110

Env|{E59935A1-6156-11d1-87A6-00A0C91E2A46}|#112|120

在创建向导文件时，还应考虑以下问题。

  • 任何没有有含义的数据的非必选字段应包含零 (0) 作为占位符。

  • 如果未提供本地化名称，相对路径名称用于向导文件。

  • DLLPath 重写图标位置的 clsidPackage。

  • 如果未定义图标， IDE 用该扩展名的文件替换默认图标。

  • 如果未提供建议的基名称， “使用 Project。

  • 如果删除 .vsz 文件、文件夹或模板文件，则必须从 .vsdir 文件还移除其关联的记录。

请参见

概念

向导 (。Vsz) 文件

其他资源

向导