Передача данных НТТР-запроса в метод-действие

В HTTP-запросах могут передаваться следующие данные, которые могут использоваться в методах-действиях:

• • значения полей HTML-формы (доступны с помощью Request. Form); как пояснялось ранее, значения полей при использовании HTTP-метода Get передаются в строке запроса URL, а при использовании HTTP-метода Get — в теле запроса;
• • значения периметров, переданных в сегментах маршрута (доступны с помощью свойства RouteData. Values);
• • значения параметров строки запроса, стоящей в конце URL (доступны с помощью свойства Request. QueryString) вида:
  • ? имя1>=&=&.,&=
• • загружаемые файлы (доступны с помощью свойства Request. Files).

Методы-действия могут получать данные запроса двумя способами:

• • с помощью свойств (коллекций) объекта Request (рассматривался в разделе 4.1.3), таких как Form, RouteData, Querystring и Files;
• • с помощью автоматического связывания переданных данных с формальными параметрами метода.

Автоматическое связывание параметров метода с данными НТТРзапроса выполняется на основе совпадения названия параметра метода и названий параметров запроса (с учетом регистра и типа данных). Например, предположим, что в проекте описан простой класс модели: public class RepeatText {.

public string Text { get; set;}.

public int Number { get; set;}.

}.

Тогда данные для создания объекта такого класса могут передаваться в виде двух параметров string text и int number:

public class BindingController: Controller {.

public ActionResult Repeat (string text, int number) {.

var model = new RepeatNext {Text = text, Number = number);

return View (model);

}}.

В этом случае, если запрос содержит поле формы, сегмент маршрута (route parameter) или параметр строки запроса с именем text, то он будет автоматически связываться с параметром string text. Связывание будет выполнено успешно, если тип параметра и действительное значение являются совместимыми (может выполниться преобразование между ними). Например: будет хорошо работать следующий URL: server.com/binding/repeat?text=Петр&number=2.

Следует также отметить, что при выполнении автоматического связывания поиск совпадения имен данных запроса выполняется в том порядке, в котором они были описаны в начале раздела.

На количество параметров в описании метода действия нет никаких ограничений. Но вместо длинного списка простых типов параметров лучше использовать объекты классов. Например, можно описать метод, который принимает в качестве входного параметра объект типа RepeatText:

public class ComplexController: Controller {.

public ActionResult NewRepeat (RepeatText inputModel) {.

return View (inputModel);

}>

В этом случае связывание входных данных со сложным объектом выполняется также, как и с простыми типами. Фреймвер создает нужный объект и для каждого его открытого свойства (public) ищет переданные значения, которые имеют такое же имя. URL, который был рассмотрен выше, также будет хорошо работать с методом NewRepeat.

В рассматриваемом примере мстод-дсйствис [HttpPost] public string Buy (Purchase purchase) получает в качестве параметра объект класса Purchase, который формируется в результате автоматического связывания данных, переданных из формы представления, показанного на рис. 4.42.

Возврат результата метода-действия

Действие может самостоятельно вернуть пользователю простые данные (целые значения или строки), например:

public string Answer () (.

return «Спасибо за покупку!» ;

>

Следует обратить внимание на то, что тип результата в данном примере изменен на string.

Чаще всего ожидается, что метод-действие возвращает объект типа ActionResult (или объект, производный от этого типа). Однако действие не само создает такой объект, а использует какой-нибудь вспомогательный метод. Например: для формирования HTML-документа используется метод View (), а для формирования описания объектов в формате JSON — метод Json ().

Кроме вызова вспомогательного метода для формирования HTMLдокумента можно с помощью метода RedirectToAction () отправить обработку запроса другому действию, например RedirectToActionflndex").