Freigeben über

Erstellen von WCF-Diensten für ASP.NET AJAX

Mit Microsoft ASP.NET AJAX können Sie schnell Webseiten erstellen, die eine umfassende Benutzeroberfläche mit reaktionsfähigen und vertrauten Benutzeroberflächenelementen enthalten. ASP.NET AJAX stellt Clientskriptbibliotheken bereit, die browserübergreifende ECMAScript -Technologien (JavaScript) und dynamische HTML (DHTML) enthalten und sie in die serverbasierte ASP.NET 2.0-Entwicklungsplattform integrieren. Mithilfe von ASP.NET AJAX können Sie die Benutzererfahrung und die Effizienz Ihrer Webanwendungen verbessern.

ASP.NET AJAX besteht aus Clientskriptbibliotheken und Serverkomponenten, die integriert sind, um ein robustes Entwicklungsframework bereitzustellen. Um von einer ASP.NET-Seite auf einen Dienst zuzugreifen: Sobald die Dienst-URL zum Steuerelement ASP.NET Script Manager auf der Seite hinzugefügt wurde, werden Dienstvorgänge möglicherweise mit JavaScript-Code aufgerufen, der genau wie ein regulärer JavaScript-Funktionsaufruf aussieht.

Die meisten Windows Communication Foundation (WCF)-Dienste können als Dienst verfügbar gemacht werden, der mit ASP.NET AJAX kompatibel ist, indem ein geeigneter ASP.NET AJAX-Endpunkt hinzugefügt wird.

Wenn Sie Visual Studio verwenden, können Sie eine vordefinierte Vorlage für AJAX-fähige WCF-Dienste verwenden, die im Dialogfeld " Neues Element hinzufügen " verfügbar sind, wenn Sie mit ASP.NET Websites oder Webanwendungen arbeiten.

Wenn Sie die Visual Studio-Vorlagen nicht verwenden, gibt es zwei Möglichkeiten zum Erstellen eines ASP.NET AJAX-Endpunkts:

Das webprogrammierungsmodell, das in der WCF Web HTTP Programming Model Overview beschrieben wird, kann mit ASP.NET AJAX-Diensten verwendet werden. Dies gilt insbesondere in folgenden Fällen:

  • Sie können die WebGetAttribute Attribute und WebInvokeAttribute Attribute verwenden, um zwischen HTTP GET- und HTTP POST-Verben auszuwählen. Wenn sie ordnungsgemäß verwendet wird, kann dies die Leistung Ihrer Anwendung erheblich verbessern. Weitere Informationen finden Sie unter So wählen Sie zwischen HTTP POST- und HTTP GET-Anfragen für ASP.NET AJAX-Endpunkte aus.

  • Sie können die ResponseFormat und ResponseFormat Eigenschaften verwenden, um zu bewirken, dass Ihr Dienst XML-Daten anstelle der standardmäßigen JavaScript Object Notation (JSON) zurückgibt. Dies mit dem ASP.NET AJAX-Framework bewirkt, dass der JavaScript-Client ein XML-DOM-Objekt empfängt.

    Warnung

    Ihr Vorgang muss den Inhaltstyp auf Text/XML festlegen, damit dies funktioniert. Andernfalls empfängt der JavaScript-Client eine Zeichenfolge, die den XML-Code anstelle eines XML-DOM-Objekts enthält.

    Nachfolgend sehen Sie ein Beispiel für einen Vorgang, der XML-Daten zurückgibt, für die der Inhaltstyp entsprechend festgelegt ist:

    [OperationContract, WebGet(ResponseFormat=WebMessageFormat.Xml)]
public XElement GetData()
{
    XElement x;
    //Get some data here...

    WebOperationContext.Current.OutgoingResponse.ContentType = "text/xml";
    return x;
}

  • Wenn die Kompatibilität mit ASP.NET AJAX erforderlich ist, können keine anderen Eigenschaften der WebGetAttribute- und WebInvokeAttribute-Attribute geändert werden. Andere Aspekte des Webprogrammierungsmodells können verwendet werden, solange die ASP.NET AJAX-Aufrufkonventionen nicht verletzt werden.

Komplexere Szenarien erfordern ein besseres Verständnis der Einzelheiten zur AJAX-Unterstützung in WCF.

  • Um zu verstehen, wie Daten zwischen einem AJAX-Seitenclient und einem WCF-Dienst mit JavaScript übertragen werden, und ausführliche Informationen dazu, wie .NET Framework-Typen JavaScript-Typen zuordnen, finden Sie unter Support für JSON und andere Datenübertragungsformate.

  • Um ASP.NET Features zu nutzen, z. B. URL-basierte Authentifizierung und Zugriff auf die ASP.NET Sitzungsinformationen, sollten Sie den ASP.NET Kompatibilitätsmodus über die Konfiguration aktivieren.

AJAX-Endpunkte in WCF können sogar ohne das ASP.NET AJAX-Framework verwendet werden. Dies erfordert ein Verständnis der Unterstützungsarchitektur der AJAX-Unterstützung in WCF. Eine Erläuterung dieser Architektur finden Sie unter WCF Web HTTP Programming Object Model. Ein Codebeispiel, das diesen Ansatz veranschaulicht, finden Sie im AJAX-Dienst mit JSON und XML.

Siehe auch