Perilaku default adalah:
Jika parameter adalah primitif jenis ( int, bool, double, ...), Web API mencoba untuk mendapatkan nilai dari URI permintaan HTTP.
Untuk tipe kompleks (objek Anda sendiri, misalnya Person:), Web API mencoba membaca nilai dari badan permintaan HTTP.
Jadi, jika Anda memiliki:
- tipe primitif di URI, atau
- tipe kompleks dalam tubuh
... maka Anda tidak perlu menambahkan atribut apa pun (tidak [FromBody]juga [FromUri]).
Tetapi, jika Anda memiliki tipe primitif di tubuh , maka Anda harus menambahkan [FromBody]di depan parameter tipe primitif Anda dalam metode pengontrol WebAPI Anda. (Karena, secara default, WebAPI mencari tipe primitif di URI dari permintaan HTTP.)
Atau, jika Anda memiliki tipe kompleks di URI Anda , maka Anda harus menambahkan [FromUri]. (Karena, secara default, WebAPI mencari tipe kompleks di tubuh permintaan HTTP secara default.)
Tipe primitif:
public class UsersController : ApiController
{
// api/users
public HttpResponseMessage Post([FromBody]int id)
{
}
// api/users/id
public HttpResponseMessage Post(int id)
{
}
}
Jenis kompleks:
public class UsersController : ApiController
{
// api/users
public HttpResponseMessage Post(User user)
{
}
// api/users/user
public HttpResponseMessage Post([FromUri]User user)
{
}
}
Ini berfungsi selama Anda hanya mengirim satu parameter dalam permintaan HTTP Anda. Saat mengirim beberapa , Anda perlu membuat model khusus yang memiliki semua parameter Anda seperti ini:
public class MyModel
{
public string MyProperty { get; set; }
public string MyProperty2 { get; set; }
}
[Route("search")]
[HttpPost]
public async Task<dynamic> Search([FromBody] MyModel model)
{
// model.MyProperty;
// model.MyProperty2;
}
Dari dokumentasi Microsoft untuk pengikatan parameter di ASP.NET Web API :
Ketika parameter memiliki [FromBody], Web API menggunakan header Tipe-Konten untuk memilih formatter. Dalam contoh ini, tipe konten adalah "application / json" dan tubuh permintaan adalah string JSON mentah (bukan objek JSON). Paling banyak satu parameter diizinkan untuk membaca dari badan pesan.
Ini seharusnya bekerja:
public HttpResponseMessage Post([FromBody] string name) { ... }
Ini tidak akan berfungsi:
// Caution: This won't work!
public HttpResponseMessage Post([FromBody] int id, [FromBody] string name) { ... }
Alasan aturan ini adalah bahwa badan permintaan mungkin disimpan dalam aliran non-buffered yang hanya dapat dibaca sekali.