[ASP.NET Core] Getting Started

前言

本篇文章介紹如何快速建立一個ASP.NET Core應用程式，為自己留個紀錄也希望能幫助到有需要的開發人員。

• ASP.NET Core官網

環境

建立一個ASP.NET Core應用程式，首先要從官網下載SDK來建置.NET Core開發環境。

• .NET Core官網

  

• 依照操作系統下載.NET Core SDK。

  

  

• 安裝.NET Core SDK

  

• .NET Core SDK安裝完畢後，開啟命令提示字元。輸入「dotnet」，系統正常響應.NET Core的相關訊息，即完成.NET Core開發環境的建置。

  

開發

• 完成開發環境的建置後，就可以動手撰寫ASP.NET Core應用程式。首先建立一個新的文件夾：「lab」。

  

• 接著在lab文件夾里，加入一個檔案：「project.json」。並且修改檔案內容為下列json格式內容，用以設定ASP.NET Core應用程式的項目參數。

  

  {
    "version": "1.0.0-*",
    "buildOptions": {
      "debugType": "portable",
      "emitEntryPoint": true
    },
    "dependencies": {},
    "frameworks": {
      "netcoreapp1.0": {
        "dependencies": {
          "Microsoft.NETCore.App": {
            "type": "platform",
            "version": "1.0.0"
          },
          "Microsoft.AspNetCore.Server.Kestrel": "1.0.0"
        },
        "imports": "dnxcore50"
      }
    }
  }
  

• 接著同樣在lab文件夾里，加入一個檔案：「Program.cs」。並且修改檔案內容為下列C#程式代碼內容，用以做為ASP.NET Core應用程式的範常式序。

  

  using System;
  using System.Threading.Tasks;
  using Microsoft.AspNetCore.Http;
  using Microsoft.AspNetCore.Hosting;
  using Microsoft.AspNetCore.Builder;
  
  namespace aspnetcoreapp
  {
      public class Program
      {
          public static void Main(string[] args)
          {
              // Build
              var host = new WebHostBuilder()
  
                  // 設定啟動參數
                  .UseStartup<Startup>()
  
                  // 開啟Kestrel聆聽HTTP            
                  .UseKestrel()
  
                  // 設定聆聽的URL
                  .UseUrls("http://localhost:5000")
  
                  // 建立Host       
                  .Build();
  
              // Run 
              try
              {
                  // 啟動Host
                  host.Start();
  
                  // 等待關閉
                  Console.WriteLine("Application started. Press any key to shut down.");
                  Console.ReadKey();
              }
              finally
              {
                  // 關閉Host
                  host.Dispose();
              }
          }
      }
  
      public class Startup
      {
          // Methods
          public void Configure(IApplicationBuilder app)
          {
              // 掛載自定義的Middleware
              app.UseMiddleware<HelloWorldMiddleware>();
          }
      }
  
      public class HelloWorldMiddleware
      {
          // Fields
          private readonly RequestDelegate _next;
  
          // Constructors
          public HelloWorldMiddleware(RequestDelegate next)
          {
              _next = next;
          }
  
          // Methods
          public Task Invoke(HttpContext context)
          {
              return context.Response.WriteAsync("Hello World!");
          }
      }
  }
  

• 再來開啟命令提示字元，進入到上述的lab文件夾後。輸入「dotnet restore」，用以初始化ASP.NET Core應用程式。

  

• 初始化ASP.NET Core應用程式後，接著輸入「dotnet run」，用以編譯並執行ASP.NET Core應用程式。

  

執行

• 開發工作進行完畢之後，開發人員就可以開啟瀏覽器，輸入URL：「http://localhost:5000」，就可以在瀏覽器上，看到應用程式回傳的"Hello World!"。

  

參考

• ASP.NET Core Getting Started - ASP.NET

• ASP.NET Core 1.0 Hello World - 小朱® 的技術隨手寫

• ASP.NET Core 的 Middleware - ASP.NET Core 信息分享