XML CodeSnippet文件中的多个.snippet

Question

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

我已经创建了一个.snippet文件，并将其放置在"%Visual文件夹%\代码片段\Visual\“文件夹中。我使用了代码片段管理器，并确保它包含了这个文件夹，这样我就可以访问代码片段了。

当我在根CodeSnippet标记中有一个CodeSnippets标记时，一切都很好.

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

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

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

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

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

在这里，我似乎并不理解一些非常基本的东西，我很想找到答案，但是显然代码片段被使用了，所以找到答案比我最初想象的要复杂一些。

谢谢,

-Frinny

Answer 1

--您是否需要为您想要提供的每个代码片段提供一个单独的.snippet文件？在阅读了有关创建代码段的MSDN之后，我的印象是，这一切都可以在一个文件中完成。

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

CodeSnippet可选元素。-所有代码段数据的父元素。在一个CodeSnippet元素中可能有零个或多个CodeSnippets元素。

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

更新

我不能让VB使用VS2k8在一个文件中支持多个片段。我使用下面的代码片段作为测试用例。摘自http://msdn.microsoft.com/en-us/library/ms165394.aspx的片段。只读取/加载/使用第一个CodeSnippet。我还计算了所有片段文件(1143)中的所有CodeSnippet元素，没有一个文件超过一个。此外，这个片段重复了您在问题中注意到的行为。使用代码片段插入两个消息框语句。

<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>

更多信息

我想这一定是一个漏洞，因为微软从未在Visual提供的片段文件中放置多个代码段，或者VB.NET由于难以与编辑器的增强语句完成功能集成而不支持多个代码段。