Serviço básico do AJAX

O exemplo SimpleAjaxService demonstra como usar o WCF (Windows Communication Foundation) para criar um serviço básico ASP.NET JavaScript e XML (AJAX) assíncrono (um serviço que você pode acessar usando código JavaScript de um cliente do navegador da Web). O serviço usa o WebGetAttribute atributo para garantir que o serviço responda às solicitações HTTP GET e esteja configurado para usar o formato de dados JSON (JavaScript Object Notation) para respostas.

O suporte a AJAX no WCF é otimizado para uso com ASP.NET AJAX por meio do ScriptManager controle. Para obter um exemplo de como usar o WCF com ASP.NET AJAX, consulte os Exemplos do AJAX.

Observação

O procedimento de configuração e as instruções de build para este exemplo estão localizados no final deste tópico.

No código a seguir, o WebGetAttribute atributo é aplicado à Add operação para garantir que o serviço responda às solicitações HTTP GET. O código usa GET para simplificar (você pode construir uma solicitação HTTP GET de qualquer navegador da Web). Você também pode usar GET para habilitar o cache. HTTP POST é o padrão na ausência do WebGetAttribute atributo.

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

O arquivo .svc de exemplo usa WebScriptServiceHostFactory, o que adiciona um ponto de extremidade padrão WebScriptEndpoint ao serviço. O ponto de extremidade é configurado em um endereço vazio em relação ao arquivo .svc. Isso significa que o endereço do serviço é http://localhost/ServiceModelSamples/service.svc, sem sufixos adicionais além do nome da operação.

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

O WebScriptEndpoint está pré-configurado para tornar o serviço acessível a partir de uma página de cliente ASP.NET AJAX. A seção a seguir no Web.config pode ser utilizada para realizar alterações adicionais de configuração no endpoint. Ele poderá ser removido se nenhuma alteração adicional for necessária.

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

Define WebScriptEndpoint o formato de dados padrão para o serviço como JSON em vez de XML. Para invocar o serviço, navegue até http://localhost/ServiceModelSamples/service.svc/Add?n1=100&n2=200 depois de concluir as etapas de configuração e compilação mostradas posteriormente neste tópico. Essa funcionalidade de teste é habilitada pelo uso de uma solicitação HTTP GET.

A página da Web do cliente SimpleAjaxClientPage.aspx contém ASP.NET código para invocar o serviço sempre que o usuário clicar em um dos botões de operação na página. O controle ScriptManager é usado para tornar um proxy para o serviço acessível por meio do JavaScript.

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

O proxy local é instanciado e as operações são invocadas usando o código JavaScript a seguir.

// 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);

Se a chamada de serviço for bem-sucedida, o código invocará o onSuccess manipulador e o resultado da operação será exibido em uma caixa de texto.

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