bg:.NET/C#真的是越來越涼了。用的是.net9,創建完自帶一個天氣預報api拿來測試就行
1、在Controllers中弄多幾個,并寫上注釋
/// <summary>
/// Post注釋
/// </summary>
/// <returns></returns>
[HttpPost]
public IEnumerable<WeatherForecast> Post()
{return Enumerable.Range(1, 5).Select(index => new WeatherForecast{Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),TemperatureC = Random.Shared.Next(-20, 55),Summary = Summaries[Random.Shared.Next(Summaries.Length)]}).ToArray();
}/// <summary>
/// Put注釋
/// </summary>
/// <returns></returns>
[HttpPut]
public IEnumerable<WeatherForecast> Put()
{return Enumerable.Range(1, 5).Select(index => new WeatherForecast{Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),TemperatureC = Random.Shared.Next(-20, 55),Summary = Summaries[Random.Shared.Next(Summaries.Length)]}).ToArray();
}
2、在屬性中,將文檔文件打上勾
3、配置swagger中加上
#region 配置swagger服務
{builder.Services.AddEndpointsApiExplorer();builder.Services.AddSwaggerGen(options =>{string basePath = AppContext.BaseDirectory;string xmlPath = Path.Combine(basePath, "MvcWeb.xml"); // 項目名稱.xmloptions.IncludeXmlComments(xmlPath); // 加上這個才會在swagger中增加注釋});
}
#endregion
運行效果:
源碼:https://github.com/zzp229/MvcWeb-.net9-1.git