c# - 如何让从 c# 生成的 xml 文档按字母顺序显示？

Question

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

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

有没有办法让它们按字母顺序显示？

Answer 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>

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