.NET|.NET CORE

.Net Core常用命令

dotnet --version //查看版本dotnet run //运行项目dotnet mytest.dll //运行生成后的dll

Swagger使用
  1. Nuget包管理,搜索:Swashbuckle.AspNetCore 安装即可
  2. 配置Swagger中间件
public void ConfigureServices(IServiceCollection services) { // 注册Swagger服务 services.AddSwaggerGen(c => { // 添加文档信息 c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "WP", Version = "v1" }); // 使用反射获取xml文件。并构造出文件的路径 var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml"; var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile); // 启用xml注释. 该方法第二个参数启用控制器的注释,默认为false. c.IncludeXmlComments(xmlPath, true); }); services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); }

  1. 在 Startup类Configure 方法中,启用中间件为生成的 JSON 文档和 Swagger UI 提供服务
public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. app.UseHsts(); }app.UseHttpsRedirection(); // 启用Swagger中间件 app.UseSwagger(); // 配置SwaggerUI app.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json", "CoreWebApi"); c.RoutePrefix = string.Empty; }); app.UseMvc(); }

  1. 右键项目属性,将URL地址固定到某个端口

    .NET|.NET CORE
    文章图片
    image.png
  2. 右键当前项目——编辑****.csproj 的文件 在PropertyGroup标签组中添加如下两条
true $(NoWarn); 1591

【.NET|.NET CORE】说明:这两句的大概意思就是启用XML注释,并忽略未写注释的警告。不添加1591如果某个方法未写 "///"各式的注释,vs会有警示的消息。

    推荐阅读