誰かがCreatedAtRoute（）を私に説明できますか？

Web API 2のテンプレートから、postメソッドは常に次のようになります。

[ResponseType(typeof(MyDTO))]
public IHttpActionResult PostmyObject(MyDTO myObject)
{
    ...
    return CreatedAtRoute("DefaultApi", new { id = myObject.Id }, myObject);
}

私はこのCreatedAtRoute()方法を理解していません。誰かCreatedAtRoute()が私に方法を説明できますか？

の CreatedAtRouteメソッドは、POSTメソッドを呼び出して新しいオブジェクトを格納するときに、新しく作成されたリソースにURIを返すことを目的としています。たとえば、注文アイテムをPOSTすると、「api / order / 11」のようなルートが返される可能性があります（11は注文のIDです）。

ところで、MSDNの記事がこれを理解する上で役に立たないことに同意します。実際に戻るルートは、ルーティングの設定によって異なります。

CreatedAtRouteを使用する場合、最初の引数はリソースへのGetのメソッド名です。それほど明白ではないトリックは、正しいメソッド名が指定されていても、機能するためにはHttpGet属性でNameパラメーターを使用する必要があるということです。

だからあなたの投稿のリターンがこれなら：

return CreatedAtRoute("Get", new { newModel.Id}, newModel);

メソッドがGetという名前であっても、Getメソッド属性は次のようになります。

[HttpGet("{id}", Name = "Get")]

Postメソッドを呼び出すと、新しいオブジェクト（通常はJSONとして）が返されるだけでなく、そのリソースを取得するURIへの応答にLocationヘッダーが設定されます。

.netコアWebAPIでは、このメソッドを使用して201コードを返します。これは、オブジェクトが作成されたことを意味します。

[Microsoft.AspNetCore.Mvc.NonAction]
public virtual Microsoft.AspNetCore.Mvc.CreatedAtRouteResult CreatedAtRoute (string routeName, object routeValues, object content);

上記のように、CreatedAtRouteは3つのパラメーターを受け取ることができます。

routeName は、作成後にリソースを取得するURIになるメソッドに付ける必要がある名前です。

routeValues 名前付きルートでGETメソッドに渡される値を含むオブジェクトです。作成されたオブジェクトを返すために使用されます

content 作成されたオブジェクトです。

上記の例は、結合された名前を持つ単純なGETメソッドと、新しいオブジェクトを作成するPOSTメソッドを使用した、単純なコントローラーの2つのメソッドの実装を示しています。

namespace BastterAPI.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class CompanyController : Controller
    {
        private ICompanyRepository _companyRepository;

        public CompanyController(ICompanyRepository companyRepository)
        {
            _companyRepository = companyRepository;
        }

        [HttpGet("{id}", Name="GetCompany")]
        public IActionResult GetById(int id)
        {
            Company company = _companyRepository.Find(id);

            if (company == null)
            {
                return NotFound();
            }

            return new ObjectResult(company);

        }

        [HttpPost]
        public IActionResult Create([FromBody] Company company)
        {

            if (company == null)
            {
                return BadRequest();
            }

            _companyRepository.Add(company);

            return CreatedAtRoute("GetCompany", new Company { CompanyID = company.CompanyID }, company);

        }


    }
}

重要

1. CreatedAtRoute（routeName）の最初のパラメーターは、GetメソッドでのNameの定義と同じでなければならないことに注意してください。

2. 2番目のパラメーターのオブジェクトには、Getメソッドでリソースを取得するために使用する必要なフィールドが必要です。これは、それ自体が作成されたオブジェクトのサブセットであると言えます

3. 最後のパラメーターは、本文リクエストで受信された会社オブジェクトで、完全な形式です。

最終

最終的に、新しいAPIを作成するための投稿がこのAPIに対して行われると、新しく作成されたリソースに戻る「api / company / {id}」のようなルートが返されます