डिफ़ॉल्ट व्यवहार है:
पैरामीटर है आदिम प्रकार ( int, bool, double, ...), वेब एपीआई की कोशिश करता से मूल्य प्राप्त करने के यूआरआई HTTP अनुरोध की।
के लिए जटिल प्रकार (अपनी खुद की वस्तु, उदाहरण के लिए: Person), वेब एपीआई की कोशिश करता से मूल्य को पढ़ने के लिए शरीर HTTP अनुरोध की।
इसलिए, यदि आपके पास:
- URI में एक आदिम प्रकार, या
- शरीर में एक जटिल प्रकार
... तो आपको कोई विशेषता नहीं जोड़ना है (न [FromBody]ही [FromUri])।
लेकिन, यदि आपके पास शरीर में एक आदिम प्रकार है , तो आपको जोड़ना होगा[FromBody] अपने WebAP नियंत्रक विधि में अपने आदिम प्रकार के पैरामीटर के सामने । (क्योंकि, डिफ़ॉल्ट रूप से, WebAPI 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;
}
ASP.NET वेब API में पैरामीटर बाइंडिंग के लिए Microsoft के दस्तावेज़ से :
जब एक पैरामीटर में [FromBody] होता है, तो वेब एपीआई एक फ़ॉर्मेटर का चयन करने के लिए सामग्री-प्रकार हेडर का उपयोग करता है। इस उदाहरण में, सामग्री प्रकार "एप्लिकेशन / json" है और अनुरोध निकाय एक कच्चा JSON स्ट्रिंग है (JSON ऑब्जेक्ट नहीं)। अधिकतम एक पैरामीटर पर संदेश निकाय से पढ़ने की अनुमति है।
यह काम करना चाहिए:
public HttpResponseMessage Post([FromBody] string name) { ... }
यह काम नहीं करेगा:
// Caution: This won't work!
public HttpResponseMessage Post([FromBody] int id, [FromBody] string name) { ... }
इस नियम का कारण यह है कि अनुरोध निकाय को गैर-बफर स्ट्रीम में संग्रहीत किया जा सकता है जिसे केवल एक बार पढ़ा जा सकता है।