将XmlDoc集成到Web Api项目中的文档似乎只处理所有API类型都属于WebApi项目的情况.特别是,它讨论了如何将XML文档重新路由到App_Data/XmlDocument.xml
取消注释配置中将使用该文件的行.这隐含地只允许一个项目的文档文件.
但是,在我的设置中,我在一个常见的"模型"项目中定义了我的请求和响应类型.这意味着如果我有一个端点,例如:
[Route("auth/openid/login")]
public async Task<AuthenticationResponse> Login(OpenIdLoginRequest request) { ... }
Run Code Online (Sandbox Code Playgroud)
在OpenIdLoginRequest
单独的C#项目中定义的位置如下:
public class OpenIdLoginRequest
{
/// <summary>
/// Represents the OpenId provider that authenticated the user. (i.e. Facebook, Google, etc.)
/// </summary>
[Required]
public string Provider { get; set; }
...
}
Run Code Online (Sandbox Code Playgroud)
尽管有XML文档,但request
在查看特定于端点的帮助页面(即http://localhost/Help/Api/POST-auth-openid-login
)时,参数的属性不包含任何文档.
如何在Web API XML文档中显示具有XML文档的子项目中的类型?