vb.net - XML .snippet 文件中的多个 CodeSnippet

Question

我试图通过向其他开发人员提供代码片段来补充我的代码的帮助功能。这些生成代码骨架，演示如何使用/调用我的类或方法。

我已经创建了一个 .snippet 文件并将它放在“%Visual Studio Folder%\Code Snippets\Visual Basic\My Snippets”文件夹中。我使用了代码片段管理器并确保它包含此文件夹，以便我可以访问代码片段。

当我在根 CodeSnippets 标签中有 1 个 CodeSnippet 标签时，一切正常......

当我向文件中添加多个 CodeSnippet 标签(每个标签都有自己的标题和代码示例)时，我遇到了一些奇怪的事情。

我添加的第一个 CodeSnippet 包含用于向系统添加内容的代码，第二个包含用于在系统中编辑内容的代码，第三个包含从系统中删除内容的代码。

当我通过右键单击并选择“插入代码片段”来使用代码片段时，只有文件中的第一个代码片段显示为一个选项。当我选择它时，第一个 CodeSnippet 中的代码被插入......但其他 CodeSnippet 标签中的代码也是如此。

对于要提供的每个代码片段，您是否必须有一个单独的 XML .snippet 文件？

在阅读了关于创建代码片段的 MSDN 之后，我的印象是这一切都可以在一个文件中完成。

似乎我不了解这里的一些非常基本的东西，并且很想找到答案，但显然代码片段未得到使用，因此事实证明，找到答案比我最初想象的要棘手一些。

谢谢，

-弗林尼

Answer 1

Do you have to have a separate XML .snippet file for each code snippet you want to make available? After reading through MSDN about creating Code Snippets I was under the impression that this could all be done within one file.

我一直在创建和使用片段。我想做你想做的。但是，我从来没有在一个文件中得到多个片段来工作。我也觉得你可以做到这一点。我什至找到了一篇基于 Visual Studio 测试版的文章，该文章演示了如何执行此操作，但没有奏效。此外，文档指出:

CodeSnippet Optional element. - Parent element for all code snippet data. There may be zero or more CodeSnippet elements in a CodeSnippets element.

我最终放弃并创建了单独的文件。我还没有用 VS2k8 在一个文件中尝试过多个片段。

更新

我无法让 VB 使用 VS2k8 在一个文件中支持多个片段。我使用以下代码段作为测试用例。摘自 http://msdn.microsoft.com/en-us/library/ms165394.aspx 的片段.只有第一个 CodeSnippet被读取/加载/使用。我也全数了 CodeSnippet所有片段文件 (1143) 中的元素，并且没有一个文件有多个。此外，此代码段重复了您在问题中指出的行为。使用该代码段插入两个消息框语句。

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2008/CodeSnippet">
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>
        SECOND Snippet
      </Title>
    </Header>
    <Snippet>
      <Code Language="VB">
        <![CDATA[MsgBox("SECOND SNIPPET")]]>
      </Code>
    </Snippet>
  </CodeSnippet>
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>
        FIRST Snippet
      </Title>
    </Header>
    <Snippet>
      <Code Language="VB">
        <![CDATA[MsgBox("FIRST SNIPPET")]]>
      </Code>
    </Snippet>
  </CodeSnippet>
</CodeSnippets>

更多信息

我开始认为这一定是一个漏掉的错误，因为 Microsoft 从未在 Visual Studio 附带的提供的代码段文件中放置多个代码段，或者 VB.NET 由于难以与增强的语句完成集成而不支持多个代码段编辑器的能力。