WCF Visual Studio-Vorlagen

Artikel
09/12/2008

Windows Communication Foundation (WCF) Visual Studio-Vorlagen sind vordefinierte Projekt- und Elementvorlagen, die Sie in Visual Studio verwenden können, um mühelos WCF-Dienste und entsprechende Anwendungen zu erstellen.

Verwenden der WCF-Vorlagen

Visual Studio-Vorlagen aus WCF stellen eine grundlegende Klassenstruktur zur Dienstentwicklung bereit. Diese Vorlagen stellen genau genommen die grundlegenden Definitionen für den Dienstvertrag, den Datenvertrag, die Dienstimplementierung und die Konfiguration bereit. Mit diesen Vorlagen können Sie einen einfachen Dienst mit minimaler Codeinteraktion sowie einen Baustein für komplexere Dienste erstellen.

WCF-Dienstbibliotheksprojektvorlage

Die WCF-Dienstbibliotheksprojektvorlage steht im Dialogfeld Neues Projekt unter Visual C#\WCF und Visual Basic\WCF zur Verfügung.

Wenn Sie ein neues Projekt mit der WCF-Dienst-Vorlage erstellen, enthält das neue Projekt standardmäßig die folgenden drei Dateien:

Dienstvertragsdatei (IService1.cs oder IService1.vb). Die Dienstvertragsdatei ist eine Schnittstelle, auf die WCF-Dienstattribute angewendet wurden. Diese Datei enthält eine Definition eines einfachen Dienstes, anhand derer Sie sehen können, wie Sie Ihre Dienste definieren können, sowie Parameter-basierte Vorgänge und ein Beispiel für einen einfachen Datenvertrag. Dies ist die Standarddatei, die nach dem Erstellen eines WCF-Dienstprojekts im Code-Editor angezeigt wird.
Dienstimplementierungsdatei (Service1.cs oder Service1.vb). Die Dienstimplementierungsdatei implementiert den in der Dienstvertragsdatei definierten Vertrag.
Anwendungskonfigurationsdatei (App.config). Die Konfigurationsdatei stellt die Grundelemente eines WCF-Dienstmodells mit einer sicheren HTTP-Bindung bereit. Sie enthält auch einen Endpunkt für den Dienst und aktiviert den Metadatenaustausch.

Hinweis Visual Studio wurde so konfiguriert, dass die Datei App.config als Konfigurationsdatei für das Projekt erkannt wird, wenn sie, wie standardmäßig konfiguriert, mit WCF-Diensthost (WcfSvcHost.exe) ausgeführt wird. Wenn als Host für die Dienstbibliothek eine EXE-Datei verwendet wird, müssen Sie den Konfigurationscode in die Konfigurationsdatei der EXE-Datei verschieben, da Konfigurationsdateien für DLL-Dateien ungültig sind.

Dienstvorlage für WCF-Webanwendungen

Die WCF-Dienstvorlage für Webanwendungen steht im Dialogfeld "Neues Projekt" unter Visual C#\Web sowie unter Visual Basic\Web zur Verfügung.

Wenn Sie ein neues Projekt mit der Vorlage für den WCF-Webanwendungsdienst erstellen, enthält das neue Projekt standardmäßig die folgenden vier Dateien:

Diensthostdatei (service1.svc)
Dienstvertragsdatei (IService1.cs oder IService1.vb)
Dienstimplementierungsdatei ("Service1.svc.cs" oder "Service1.svc.vb")
Webkonfigurationsdatei (web.config)

Die Vorlage erstellt automatisch eine Website, die in einem virtuellen Verzeichnis eingerichtet wird, und dient zugleich als Host für einen Dienst.

Websitevorlage für den WCF-Dienst

Die WCF-Websitevorlage steht im Dialogfeld "Neues Projekt" unter Visual C#\Website\WCF-Dienst sowie unter Visual Basic\Website\WCF-Dienst zur Verfügung.

WCF-Dienstelementvorlage

Die WCF-Dienstelementvorlage ist eine benutzerdefinierte Vorlage, über die Sie mühelos WCF-Dienste zu Ihren vorhandenen Visual Studio-Projekten hinzufügen können.

Gehen Sie zum Projektmappen-Explorer, und klicken Sie mit der rechten Maustaste auf den Projektnamen. Zeigen Sie auf Hinzufügen, und klicken Sie auf Neues Element, um das Dialogfeld Neues Element hinzufügen zu öffnen, über das Sie diese Vorlage verwenden können.

