Базовая служба AJAX

В примере SimpleAjaxService показано, как использовать Windows Communication Foundation (WCF) для создания базовой службы ASP.NET асинхронной службы JavaScript и XML (AJAX), к ней можно получить доступ с помощью кода JavaScript из клиента веб-браузера. Служба использует атрибут WebGetAttribute, чтобы обеспечить ответы службы на запросы HTTP GET и настройку на использование при ответах формата данных JSON.

Поддержка AJAX в WCF оптимизирована для использования с ASP.NET AJAX с помощью ScriptManager элемента управления. Пример использования WCF с ASP.NET AJAX см. в примерах AJAX.

Примечание.

Процедура настройки и инструкции по построению для данного образца приведены в конце этого раздела.

В следующем коде атрибут WebGetAttribute применяется к операции Add, чтобы гарантировать ответ службы на запросы HTTP GET. Код использует GET в целях упрощения (запрос HTTP GET можно создать в любом веб-браузере). GET также можно использовать для обеспечения кэширования. HTTP POST используется по умолчанию в случае отсутствия атрибута WebGetAttribute.

[ServiceContract(Namespace = "SimpleAjaxService")]
public interface ICalculator
{
    [WebGet]
    double Add(double n1, double n2);
    //Other operations omitted…
}

Образец SVC-файла использует WebScriptServiceHostFactory, которая добавляет стандартную конечную точку WebScriptEndpoint к службе. Конечная точка настраивается с пустым адресом относительно SVC-файла. Это означает, что адрес службы не имеет http://localhost/ServiceModelSamples/service.svcдополнительных суффиксов, отличных от имени операции.

<%@ServiceHost language="C#" Debug="true" Service="Microsoft.Samples.SimpleAjaxService.CalculatorService" Factory="System.ServiceModel.Activation.WebScriptServiceHostFactory" %>

WebScriptEndpoint предварительно настраивается таким образом, чтобы служба была доступна с клиентской страницы ASP.NET AJAX. Следующий раздел в Web.config может использоваться для дополнительных изменений конфигурации конечной точки. Если дополнительных изменений не требуется, он может быть удален.

<system.serviceModel>
  <standardEndpoints>
    <webScriptEndpoint>
      <!-- Use this element to configure the endpoint -->
      <standardEndpoint name=""  />
    </webScriptEndpoint>
  </standardEndpoints>
</system.serviceModel>

WebScriptEndpoint задает формат данных по умолчанию для службы как JSON вместо XML. Чтобы вызвать службу, перейдите http://localhost/ServiceModelSamples/service.svc/Add?n1=100&n2=200 после завершения настройки и выполнения шагов сборки, показанных далее в этом разделе. Таки функциональные возможности тестирования обеспечиваются за счет запроса HTTP GET.

Клиентская веб-страница SimpleAjaxClientPage.aspx содержит код ASP.NET для вызова службы, когда пользователь нажимает одну из кнопок операций на странице. Элемент управления ScriptManager используется для создания прокси-сервера для службы, доступной через JavaScript.

<asp:ScriptManager ID="ScriptManager" runat="server">
    <Services>
        <asp:ServiceReference Path="service.svc" />
    </Services>
</asp:ScriptManager>

Создается локальный прокси-сервер, и вызываются операции с помощью следующего кода JavaScript.

// Code for extracting arguments n1 and n2 omitted…
// Instantiate a service proxy
var proxy = new SimpleAjaxService.ICalculator();
// Code for selecting operation omitted…
proxy.Add(parseFloat(n1), parseFloat(n2), onSuccess, onFail, null);

Если вызов процедуры завершен успешно, код вызывает обработчик onSuccess и в текстовом поле показывается результат операции.

function onSuccess(mathResult){
     document.getElementById("result").value = mathResult;
}