Swashbuckle Swagger UI zeigt keine Parameter Beschreibung

Question

Paketversion 6.0.0-beta902

Beispiele:

public class TestModel 
{ 
    /// <summary> 
    /// This is description of Name 
    /// </summary> 
    public string Name { get; set; } 
} 

public IActionResult HelloWorld(TestModel model) 
{ 
    return Content("hello " + model.Name); 
} 

Warum Swagger UI nicht Parameter Name Beschreibung zeigen?

Answer 1

Dies wird häufig durch eine fehlende Konfiguration verursacht, stellen Sie sicher, dass Sie die IncludeXmlComments mit dem korrekten Pfad zu Ihrem XML-Dokument haben.

Hier ist ein Weg, um alle XML-Dokumente von der Konfiguration enthalten:

http://swashbuckletest.azurewebsites.net/swagger/ui/index?filter=TestEnum#/TestEnum/TestEnum_Put

Und der Code dahinter ist, auf:

public void ConfigureServices(IServiceCollection services) 
    { 
     // Add Swashbuckle 
     services.AddSwaggerGen(options => 
     { 
      options.DescribeAllEnumsAsStrings(); 
      options.SingleApiVersion(new Swashbuckle.Swagger.Model.Info() 
      { 
       Title = "My API", 
       Version = "v1", 
       Description = "My API", 
       TermsOfService = "Terms Of Service" 
      }); 

      //Set the comments path for the swagger json and ui. 
      var basePath = PlatformServices.Default.Application.ApplicationBasePath; 
      foreach (var name in Directory.GetFiles(basePath, "*.XML", SearchOption.AllDirectories)) 
      { 
       options.IncludeXmlComments(name); 
      } 
     }); 
     // Add framework services. 
     services.AddMvc(); 
    } 

Hier ist ein Beispiel richtig zeigt, GitHub:

https://github.com/heldersepu/SwashbuckleTest/blob/master/Swagger_Test/Models/ViewModelTest.cs