Die Dienstschnittstelle und die Implementierungsdateien werden im Stammprojektordner abgelegt.

Die Vorlage versucht, den Konfigurationsabschnitt des neuen Diensts mit einer beliebigen vorhandenen Konfigurationsdatei zusammenzuführen, sofern es sich um kompatible Typen handelt.

Eine Diensthostdatei (service1.svc) wird auch dann erstellt, wenn das vorhandene Projekt ein Webprojekt ist.

WCF-WF-Dienstprojektvorlage und Elementvorlage.

Mit diesen Vorlagen werden WCF-Dienste erstellt, die als Host für einen WF-Workflow fungieren. Auf diesen Workflow können Sie auf die gleiche Weise zugreifen wie auf einen Webdienst. Für XAML oder imperative Programmiermodelle gibt es unterschiedliche Vorlagen. Wenn Sie die Vorlagen verwenden, können Sie einen sequenziellen Workflow oder einen Statuscomputer-Workflow erstellen. Weitere Informationen zu diesen Workflowtypen finden Sie unter Windows Workflow Foundation Tutorials. Weitere Informationen zum Erstellen von Workflowprojekten finden Sie unter Creating Workflow Projects.

Visual Studio-Designer ist reaktionsfreudiger, wenn anstelle von Code-basierten Workflows Workflows des Typs XOML verwendet werden. Der XOML-Workflow ist der Standardworkflowtyp, der erstellt werden sollte.

WCF Syndication-Vorlage

Mit dieser Vorlage können Sie den Feed im RSS- oder ATOM-Format als WCF-Dienst verfügbar machen. Weitere Informationen finden Sie unter WCF Syndication.

Ändern der Adresse des Feeds

Die Syndication-Vorlage verwendet während der Ausführung Internet Explorer. Wenn Sie mit der rechten Maustaste im Projektmappen-Explorer in Visual Studio auf das Projekt klicken, im Kontextmenü Eigenschaften wählen und auf die Registerkarte Debuggen klicken, sehen Sie die Standardadresse der Vorlage. Internet Explorer versucht, den Feed unter dieser Adresse zu öffnen.

Wenn Sie die Adresse Ihres Feeds ändern, müssen Sie die Adresse auf der Registerkarte Debuggen ebenfalls ändern. Wenn Sie dies nicht tun, wird Internet Explorer versuchen, den Feed unter der Standardadresse zu öffnen, was fehlschlägt.

AJAX-aktivierte WCF-Dienstelementvorlage

Mit dieser Vorlage wird ein AJAX-Steuerelement als WCF-Dienst verfügbar gemacht. Weitere Informationen zu AJAX-Steuerelementen finden Sie in der Dokumentation zu AJAX-Steuerelementen. (Seite ist möglicherweise nur in englischer Sprache verfügbar.)

Silverlight-aktivierte WCF-Dienstelementvorlage

Diese Vorlage erstellt einen Webdienst, der Daten für einen Silverlight-Client oder für ein Silverlight-Front-End bereitstellt. Die Vorlage kann einem Website- oder einem Webanwendungsprojekt hinzugefügt werden, um einen WCF-Dienst zu erstellen, der Dienstcode und -konfiguration für die Kommunikation mit einem Silverlight-Client beinhaltet. Verwenden Sie die Funktion Dienstverweis hinzufügen, um dem Client einen Clientproxy des Diensts hinzuzufügen und Daten zwischen dem Silverlight-Client und dem Silverlight-aktivierten WCF-Dienst auszutauschen.

Klicken Sie zum Aufrufen dieser Vorlage im Projektmappen-Explorer mit der rechten Maustaste auf ein Website- oder Webanwendungsprojekt, klicken Sie auf Neues Element hinzufügen, und klicken Sie anschließend auf Silverlight-aktivierter WCF-Dienst.

Vorsicht Der Silverlight-aktivierte WCF-Dienst macht einen basicHttpBinding-Endpunkt ohne aktivierte Sicherheitseinstellungen verfügbar. Deshalb können Dienstinformationen von allen Clients abgerufen werden, die eine Verbindung mit diesem Dienst herstellen. Zudem werden zwischen dem Dienst und dem Client ausgetauschte Nachrichten weder signiert noch verschlüsselt. Sichern Sie den Endpunkt nach Möglichkeit per ASP.NET-Authentifizierung, per HTTPS oder mit einem anderen Mechanismus.

Siehe auch

Konzepte

WCF-Diensthost (WcfSvcHost.exe)
WCF-Testclient (WcfTestClient.exe)

Freigeben über