ASP.NET Core 中的 CRUD 動作

我們的披薩服務支援 CRUD 作業，以取得披薩清單。這些作業透過 HTTP 指令動詞執行，而這些指令動詞透過 ASP.NET Core 屬性來對應。如您所見，HTTP GET 指令動詞用來從服務中擷取一或多個項目。此類動作會以 [HttpGet] 屬性標註。

下表顯示您針對披薩服務實作的四項作業對應：

您已經了解 GET 動作的運作方式。深入了解 POST、PUT 和 DELETE 動作。

POST

若要讓使用者能將新項目新增至端點，您必須使用 POST 屬性實作 [HttpPost] 動作。將項目 (在此範例中是披薩) 傳入方法當作參數時，ASP.NET Core 會自動將傳送到端點的應用程式/JSON，轉換為填入的 .NET Pizza 物件。

以下是 Create 方法的方法特徵標記，您將在下一節中實作此方法：

[HttpPost]
public IActionResult Create(Pizza pizza)
{            
    // This code will save the pizza and return a result
}

[HttpPost] 屬性會使用 POST 方法，對應傳送到 http://localhost:5000/pizza 的 HTTP Create() 要求。此方法傳回 Get() 回應，不像 IActionResult 方法傳回披薩清單。

IActionResult 會讓用戶端知道要求是否成功，並提供新建立披薩的 ID。 IActionResult 會使用標準 HTTP 狀態碼，因此不論其語言或使用的平台為何，都可以輕鬆地與用戶端整合。

ASP.NET Core 動作結果	HTTP 狀態碼	描述
`CreatedAtAction`	201	披薩已新增至記憶體內部快取。披薩包含在媒體類型的回應本文中，如 `accept` HTTP 要求標頭 (預設為 JSON) 中所定義。
意指 `BadRequest`	400	要求本文的 `pizza` 物件無效。

幸運的是，ControllerBase 有公用程式方法，可為您建立適當的 HTTP 回應碼和訊息。您將在下一個練習中看到這些方法的運作方式。

修改或更新我們庫存中的披薩類似於您實作的 POST 方法，但會使用 [HttpPut] 屬性，並且取得除了需要更新的 id 物件以外的 Pizza 參數：

[HttpPut("{id}")]
public IActionResult Update(int id, Pizza pizza)
{
    // This code will update the pizza and return a result
}

每個用於上述動作的 ActionResult 執行個體，都會對應至下表中的相應 HTTP 狀態碼：

其中一個較簡單要實作的動作是 DELETE 動作，只接受披薩的 id 參數，以便從記憶體內部快取中移除：

[HttpDelete("{id}")]
public IActionResult Delete(int id)
{
    // This code will delete the pizza and return a result
}

每個用於上述動作的 ActionResult 執行個體，都會對應至下表中的相應 HTTP 狀態碼：

ASP.NET Core 動作結果	HTTP 狀態碼	描述
`NoContent`	204	已從記憶體內部快取中刪除披薩。
`NotFound`	404	符合所提供 `id` 參數的披薩，不在記憶體內部快取中。

下一個單元的練習會示範如何在 Web API 中支援這四個動作的每一個。

此頁面對您有幫助嗎？