Vorgehensweise: Verwenden der Konfiguration zum Hinzufügen eines ASP.NET AJAX-EndpunktsHow to: Use Configuration to Add an ASP.NET AJAX Endpoint

Windows Communication Foundation (WCF) können Sie einen Dienst zu erstellen, mit der einen ASP.NET AJAX-aktivierten Endpunkt verfügbar, die auf einer Client-Website von JavaScript aufgerufen werden kann.Windows Communication Foundation (WCF) allows you to create a service that makes an ASP.NET AJAX-enabled endpoint available that can be called from JavaScript on a client Web site. Zum Erstellen eines solchen Endpunkts können Sie eine Konfigurationsdatei verwenden, wie bei allen anderen Windows Communication Foundation (WCF)-Endpunkten oder verwenden Sie eine Methode, die keine Konfigurationselemente benötigt.To create such an endpoint, you can either use a configuration file, as with all other Windows Communication Foundation (WCF) endpoints, or use a method that does not require any configuration elements. In diesem Thema wird die Konfigurationsmethode veranschaulicht.This topic demonstrates the configuration approach.

Der Teil der Prozedur, die den Dienstendpunkt zu ASP.NET AJAX-aktivierten ermöglicht besteht in der Konfiguration des Endpunkts verwendet die WebHttpBinding und zum Hinzufügen der <EnableWebScript > Endpunktverhalten.The part of the procedure that enables the service endpoint to become ASP.NET AJAX-enabled consists of configuring the endpoint to use the WebHttpBinding and to add the <enableWebScript> endpoint behavior. Nach der Konfiguration des Endpunkts, sind die Schritte zum Implementieren und Hosten des Diensts von WCF-Dienst verwendeten ähnlich.After configuring the endpoint, the steps to implement and host the service are similar to those used by any WCF service. Ein Arbeitsbeispiel finden Sie unter der AJAX-Dienst mithilfe von HTTP-POST.For a working example, see the AJAX Service Using HTTP POST.

Weitere Informationen über das ASP.NET AJAX-Endpunkt zu konfigurieren, ohne Konfiguration finden Sie unter wie: Hinzufügen einer ASP.NET AJAX-Endpunkt ohne mithilfe der Konfiguration.For more information about how to configure an ASP.NET AJAX endpoint without using configuration, see How to: Add an ASP.NET AJAX Endpoint Without Using Configuration.

So erstellen Sie einen WCF-BasisdienstTo create a basic WCF service

  1. Definieren Sie einen grundlegenden WCF-Dienstvertrag mit einer Schnittstelle, die mit markierten der ServiceContractAttribute Attribut.Define a basic WCF service contract with an interface marked with the ServiceContractAttribute attribute. Markieren Sie jeden Vorgang mit OperationContractAttribute.Mark each operation with the OperationContractAttribute. Stellen Sie sicher, dass Sie die Namespace-Eigenschaft festlegen.Be sure to set the Namespace property.

    [ServiceContract(Namespace = "MyService")]  
    public interface ICalculator  
    {  
        [OperationContract]  
         // This operation returns the sum of d1 and d2.  
        double Add(double n1, double n2);  
    
        //Other operations omitted…  
    
    }  
    
  2. Implementieren Sie den ICalculator-Dienstvertrag mit CalculatorService.Implement the ICalculator service contract with a CalculatorService.

    public class CalculatorService : ICalculator  
    {  
        public double Add(double n1, double n2)  
        {  
            return n1 + n2;  
        }  
    
    //Other operations omitted…  
    
  3. Definieren Sie einen Namespace für die ICalculator- und die CalculatorService-Implementierung, indem Sie sie in einen Namespaceblock einschließen.Define a namespace for the ICalculator and CalculatorService implementations by wrapping them in a namespace block.

    Namespace Microsoft.Ajax.Samples  
    {  
        //Include the code for ICalculator and Caculator here.  
    }  
    

So erstellen Sie einen ASP.NET AJAX-Endpunkt für den DienstTo create an ASP.NET AJAX endpoint for the service

  1. Erstellen eine Verhaltenskonfiguration und geben Sie die <EnableWebScript > Verhalten für ASP.NET AJAX-aktivierte Endpunkte des Diensts.Create a behavior configuration and specify the <enableWebScript> behavior for ASP.NET AJAX-enabled endpoints of the service.

    <system.serviceModel>  
        <behaviors>  
            <endpointBehaviors>  
                <behavior name="AspNetAjaxBehavior">  
                    <enableWebScript />  
                </behavior>  
            </endpointBehaviors>  
        </behaviors>  
    </system.serviceModel>  
    
  2. Erstellen Sie einen Endpunkt für den Dienst, der WebHttpBinding und das ASP.NET AJAX-Verhalten verwendet, das im vorherigen Schritt definiert wurde.Create an endpoint for the service that uses the WebHttpBinding and the ASP.NET AJAX behavior defined in the previous step.

    <system.serviceModel>  
        <services>  
            <service name="Microsoft.Ajax.Samples.CalculatorService">  
                <endpoint address=""  
                    behaviorConfiguration="AspNetAjaxBehavior"   
                    binding="webHttpBinding"  
                    contract="Microsoft.Ajax.Samples.ICalculator" />  
            </service>  
        </services>  
    </system.serviceModel>   
    

So hosten Sie den Dienst in IISTo host the service in IIS

  1. Um den Dienst in IIS zu hosten, erstellen Sie in der Anwendung eine neue Datei mit dem Namen service und einer SVC-Erweiterung.To host the service in IIS, create a new file named service with a .svc extension in the application. Bearbeiten Sie diese Datei durch Hinzufügen der entsprechenden @ServiceHost Richtlinie Informationen für den Dienst.Edit this file by adding the appropriate @ServiceHost directive information for the service. Die Dienstdatei für das CalculatorService-Beispiel enthält z. B. folgende Informationen.For example, the content in the service file for the CalculatorService sample contains the following information.

    <%@ServiceHost   
    language=c#   
    Debug="true"   
    Service="Microsoft.Ajax.Samples.CalculatorService"  
    %>  
    
  2. Weitere Informationen zum hosting in IIS finden Sie unter wie: Hosten eines WCF-Diensts in IIS.For more information about hosting in IIS, see How to: Host a WCF Service in IIS.

So rufen Sie den Dienst aufTo call the service

  1. Der Endpunkt ist eine leere Adresse relativ zur SVC-Datei konfiguriert, damit der Dienst jetzt verfügbar ist und kann durch Senden von Anforderungen an service.svc/ aufgerufen werden<Vorgang > – z. B. service.svc/Add für die Add Vorgang.The endpoint is configured at an empty address relative to the .svc file, so the service is now available and can be invoked by sending requests to service.svc/<operation> - for example, service.svc/Add for the Add operation. Sie können ihn verwenden, indem Sie die Endpunkt-URL in die Scripts-Auflistung des ASP.NET AJAX Script Manager-Steuerelements eingeben.You can use it by entering the endpoint URL into the Scripts collection of the ASP.NET AJAX Script Manager control. Ein Beispiel finden Sie die AJAX-Dienst mithilfe von HTTP-POST.For an example, see the AJAX Service Using HTTP POST.

Siehe auchSee Also

Erstellen von WCF-Diensten für ASP.NET AJAXCreating WCF Services for ASP.NET AJAX
Vorgehensweise: Migrieren AJAX-aktivierter ASP.NET-Webdienste zu WCFHow to: Migrate AJAX-Enabled ASP.NET Web Services to WCF