# ASP.NET Core 建立 web API
- Auto-generated Table of Content
[ToC]
###### tags: `.NET Core`
###### 參考資料:

> 前往 ➜ [教學課程：使用 ASP.NET Core 建立 web API](https://docs.microsoft.com/zh-tw/aspnet/core/tutorials/first-web-api?view=aspnetcore-3.1&tabs=visual-studio)
> 前往 ➜ [[.NETCore] 安裝 Entity Framework Core](https://marcus116.blogspot.com/2019/04/netcore-how-to-install-entity-framework-core.html)
> 前往 ➜ [實作 ASP.NET Core 建立 Web API 教學](https://ithelp.ithome.com.tw/articles/10235984)
> 前往 ➜ [Day09 實作官網 ASP.NET Core 教學(一)](https://ithelp.ithome.com.tw/articles/10234296)
> 前往 ➜ [.net core 5.0 IIS部屬注意](https://blog.csdn.net/gtosky4u/article/details/113886135)

## :memo: 介紹
### .NET Core

.NET是.NET Framework的新一代版本，是微軟開發的第一個跨平台 (Windows、Mac OSX、Linux）的應用程式開發框架（Application Framework），未來也將會支援FreeBSD與Alpine 平台。.Net Core也是微軟在一開始發展時就開源的軟體平台，它經常也會拿來和現有的開源 .NET 平台Mono比較。

由於 .NET Core 的開發目標是跨平台的 .NET 平台，因此 .NET Core 會包含 .NET Framework 的類別庫，但與 .NET Framework 不同的是 .NET Core 採用套件化 (Packages) 的管理方式，應用程式只需要取得需要的組件即可，與 .NET Framework 大包式安裝的作法截然不同，同時各套件亦有獨立的版本線 (Version line)，不再硬性要求應用程式跟隨主線版本。

.NET Core 專案的主要目標有：

* 支援或可以移轉 (port) 到更多的作業系統平台與晶片架構 (也就是未來計畫會跨出 x86 平台)。
* 具有引人注目的效能與高可靠度。
* 開發人員能快速與直覺的獲取 .NET Core 開發環境。
* 在直覺與具生產力的情況下建造應用程式，使用檔案，範例與 NuGet 元件。

## :memo: 建立專案
>Node 版本要求
>Vue CLI需要Node.js 8.9或更高版本(推薦8.11.0+)。
### Step 1: 使用以下指令進行安裝vue/cli

:::info
建立新的專案
->ASP.NET Core Web 應用程式
-><font color="#EA7500">輸入專案名稱</font>
->目標 Framework = <font color="#EA7500">.NET Core 5.0</font>

VS Code 建立

dotnet new webapi -o <font color="#EA7500">專案名稱</font>

:::

### Step 2: NuGET 套件安裝

:::info
* Microsoft.EntityFrameworkCore.SqlServer
* Microsoft.EntityFrameworkCore.InMemory
* Microsoft.VisualStudio.Web.CodeGeneration.Design
* Microsoft.EntityFrameworkCore.Design
* Swashbuckle.AspNetCore
* NetTopologySuite //Geometry型態
* NetTopologySuite.IO.GeoJSON //GeoJSON

VS Code 安裝方式
dotnet add package <font color="#EA7500">套件</font>
:::
### Step 3: 導入資料模型
**新增Models資料夾**
:::info
mkdir Models
:::

**導入資料模型指令**
:::info
Scaffold-DbContext "Server=<font color="#EA7500">domain</font>;Database=<font color="#EA7500">xxxxx</font>;Trusted_Connection=True;
User Id=<font color="#EA7500">帳號</font>;Password=<font color="#EA7500">密碼</font>;Integrated Security=false;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models

VS Code 指令:
dotnet ef dbcontext scaffold "Server=<font color="#EA7500">domain</font>;Database=<font color="#EA7500">xxxxx</font>;Trusted_Connection=True;
User Id=<font color="#EA7500">帳號</font>;Password=<font color="#EA7500">密碼</font>;Integrated Security=false;" Microsoft.EntityFrameworkCore.SqlServer -o Models
:::

### Step 4: 連接資料庫
**appsettings.json加入連線資訊**
:::info
"ConnectionStrings": {
"GeoUVP": "Data Source=<font color="#EA7500">domain</font>;Initial Catalog=GeoUVP;User ID=<font color="#EA7500">xxxx</font>;Password=<font color="#EA7500">xxxxx</font>;Connect Timeout=30;Encrypt=False;TrustServerCertificate=False;ApplicationIntent=ReadWrite;MultiSubnetFailover=False"
},
:::

**Startup.cs**
::: info
using <font color="#EA7500">專案名稱</font>.Models;
using Microsoft.EntityFrameworkCore;

public void ConfigureServices(IServiceCollection services)
        {
            services.AddDbContext<Step 3.產生的Context名稱>(opt =>
                opt.UseSqlServer(Configuration.GetConnectionString("appsettings.json的連線資訊名稱->GeoUVP")));
            services.AddControllers();
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new OpenApiInfo { Title = "PIFIssuanceAPI", Version = "v1" });
            });
            services.AddRazorPages();
        }

如果使用到空間資料庫，請改成下列方式

services.AddDbContext <PIFIssuanceContext> (opt =>
              opt.UseSqlServer(Configuration.GetConnectionString("PIFIssuance"),x => x.UseNetTopologySuite()));

:::
:::warning
空間欄位定義方式
Model

 public partial class ParcelIndex
    {
        public int QgsFid { get; set; }
        
        public Geometry geom { get; set; }
        public string 地段名 { get; set; }
        public string 段代碼 { get; set; }
        public string Maptype { get; set; }
        public string 製圖法 { get; set; }
    }

Context

 modelBuilder.Entity<ParcelIndex>(entity =>
            {
                

                entity.HasKey(e => e.QgsFid);

                entity.ToTable("ParcelIndex");
                entity.Property(e => e.geom).HasColumnType("geometry");

                entity.Property(e => e.QgsFid).HasColumnName("qgs_fid");

                entity.Property(e => e.Maptype).HasColumnName("maptype");
            });

:::

### Step 5: 產生Controllers
** **
:::info
使用 aspnet-codegenerator 產生 controller 程式
名稱: ArticlesController
表名稱: Article
Context名稱: ArticleContext

dotnet aspnet-codegenerator controller -name <font color="#EA7500">ArticlesController</font> -async -api -m <font color="#EA7500">Article</font> -dc <font color="#EA7500">ArticleContext</font> -outDir Controllers
:::