Warning: file_get_contents(/data/phpspider/zhask/data//catemap/0/xml/13.json): failed to open stream: No such file or directory in /data/phpspider/zhask/libs/function.php on line 167

Warning: Invalid argument supplied for foreach() in /data/phpspider/zhask/libs/tag.function.php on line 1116

Notice: Undefined index: in /data/phpspider/zhask/libs/function.php on line 180

Warning: array_chunk() expects parameter 1 to be array, null given in /data/phpspider/zhask/libs/function.php on line 181
C#三个斜杠:模板可以更改吗?_C#_Xml_Comments - Fatal编程技术网

C#三个斜杠:模板可以更改吗?

C#三个斜杠:模板可以更改吗?,c#,xml,comments,C#,Xml,Comments,在C#中,XML注释以三个正斜杠(//)开头。例如: /// <summary> /// /// </summary> /// <param name="sender"></param> /// <param name="e"></param> // /// /// /// /// 是否有任何方法可以更改生成的注释,例如添加其他标记?我想可能有一个定义XML的片段文件,但我找不到。有人能帮忙吗 更新:据我所知,

在C#中,XML注释以三个正斜杠(//)开头。例如:

/// <summary>
/// 
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
//
/// 
/// 
/// 
/// 
是否有任何方法可以更改生成的注释,例如添加其他标记?我想可能有一个定义XML的片段文件,但我找不到。有人能帮忙吗

更新:据我所知,现有版本的第一个答案只是提供了一个按需插入代码的片段。具体来说,summ+tab+tab可以插入摘要行。它似乎不涉及更改由///插入的XML,这正是我所寻找的

对这个问题的其他回答是,可以使用宏InsertDocComments来完成(但我不认为这是///所调用的,或者我不知道如何使它成为//),另一个回答是,无法完成。所以,如果真的无法做到,那好吧,但我还是希望如此。

我使用的是一个免费的Visual Studio扩展,当您在符号上按[Ctrl]+[Shift]+D时,它会自动生成xml文档

据我所知,您无法覆盖默认的
//
行为

没有外部软件的帮助,您可以创建自己的自定义代码段,这个代码段有一个快捷方式
ccc

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>Slashes</Title>
      <Author>Benjamin Thomas Blodgett</Author>
      <Shortcut>ccc</Shortcut>
      <Description>Creates xml documentation</Description>
    </Header>
    <Snippet>
      <Code Language="csharp">
        <![CDATA[/// <summary></summary>
/// <AnotherTag></AnotherTag>
/// <param name="sender"></param>
/// <param name="e"></param>$end$]]>
      </Code>
    </Snippet>
  </CodeSnippet>
</CodeSnippets>

砍
本杰明·托马斯·布洛吉特
ccc
创建xml文档

/// 
/// 
///$end$]>

当走这条路线时,你也可以添加制表位,正如我在下面所说的

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>Slashes</Title>
      <Author>Benjamin Thomas Blodgett</Author>
      <Shortcut>ccc</Shortcut>
      <Description>Creates xml documentation</Description>
    </Header>
    <Snippet>
      <Declarations>
        <Literal>
          <ID>summary</ID>
          <Default>Summary...</Default>
        </Literal>
        <Literal>
          <ID>anothertag</ID>
          <Default>Another Tag's Value...</Default>
        </Literal>
        <Literal>
          <ID>sender</ID>
          <Default>Sender Description...</Default>
        </Literal>
        <Literal>
          <ID>event</ID>
          <Default>Event Args...</Default>
        </Literal>
      </Declarations>
      <Code Language="csharp">
        <![CDATA[/// <summary> $summary$ </summary>
/// <AnotherTag> $anothertag$ </AnotherTag>
/// <param name="sender"> $sender$ </param>
/// <param name="e"> $event$ </param>$end$]]>
      </Code>
    </Snippet>
  </CodeSnippet>
</CodeSnippets>

砍
本杰明·托马斯·布洛吉特
ccc
创建xml文档
总结
总结。。。
另一个标签
另一个标记的值。。。
发件人
发件人描述。。。
事件
事件参数。。。

$summary$
///$anothertag$
///$sender$
///$event$$end$]>


作为旁注,StyleCop的代码片段相当不错,因为它们包含抛出的异常。“重复”看起来很相似,但实际上与我的问题毫无关系。我将对问题进行编辑以明确区别。