Поведение по умолчанию:
Если параметр является примитивным типом ( int, bool, double...), Web API пытается получить значение из URI запроса HTTP.
Для сложных типов (ваш собственный объект, например Person:) Web API пытается прочитать значение из тела HTTP-запроса.
Итак, если у вас есть:
- примитивный тип в URI, или
- сложный тип в организме
... тогда вам не нужно добавлять какие-либо атрибуты ( [FromBody]ни[FromUri] ).
Но если у вас есть примитивный тип в теле , то вы должны добавить[FromBody] перед параметром примитивного типа в методе контроллера WebAPI. (Поскольку по умолчанию WebAPI ищет типы примитивов в URI HTTP-запроса.)
Или, если у вас есть сложный тип в вашем URI , то вы должны добавить [FromUri]. (Поскольку по умолчанию WebAPI ищет сложные типы в теле HTTP-запроса по умолчанию.)
Примитивные типы:
public class UsersController : ApiController
{
// api/users
public HttpResponseMessage Post([FromBody]int id)
{
}
// api/users/id
public HttpResponseMessage Post(int id)
{
}
}
Сложные типы:
public class UsersController : ApiController
{
// api/users
public HttpResponseMessage Post(User user)
{
}
// api/users/user
public HttpResponseMessage Post([FromUri]User user)
{
}
}
Это работает до тех пор, пока вы отправляете только один параметр в своем HTTP-запросе. При отправке нескольких вам нужно создать собственную модель, которая имеет все ваши параметры, например:
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;
}
Из документации Microsoft по привязке параметров в ASP.NET Web API :
Если параметр имеет значение [FromBody], веб-API использует заголовок Content-Type для выбора средства форматирования. В этом примере тип содержимого - «application / json», а тело запроса - необработанная строка JSON (не объект JSON). Не более одного параметра разрешено читать из тела сообщения.
Это должно работать:
public HttpResponseMessage Post([FromBody] string name) { ... }
Это не будет работать:
// Caution: This won't work!
public HttpResponseMessage Post([FromBody] int id, [FromBody] string name) { ... }
Причина этого правила заключается в том, что тело запроса может храниться в небуферизованном потоке, который может быть прочитан только один раз.