Das Standardverhalten ist:
Wenn die Parameter a primitive Art ( int, bool, double, ...), Web - API versucht , den Wert von der zu bekommen URI der HTTPAnforderung.
Bei komplexen Typen (z. B. Ihrem eigenen Objekt Person:) versucht die Web-API, den Wert aus dem zu lesen Hauptteil der HTTP-Anforderung.
Also, wenn Sie haben:
- ein primitiver Typ in der URI, oder
- ein komplexer Typ im Körper
... dann müssen Sie keine Attribute hinzufügen (auch nicht [FromBody] noch [FromUri]).
Aber wenn Sie einen primitiven Typ im Körper haben , müssen Sie ihn [FromBody]in Ihrer WebAPI-Controller-Methode vor Ihrem primitiven Typparameter hinzufügen . (Da WebAPI standardmäßig nach primitiven Typen im URI der HTTP-Anforderung sucht.)
Wenn Sie einen komplexen Typ in Ihrer URI haben , müssen Sie diesen hinzufügen[FromUri] . (Da WebAPI standardmäßig nach komplexen Typen im Hauptteil der HTTP-Anforderung sucht.)
Primitive Typen:
public class UsersController : ApiController
{
// api/users
public HttpResponseMessage Post([FromBody]int id)
{
}
// api/users/id
public HttpResponseMessage Post(int id)
{
}
}
Komplexe Typen:
public class UsersController : ApiController
{
// api/users
public HttpResponseMessage Post(User user)
{
}
// api/users/user
public HttpResponseMessage Post([FromUri]User user)
{
}
}
Dies funktioniert, solange Sie nur einen Parameter in Ihrer HTTP-Anfrage senden . Wenn Sie mehrere senden , müssen Sie ein benutzerdefiniertes Modell erstellen,das alle Ihre Parameter wie folgt enthält:
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;
}
Aus der Microsoft-Dokumentation zur Parameterbindung in der ASP.NET-Web-API :
Wenn ein Parameter [FromBody] hat, verwendet die Web-API den Content-Type-Header, um einen Formatierer auszuwählen. In diesem Beispiel lautet der Inhaltstyp "application / json" und der Anforderungshauptteil ist eine unformatierte JSON-Zeichenfolge (kein JSON-Objekt). Es darf höchstens ein Parameter aus dem Nachrichtentext lesen.
Das sollte funktionieren:
public HttpResponseMessage Post([FromBody] string name) { ... }
Dies wird nicht funktionieren:
// Caution: This won't work!
public HttpResponseMessage Post([FromBody] int id, [FromBody] string name) { ... }
Der Grund für diese Regel ist, dass der Anforderungshauptteil möglicherweise in einem nicht gepufferten Stream gespeichert ist, der nur einmal gelesen werden kann.