Swashbuckle 5.4.0. NET MVC WebApi -在swagger网页中没有显示任何文档

本文关键字：网页 显示 文档 任何 swagger NET MVC WebApi Swashbuckle | 更新日期: 2023-09-27 18:13:50

我目前正试图在我的ASP中使用Swashbuckle 5.4.0。NET MVC Web API应用程序。每当我转到swagger生成的页面(通过rooturl/swagger)时，页面都被正确加载，但没有显示任何方法。将我的项目与另一个正确工作的项目进行比较，我可以找到代码中的任何差异。我错过了什么?

这是与问题相关的。cs文件:

SwaggerConfig.cs: 

namespace WebApiExperiment
{
    public class SwaggerConfig
    {
        public static void Register()
        {
            var thisAssembly = typeof(SwaggerConfig).Assembly;
            GlobalConfiguration.Configuration.EnableSwagger(c =>
            {
                c.SingleApiVersion("v1", "Swagger Demo Api");
                c.IncludeXmlComments(string.Format(@"{0}'bin'WebApiExperiment.XML",
                                     System.AppDomain.CurrentDomain.BaseDirectory));
            })
                    .EnableSwaggerUi();
        }

    }
}

Startup.cs 

[assembly: OwinStartupAttribute(typeof(WebApiExperiment.Startup))]
namespace WebApiExperiment
{
    public partial class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            ConfigureAuth(app);
        }
    }
}

Global.asax 

namespace WebApiExperiment
{
    public class MvcApplication : System.Web.HttpApplication
    {
        protected void Application_Start()
        {
            GlobalConfiguration.Configure(WebApiConfig.Register);
            AreaRegistration.RegisterAllAreas();
            FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
            RouteConfig.RegisterRoutes(RouteTable.Routes);
            BundleConfig.RegisterBundles(BundleTable.Bundles);
        }
    }
}

HomeController.cs(我的项目中最简单和最愚蠢的控制器)

namespace WebApiExperiment.Controllers
{
    public class HomeController : ApiController
    {

        public IHttpActionResult Index(SendCodeViewModel sendView)
        {
            return Ok();
        }
        public IHttpActionResult About(SendCodeViewModel sendView)
        {
            return Ok("Your application description page.");
        }
        public IHttpActionResult Contact(SendCodeViewModel sendView)
        {

            return Ok("Your contact page.");
        }
    }
}

任何文件，只要让我知道，我会提供给你。

Swashbuckle 5.4.0. NET MVC WebApi -在swagger网页中没有显示任何文档

简短的回答:路由很重要。在不了解API中的路由的情况下，swagger如何生成文档?

试试这个:

namespace WebApiExperiment.Controllers
{
    [RoutePrefix("api/routingMatters")]
    public class HomeController : ApiController
    {
        [Route("magic")]
        public IHttpActionResult Index(SendCodeViewModel sendView)
        {
            return Ok();
        }
        [Route("magic2")]
        public IHttpActionResult About(SendCodeViewModel sendView)
        {
            return Ok("Your application description page.");
        }
        [Route("magic3")]
        public IHttpActionResult Contact(SendCodeViewModel sendView)
        {
            return Ok("Your contact page.");
        }
    }
}

相关文章：