使用NSwag和C＃對控制器名稱或標簽進行排序

Question

我有一個要使用Swagger的ASP.Net Core解決方案。 為此，我使用了Nuget軟件包NSwag（Assembly NSwag.AspNetCore，版本= 11.20.1.0）。 在我的應用程序配置中，我具有以下內容：

public void Configure(IApplicationBuilder app) {
    app..UseSwaggerUi3WithApiExplorer(settings =>
        {
            settings.GeneratorSettings.DefaultPropertyNameHandling = PropertyNameHandling.CamelCase;
            settings.PostProcess = document =>
            {
                document.Info.Version = $"v{typeof(Startup).Assembly.GetName().Version.Major}";
                document.Info.Title = "Test Api";
                document.Info.Description = "Sample API";
                document.Info.TermsOfService = "None";
                document.Info.Contact = new NSwag.SwaggerContact
                {
                    Name = "Person",
                    Email = "Email"
                };
            };
        });
}

運行此命令時，我可以正確看到所有控制器和相應的方法，但未按字母順序對其進行排序。

我已經嘗試了以下方法：

• 將TagSorter添加到設置：

   app.UseSwaggerUi3WithApiExplorer(settings => { ... settings.TagSorter = "alpha"; ... }); 

• 將ApisSorter添加到設置：

   app.UseSwaggerUi3WithApiExplorer(settings => { ... settings.ApisSorter = "alpha"; ... }); 

但是這些更改導致相同的輸出。 如何實現分類？

Answer 1

我遇到過同樣的問題。 但是在升級NSwag.AspNetCore-> 12.0.8（撰寫本文時為最新版本）並替換了現在已經Obsolete的方法之后，它可以使用

s.TagsSorter = "alpha";
s.OperationsSorter = "alpha";