[ASP.NET Core] 建立 Web API 專案

開發 .NET Core 程式之前,第一次記得先到官網安裝 .NET Core SDK,

https://www.microsoft.com/net/core#windowscmd

如果已經安裝 .NET Core SDK,就能使用 ,dotnet 指令,

指令的部分都用命令提示字元( Windows + R,輸入 cmd 按下 Enter)來操作,

不用 IDE 的話,就得使用 Command Line 來操作。


如何知道有哪些內建 Template 可以快速建立專案?
dotnet new --help
Template Instantiation Commands for .NET Core CLI.

Usage: dotnet new [arguments] [options]

Arguments:
  template  The template to instantiate.

Options:
  -l|--list         List templates containing the specified name.
  -lang|--language  Specifies the language of the template to create
  -n|--name         The name for the output being created. If no name is specified, the name of the current directory is used.
  -o|--output       Location to place the generated output.
  -h|--help         Displays help for this command.
  -all|--show-all   Shows all templates


Templates                 Short Name      Language      Tags
----------------------------------------------------------------------
Console Application       console         [C#], F#      Common/Console
Class library             classlib        [C#], F#      Common/Library
Unit Test Project         mstest          [C#], F#      Test/MSTest
xUnit Test Project        xunit           [C#], F#      Test/xUnit
ASP.NET Core Empty        web             [C#]          Web/Empty
ASP.NET Core Web App      mvc             [C#], F#      Web/MVC
ASP.NET Core Web API      webapi          [C#]          Web/WebAPI
Solution File             sln                           Solution

Examples:
    dotnet new mvc --auth None --framework netcoreapp1.1
    dotnet new mvc --framework netcoreapp1.1
    dotnet new --help

 

建立 WebAPI 專案
dotnet new webapi

專案預設會參考一些套件,所以常常看到建立 Template專案後需要還原套件

dotnet restore

接著執行 ASP.NET Core WebAPI 專案

dotnet run

 看到以下結果預設就能用瀏覽器瀏覽 http://localhost:5000

Hosting environment: Production
Content root path: D:\Examples\mywebapi
Now listening on: http://localhost:5000
Application started. Press Ctrl+C to shut down.

因為我們是建立 webapi 專案,所以沒有預設的網頁內容,但有預設的 webapi,瀏覽器輸入

http://localhost:5000/api/values

如果順利的話,你可以看到這種 json 的字串,表示 webapi 正常

["value1","value2"]

 

進一步瞭解 dotnet 指令

每個指令微軟都有提供文件說明,現在也有繁體中文可閱讀,例如 dotnet run

https://docs.microsoft.com/zh-tw/dotnet/articles/core/tools/dotnet-run