如何:打包和安装工具箱的自定义控件

Visual Studio 包括许多**“工具箱”**控件。 如果这些控件不符合您的需要,则可以联机搜索其他控件或创建自己的自定义控件以便在 Visual Studio 中使用。

提示

对话框中的可用选项以及显示的菜单命令的名称和位置可能会与“帮助”中的描述不同,具体取决于您的当前设置或版本。 此帮助页是根据“常规开发设置”而编写的。 若要更改设置,请单击“工具”菜单上的“导入和导出设置”。 有关更多信息,请参见 使用设置

将控件打包以便通过 Visual Studio 内容安装程序进行安装

在创建了自定义控件之后,可以在 .vsi 文件中打包此控件,以便其他开发人员可以使用 Visual Studio 内容安装程序安装此控件。 内容安装程序仅识别 .vsi 文件。 .vsi 文件是一个压缩文件,其中包含控件的 .dll 文件以及必须具有 .vscontent 文件扩展名的基于 XML 的定义文件。

创建 .vscontent 文件

  1. 在**“文件”菜单上指向“新建”,然后单击“文件”**。

  2. 在**“常规”类别中,选择“XML 文件”,然后单击“打开”**。

  3. 通过使用 Visual Studio 内容安装程序架构参考为**“工具箱”**控件创建一个有效的 .vscontent 文件。

    例如:

    <VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
        <Content>
            <FileName>MyButtonControl.dll</FileName>
            <DisplayName>My Custom Button</DisplayName>
            <Description>A control created for this example.</Description>
            <FileContentType>Toolbox Control</FileContentType>
            <ContentVersion>2.0</ContentVersion>
        </Content>
    </VSContent>
    
  4. 将此 .vscontent 文件与控件的 .dll 文件保存在同一目录中。

在创建了 .vscontent 文件之后,可将此文件与控件的 .dll 文件在一起打包,方法是创建一个将由 Visual Studio 内容安装程序识别的 .vsi 文件。 如果需要,则可以将此 .vsi 文件分发给其他开发人员。

创建 .vsi 文件

  1. 在**“Windows 资源管理器”**中,选择自定义控件的 .dll 文件以及所创建的关联 .vscontent 文件。

  2. 右击所选的文件,单击**“发送到”,然后单击“压缩(zipped)文件夹”**。

    所选的文件将一起压缩为一个 .zip 文件。

  3. 将 .zip 文件的文件扩展名重命名为 .vsi。 如果需要,也可以重命名此文件。

    现在可以使用电子邮件、网站、网络共享或其他方法将该控件分发给其他人。

安装打包在 .Vsi 文件中的控件

找到已打包成 .vsi 文件的控件后,可以轻松地安装该控件,以便在 Visual Studio 中使用。

安装打包在 .vsi 文件中的自定义控件

  1. 双击 .vsi 文件。

    随即出现 Visual Studio 内容安装程序。

  2. 在**“选择要安装的内容”页上选择要安装的项,然后单击“下一步”**。 如果组件未经过签名,则会出现一条警告。

提示

强烈建议您阅读“发行者状态”中的信息,以确定控件是否已签名。 为了进一步确保安全,请单击“查看”以显示将在您的计算机上安装的文件的列表。

  1. 在**“安装内容”页上,单击“完成”**以安装该控件。

    如果当前未打开 Visual Studio,则安装程序将在安装过程中先打开然后再关闭 Visual Studio。

  2. 单击**“关闭”**以退出安装程序。

    此控件将显示在**“工具箱”“我的控件”**部分中。

请参见

参考

Visual Studio 内容安装程序架构参考

概念

Community Component Essentials