使用 Swashbuckle 显示属于自定义类型的模型属性的描述

Question

我有这个模型：

public class Order {

  /// <summary>
  /// The customer.
  /// </summary>
  public Customer Customer { get; set; }

}

public class Customer {

  /// <summary>
  /// This is not shown.                 <---
  /// </summary>
  public int Id { get; set; }

  /// <summary>
  /// This is not shown.                 <---
  /// </summary>
  public string Name { get; set; }

}

Customer类在单独的程序集中定义。

swagger ui 不显示Customer模型的Id和Name属性的描述。

我尝试了这些选项，但没有帮助：

options.UseAllOfToExtendReferenceSchemas();
options.UseAllOfForInheritance();

我怎样才能解决这个问题？

Answer 1

必须包含所有 XML 文件，而不仅仅是条目程序集的 XML 文件。

var dir = AppContext.BaseDirectory;
var paths = Directory.GetFiles(dir, "*.xml", SearchOption.TopDirectoryOnly);
foreach (var path in paths) o.IncludeXmlComments(path);