c# – CSHTML / Razor Views的文档

2019年7月28日 155次阅读

我正在努力记录我们的显示和编辑模板(作为扩展,记录我们所有的CS
HTML都是有益的).话虽如此,我从未见过任何记录CSHTML Razor Views的方法.

例如,我有这个CSHTML EditorTemplate：MoneyPicker.cshtml

@model Decimal?
@{
    Layout = null;
}
<div class="money-picker" data-money-picker>
    <div class="form-control-wrapper">
        @Html.TextBox(
            "",
            ViewData.TemplateInfo.FormattedModelValue,
            new
            {
                type = "number",
                @class = "form-control money-control",
                placeholder = ViewData.ModelMetadata.Watermark ?? ViewData.ModelMetadata.DisplayName
            } )
    </div>
</div>

我知道它不是C#,但是有一些方法可以添加XML文档(或等效的)：

    /// <summary>
    /// Displays a text box wrapped with the money-picker wrappers, allowing javascript to show money buttons to pick the value.
    /// </summary>
    /// <param name="Model">A currency value</param>
    /// <remarks>
    /// The input is a text box that has the type "number"
    /// </remarks>

或者如果没有,有没有人找到某种方法来记录编辑器/显示模板,这些模板可以被某种类似于Asp.Net WebApi的api帮助页面的系统选中？理想情况下,它会更进一步,从父类型开始,并允许您深入到每个类型的属性编辑器等,但我只是想先开始小.

编辑：作为其中的一部分,我还希望生成模板的示例,而无需硬/手动编写所述示例,只是为了帮助澄清我的想法.

最佳答案 我也研究了这个,但我找不到任何记录View的方法,现在我刚刚记录了Controller中的Views：

/// <summary>
/// This is an example of documentation for the View.
/// </summary>
/// <returns>This is what I am returning.</returns>
public ActionResult CreateNewUser()
{
    return View();
}

您可以使用以下方法为此生成文档： SandCastle(我更喜欢这个)或GhostDoc.

您也可以在视图中写下正常评论以获取解释.

@* This is a comment *@
点赞