[TOC] <br/><br/><br/> # <b style="color:#4F4F4F;">簡介說明</b> ``` 版本：Microsoft.AspNetCore.Builder 作用：dotnet core web應用構建模塊 ``` <br/> # <b style="color:#4F4F4F;">Microsoft.AspNetCore.Builder.IApplicationBuilder</b> <br/> # <span style="color:#619BE4">ApplicationServices</span> ***** 應用服務提供對象，頂級根容器 <br/> ### 返回類型 ``` Microsoft.Extensions.DependencyInjection.ServiceLookup.ServiceProviderEngineScope ``` <br/> ### 示例內容 <span style="color:red;">1. 生命周期</span>  <br/> # <span style="color:#619BE4">Map()</span> ***** 映射指定路由到指定中間件 <br/> # <span style="color:#619BE4">MapWhen()</span> ***** 接收兩個函數，當第一個委托成功執行接下來的中間件 <br/> ### 示例內容 <span style="color:red;">1. 舉例說明</span> ``` app.MapWhen(context => { Console.WriteLine(context.Request.Path.Value); return context.Request.Path.Value.StartsWith("/filterwhen"); }, builder => { builder.Run(async (context) => { await context.Response.WriteAsync("I am filterwhen!"); }); }); ``` <br/> # <span style="color:#619BE4">Run()</span> ***** 指定use不在執行接下來中間件 <br/> # <span style="color:#619BE4">Use()</span> ***** 將中間件委托添加到應用程序的請求管道 <br/> ### 示例內容 <span style="color:red;">1. 注冊中間件</span> ``` app.Use(async (context, next) => { await context.Response.WriteAsync("hello world"); }); app.Use(requestDelegate => { return async context => { await context.Response.WriteAsync("hello world2"); // await requestDelegate(context); }; }); ``` <br/> # <span style="color:#619BE4">UseMiddleware\<M>()</span> ***** 注冊中間件類 <br/> ### 示例內容 <span style="color:red;">1. 舉例說明</span> ``` using System.Threading.Tasks; using Microsoft.AspNetCore.Http; using SharpGun.Middlewares; namespace Microsoft.AspNetCore.Builder { public static class HelloMiddlewareExtensions { public static IApplicationBuilder UseHelloMiddleware(this IApplicationBuilder app) { return app.UseMiddleware<HelloMiddleware>(); } } } namespace SharpGun.Middlewares { public class HelloMiddleware { private RequestDelegate _next; public HelloMiddleware(RequestDelegate next) { _next = next; } public async Task InvokeAsync(HttpContext context) { await context.Response.WriteAsync("hello middleware"); await _next(context); } } } ``` <br/> # <span style="color:#619BE4">UseWhen()</span> ***** 按條件執行，與MapWhen不同的是，UseWhen執行完后切回主分支 <br/> # <span style="color:#619BE4">UseWelcomePage()</span> ***** 歡迎頁面 <br/> # <span style="color:#619BE4">UseRewriter()</span> ***** 使用重映射 <br/> # <span style="color:#619BE4">UseFileServer()</span> ***** 使用文件服務，將index.html設置為默認頁 <br/> # <span style="color:#619BE4">UseDefaultFiles()</span> ***** 使用默認頁 <br/> # <span style="color:#619BE4">[ove]-UseStaticFiles()</span> ***** 使用靜態頁 <br/> # <span style="color:#619BE4">[ove]-UseStaticFiles()</span> ***** 使用靜態頁 <br/> ### 參數說明 <b style="color:#808080;">requestPath:</b> * 類型：字符串 * 默認值：無 * 描述：請求靜態資源路徑 * 可選值：[ ] <br/> # <span style="color:#619BE4">[ove]-UseStaticFiles()</span> ***** 使用靜態頁 <br/> ### 參數說明 <b style="color:#808080;">StaticFileOptions:</b> * 類型：字符串 * 默認值：無 * 描述：靜態文件配置參數 * 可選值：[ ] <br/> # <span style="color:#619BE4">UseRouter()</span> ***** 使用指定路由對象 <br/> # <span style="color:#619BE4">UseRouting()</span> ***** 啟用路由中間件 <br/> # <span style="color:#619BE4">UseMvcWithDefaultRoute()</span> ***** 使用MVC默認映射路由 <br/> # <span style="color:#619BE4">UseEndpoints()</span> ***** 使用路由匹配處理 <br/> # <span style="color:#619BE4">UseHsts()</span> ***** 使用Hsts訪問安全通道 <br/> # <span style="color:#619BE4">UseExceptionHandler()</span> ***** 使用異常頁控制器 <br/> # <span style="color:#619BE4">UseDeveloperExceptionPage()</span> ***** 使用開發異常顯示頁 <br/> # <span style="color:#619BE4">UseSwagger()</span> ***** 使用Swagger開發文檔模板 <br/> # <span style="color:#619BE4">UseSwaggerUI()</span> ***** 使用Swagger開發文檔模板UI <br/> # <span style="color:#619BE4">UseHttpsRedirection()</span> ***** 使用https重定向 <br/> # <span style="color:#619BE4">UseStatusCodePages()</span> ***** 添加帶有默認響應處理程序的 StatusCodePages 中間件 <br/> # <b style="color:#4F4F4F;">Microsoft.AspNetCore.Builder.DefaultFilesOptions</b> <br/> # <span style="color:#619BE4">DefaultFileNames</span> ***** 默認情況下要選擇的文件名的有序列表，一個ICollection對象 <br/> # <b style="color:#4F4F4F;">Microsoft.AspNetCore.Builder.StaticFileOptions</b> <br/> # <span style="color:#619BE4">[new]-StaticFileOptions</span> ***** 靜態文件配置參數可選項 <br/>