c# - 为什么我的代码块没有在 Sandcastle 帮助文件中呈现？

Question

我正在使用与 VS.NET 2012 集成的 Codeplex 的当前版本的 Sandcastle 来构建.cmh帮助文件。正在创建帮助文件，但我似乎无法<code>在帮助文件中发出任何块。我有以下简单的示例，我一直在使用：

/// <summary>
/// This is the summary 
/// </summary>
/// <code>var s;</code>
public string SomeValue { get; set; }

当我查看输出 .chm 文件时，var s;代码不存在于任何地方。我做了以下事情：

• Code Block Component在 Sandcastle 项目属性中添加了对的引用。
• 尝试制作标签<code lang="C#">var s;</code>，<code language="C#">var s;</code>但都没有改变。
• 阅读以下站点上详细说明此过程但无济于事的文档：
  https ://www.simple-talk.com/dotnet/.net-tools/taming-sandcastle-a-.net-programmers-guide-to-documenting-你的代码/
  http://www.ewoodruff.us/shfbdocs/

该示例显然是一个简化版本，但我只是想在这里获得基础知识。我做错了什么或遗漏了什么？

Answer 1

我不认为代码标签本身是允许的，试着把它放在一个<example>标签里，比如<example><code>var s;</code></example>. 所以这应该工作：

/// <summary>
/// This is the summary 
/// </summary>
/// <example>
/// <code>var s;</code>
/// </example>
public string SomeValue { get; set; }