C#三个斜杠:模板可以更改吗?
在C#中,XML注释以三个正斜杠(//)开头。例如:C#三个斜杠:模板可以更改吗?,c#,xml,comments,C#,Xml,Comments,在C#中,XML注释以三个正斜杠(//)开头。例如: /// <summary> /// /// </summary> /// <param name="sender"></param> /// <param name="e"></param> // /// /// /// /// 是否有任何方法可以更改生成的注释,例如添加其他标记?我想可能有一个定义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的代码片段相当不错,因为它们包含抛出的异常。“重复”看起来很相似,但实际上与我的问题毫无关系。我将对问题进行编辑以明确区别。