【问题标题】:How do I get the xml documentation generated from c# to appear in alphabetical order?如何让 c# 生成的 xml 文档按字母顺序显示?
【发布时间】:2015-07-11 16:37:58
【问题描述】:

我正在使用 Microsoft Web API 控制器类 (v2.1) 编写 Web 服务,并在每个类和方法的开头使用 XML 来自动生成文档。生成的文档有一个主页,其中列出了每个类和方法以及一个查看更多详细信息的链接。

不幸的是,这个主页(或索引)页面显示的课程在我看来是随机顺序,因此很难找到您想要的课程。

有没有办法让它们按字母顺序出现?

【问题讨论】:

    标签: c# asp.net documentation asp.net-web-api asp.net-web-api-helppages


    【解决方案1】:

    Areas\HelpPage\Views\Help 文件夹中有一个名为 index.cshtml 的文件,它是生成帮助文档的模板。它包含以下生成主页的代码:

    <section class="content-wrapper main-content clear-fix">
        @foreach (var group in apiGroups) {
            @Html.DisplayFor(m => group, "ApiGroup")
        }
    </section>
    

    可以通过在@foreach 之前插入一行并在@foreach 行中进行一项更改来按字母顺序放置类,如下所示:

    <section class="content-wrapper main-content clear-fix">
        @{var orderedGroups = (from g in apiGroups orderby g.Key.ControllerName select g).ToArray();}
        @foreach (var group in orderedGroups) {
            @Html.DisplayFor(m => group, "ApiGroup")
        }
    </section>
    

    新行只是在生成主页之前对类进行排序。

    【讨论】:

    • 你为什么这么快回答自己的问题?你问这个问题是为了拿奖牌吗?
    • 我查看了 StackOverflow 帮助,找到了在没有问题时如何发布信息,我从 stackoverflow.com/help/self-answer 了解到,批准的方式是发布问题并自己回答。当您发布问题时,您甚至可以单击一个复选框来表示您想回答自己的问题。
    • 好吧酷不知道。只是好奇我没看过很多。
    猜你喜欢
    • 1970-01-01
    • 2022-01-06
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2019-12-16
    • 1970-01-01
    相关资源
    最近更新 更多