大网数据广告活动
.NET 与 C# 开发

打包和部署自定义 My 扩展 (Visual Basic)

· 52CE 我爱测

Visual Basic 提供了用于轻松对你可以部署您的自定义My通过使用 Visual Studio 模板的命名空间扩展。 如果要为其创建的项目模板在My扩展新的项目类型的重要组成部分,您只需包含您的自定义My项目导出模板时使用的扩展插件代码。 有关导出项目模板的详细信息,请参阅如何:创建项目模板。

Visual Basic 提供了用于轻松对你可以部署您的自定义My通过使用 Visual Studio 模板的命名空间扩展。 如果要为其创建的项目模板在My扩展新的项目类型的重要组成部分,您只需包含您的自定义My项目导出模板时使用的扩展插件代码。 有关导出项目模板的详细信息,请参阅如何:创建项目模板。

如果您的自定义My扩展在单个代码文件中,你可以将文件导出为用户可添加到任何类型的 Visual Basic 项目项模板。 然后可以自定义项模板以启用其他功能和您的自定义行为MyVisual Basic 项目中的扩展。 这些功能包括:

  • 允许用户管理您的自定义My从扩展My 扩展Visual Basic 项目设计器页。

  • 自动添加您的自定义My扩展时指定的程序集的引用添加到项目。

  • 隐藏My扩展中的项模板添加项对话框中,以便它不包含在项目项的列表。

本主题讨论如何打包自定义My为隐藏的项模板,以便可以从管理扩展My 扩展Visual Basic 项目设计器页。 自定义My对指定的程序集的引用添加到项目时,扩展可以还会自动添加。

创建 My namespace 扩展

创建自定义的部署包的第一步My扩展是创建为单个代码文件扩展名。 有关详细信息和有关如何创建自定义指南My扩展,请参阅扩展在 Visual Basic 中的 My Namespace。

导出为项模板的 My namespace 扩展

有一个文件,其中包括后你My命名空间扩展可以将代码文件导出为 Visual Studio 项模板。 有关如何将文件导出为 Visual Studio 项模板的说明,请参阅如何:创建项模板。

Note: 如果你My命名空间扩展具有特定的程序集的依赖项,则可以自定义项模板以自动安装在My命名空间扩展添加到该程序集的引用时。 因此,想要排除该程序集引用时将代码文件导出为 Visual Studio 项模板。

自定义项模板

可以让您从管理的项模板My 扩展Visual Basic 项目设计器页。 此外可以启用要指定程序集的引用添加到项目时自动添加的项模板。 若要启用这些自定义,将添加一个新文件,称为 CustomData 文件,为你的模板,然后将新元素添加到 XML,在.vstemplate 文件中。

添加 CustomData 文件

CustomData 文件是具有文件扩展名的文本文件。CustomData (文件名称可以设置为任何值到你的模板有意义) 和包含的 XML。 CustomData 文件中的 XML 指示 Visual Basic 包括你My扩展用户使用时My 扩展Visual Basic 项目设计器页。 你可以选择添加 <AssemblyFullName>到 CustomData 文件 XML 属性。 这会指示 Visual Basic 会自动安装您的自定义My扩展时对特定的程序集的引用添加到项目。 可以使用任何文本编辑器或 XML 编辑器来创建 CustomData 文件,然后将其添加到项模板的压缩的文件夹 (.zip 文件)。

例如,以下 XML 显示了 CustomData 文件,会将模板项添加到 Visual Basic 项目时 Microsoft.VisualBasic.PowerPacks.Vs.dll 程序集的引用的 My 扩展文件夹的内容添加到项目。

<VBMyExtensionTemplate
    ID="Microsoft.VisualBasic.Samples.MyExtensions.MyPrinterInfo"
    Version="1.0.0.0"
    AssemblyFullName="Microsoft.VisualBasic.PowerPacks.vs"
/>

CustomData 文件包含 <VBMyExtensionTemplate>具有属性,如以下表中列出的元素。

特性 描述
ID 必需。 扩展的唯一标识符。 如果具有此 ID 的扩展已添加到项目中,不会提示用户重新添加它。
Version 必需。 在项模板的版本号。
AssemblyFullName 可选。 程序集名称。 当此程序集的引用添加到项目中时,将提示用户添加My从此项模板的扩展。

添加<CustomDataSignature > 元素的.vstemplate 文件

若要确定 Visual Studio 项模板My命名空间扩展必须还修改您的项模板的.vstemplate 文件。 必须添加<CustomDataSignature>元素<TemplateData>元素。 <CustomDataSignature>元素必须包含文本Microsoft.VisualBasic.MyExtension,如以下示例所示。

<CustomDataSignature>Microsoft.VisualBasic.MyExtension</CustomDataSignature>

不能直接修改压缩的文件夹 (.zip 文件) 中的文件。 必须将.vstemplate 文件从压缩文件夹复制、 对其进行修改和已更新副本替换将压缩的文件夹中的.vstemplate 文件。

下面的示例显示了具有的.vstemplate 文件的内容<CustomDataSignature>添加元素。

<VSTemplate Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vstemplate/2005" Type="Item">
  <TemplateData>
    <DefaultName>MyCustomExtensionModule.vb</DefaultName>
    <Name>MyPrinterInfo</Name>
    <Description>Custom My Extensions Item Template</Description>
    <ProjectType>VisualBasic</ProjectType>
    <SortOrder>10</SortOrder>
    <Icon>__TemplateIcon.ico</Icon>
    <CustomDataSignature      >Microsoft.VisualBasic.MyExtension</CustomDataSignature>
  </TemplateData>
  <TemplateContent>
    <References />
    <ProjectItem SubType="Code"
                 TargetFileName="$fileinputname$.vb"
                 ReplaceParameters="true"
     >MyCustomExtensionModule.vb</ProjectItem>
  </TemplateContent>
</VSTemplate>

安装模板

若要安装此模板,您可以复制将压缩的文件夹 (.zip文件) 的 Visual Basic 项模板文件夹。 默认情况下,用户项模板都位于 %USERPROFILE%\Documents\Visual Studio<版本>\Templates\ItemTemplates\Visual Basic。 另外,您可以发布模板为 Visual Studio 安装程序 (.vsi) 文件。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 08/14/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。