기본 동작은 다음과 같습니다.
매개 변수가있는 경우 기본 유형 ( int, bool, double, ...), 웹 API의 시도는의 값 얻을 URI 는 HTTP 요청을.
들어 복잡한 유형 (예를 들어 자신의 개체, : Person), 웹 API의 시도는의 값 읽어 몸 HTTP 요청의를.
따라서 다음이있는 경우 :
... 당신은 어떤 속성 (도 추가 할 필요가 없습니다 [FromBody]아니다 [FromUri]).
당신이있는 경우에, 원시 형 의 몸을 , 당신은 추가 할 필요가 [FromBody]당신의 WebAPI 컨트롤러 방법에 원시 형식 매개 변수 앞에. (기본적으로 WebAPI는 HTTP 요청의 URI에서 기본 유형을 찾고 있기 때문입니다.)
또는 URI에 복잡한 유형 이 있으면을 추가해야합니다 . (기본적으로 WebAPI는 기본적으로 HTTP 요청 본문에서 복잡한 유형을 찾습니다.)[FromUri]
기본 유형 :
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;
}
ASP.NET 웹 API의 매개 변수 바인딩에 대한 Microsoft 문서 에서 :
매개 변수에 [FromBody]가 있으면 Web 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) { ... }
이 규칙의 이유는 요청 본문이 한 번만 읽을 수있는 버퍼되지 않은 스트림에 저장 될 수 있기 때문입니다.