我可以在 XML 文档注释中使用引号吗?
Can I use quote marks in an XML documentation comment?
在 C# 源文件中编写 XML 文档注释时,是否需要将 "
替换为 "
? This question 讨论 如何 替换字符,但没有确定 哪些 字符需要替换,除了确定尖括号确实需要替换。
不,就像正常的 XML 一样,您只需要在引号具有特殊含义时转义引号。因此,如果您的 XML 文档包含一个属性并且您希望在属性值中使用双引号, 然后 您可以使用属性或对值使用单引号 start/end:
/// Foo <element attr="Bar"Baz" />
/// Foo <element attr='Bar"Baz' />
但根据我的经验,非常 需要在 XML 文档中使用带引号的属性值。它们几乎总是对参数、成员或列表类型的引用。
在 C# 源文件中编写 XML 文档注释时,是否需要将 "
替换为 "
? This question 讨论 如何 替换字符,但没有确定 哪些 字符需要替换,除了确定尖括号确实需要替换。
不,就像正常的 XML 一样,您只需要在引号具有特殊含义时转义引号。因此,如果您的 XML 文档包含一个属性并且您希望在属性值中使用双引号, 然后 您可以使用属性或对值使用单引号 start/end:
/// Foo <element attr="Bar"Baz" />
/// Foo <element attr='Bar"Baz' />
但根据我的经验,非常 需要在 XML 文档中使用带引号的属性值。它们几乎总是对参数、成员或列表类型的引用。