Freigeben über


WCF Visual Studio-Vorlagen

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

Verwenden der WCF-Vorlagen

WCF Visual Studio-Vorlagen stellen eine grundlegende Klassenstruktur für die Dienstentwicklung bereit. Insbesondere stellen diese Vorlagen die grundlegenden Definitionen für Servicevertrag, Datenvertrag, Dienstimplementierung und Konfiguration bereit. Sie können diese Vorlagen verwenden, um einen einfachen Dienst mit minimaler Codeinteraktion sowie einen Baustein für erweiterte Dienste zu erstellen.

Projektvorlage für WCF-Dienstbibliothek

Die Projektvorlage "WCF-Dienstbibliothek" ist im Dialogfeld "Neues Projekt" unter Visual C#\WCF und Visual Basic\WCF verfügbar.

Wenn Sie ein neues Projekt mithilfe der WCF-Dienstvorlage erstellen, enthält das neue Projekt automatisch die folgenden drei Dateien:

  • Servicevertragsdatei (IService1.cs oder IService1.vb). Die Dienstvertragsdatei ist eine Schnittstelle mit angewendeten WCF-Dienstattributen. Diese Datei bietet eine Definition eines einfachen Diensts, um Ihnen zu zeigen, wie Sie Ihre Dienste definieren und parameterbasierte Vorgänge und ein einfaches Datenvertragsbeispiel enthalten. 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 grundlegenden Elemente eines WCF-Dienstmodells mit einer sicheren HTTP-Bindung bereit. Sie enthält auch einen Endpunkt für den Dienst und ermöglicht den Metadatenaustausch.

Hinweis

Visual Studio ist so konfiguriert, dass die App.config Datei als Konfigurationsdatei für das Projekt erkannt wird, wenn sie mit dem WCF-Diensthost (WcfSvcHost.exe) ausgeführt wird. Dies ist die Standardkonfiguration. Wenn Sie die Dienstbibliothek in einer ausführbaren Datei hosten, müssen Sie den Konfigurationscode in die Konfigurationsdatei der ausführbaren Datei verschieben, da Konfigurationsdateien für DLLs ungültig sind.

WCF-Dienstanwendungsvorlage

Die WCF-Dienstanwendungsvorlage ist im Dialogfeld "Neues Projekt" unter Visual C#\WCF und Visual Basic\WCF verfügbar.

Wenn Sie ein neues Projekt mit der WCF-Webanwendungsdienstvorlage erstellen, enthält das Projekt die folgenden vier Dateien:

  • Diensthostdatei (service1.svc).

  • Servicevertragsdatei (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 bereitgestellt werden soll) und hosten einen Dienst darin.

WCF-Websitevorlage

Die WCF-Websitevorlage ist im Dialogfeld "Neues Projekt" unter Visual C#\Website\WCF-Dienst und Visual Basic\Website\WCF-Dienst verfügbar. Dadurch werden dieselben Dateien wie die WCF-Dienstanwendungsvorlage erstellt, aber so organisiert, als wäre sie eine ASP.NET Website. App_Code und App_Data Ordner werden erstellt.

WCF-Dienstelementvorlage

Die WCF-Dienstelementvorlage ist eine benutzerdefinierte Vorlage, die eine schnelle Möglichkeit zum Hinzufügen von WCF-Diensten zu Ihren vorhandenen Visual Studio-Projekten bietet.

Um diese Vorlage zu verwenden, wechseln Sie zum Projektmappen-Explorer-Bereich , klicken Sie mit der rechten Maustaste auf den Projektnamen, zeigen Sie auf "Hinzufügen", und klicken Sie dann auf "Neues Element ", um das Dialogfeld " Neues Element hinzufügen " zu starten.

Die Dienstschnittstellen- und Implementierungsdateien werden im Stammprojektordner abgelegt.

Die Vorlage versucht, den Konfigurationsabschnitt des neuen Diensts mit der vorhandenen Konfigurationsdatei zusammenzuführen, wenn sie kompatible Typen sind.

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

WCF-WF-Dienstprojektvorlage und Elementvorlage.

Diese Vorlagen erstellen WCF-Dienste, die einen Workflowdienst hosten. Dabei handelt es sich um einen Workflow, auf den wie ein Webdienst zugegriffen werden kann. Für XAML- oder imperative Programmiermodelle sind separate Vorlagen vorhanden. Mithilfe der Vorlagen können Sie sequenzielle oder Zustandsautomaten-Workflows erstellen. Weitere Informationen zu diesen Workflowtypen finden Sie unter How to: Create a Workflow. Weitere Informationen zum Erstellen von Workflowprojekten finden Sie unter Erstellen von Legacyworkflowprojekten.

Visual Studio-Designer ist reaktionsfähiger, wenn XOML-Typworkflows anstelle von codebasierten Workflows verwendet werden. Der XOML-Workflow ist der standardmäßige Workflowtyp, der erstellt werden soll.

Vorlage für WCF/Syndication-Dienstbibliotheken

Mit dieser Vorlage können Sie Ihren 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 Syndizierungsvorlage verwendet einen Webbrowser während der Ausführung. Wenn Sie im Projektmappen-Explorer in Visual Studio mit der rechten Maustaste auf Ihr Projekt klicken, wählen Sie "Eigenschaften" und dann die Registerkarte " Debuggen " aus, und Sie können die Standardadresse der Vorlage sehen. Der Browser versucht, den Feed an dieser Adresse zu öffnen.

Wenn Sie die Adresse Ihres Feeds ändern, müssen Sie auch die Adresse auf der Registerkarte "Debuggen " ändern. Wenn Sie dies nicht tun, versucht der Browser, den Feed an der Standardadresse zu öffnen und schlägt fehl.

AJAX-aktivierte WCF-Dienstelementvorlage

Diese Vorlage macht ein AJAX-Steuerelement als WCF-Dienst verfügbar. Weitere Informationen zu AJAX-Steuerelementen finden Sie in der AJAX-Steuerelementdokumentation.

Silverlight-fähige WCF-Dienstelementvorlage

Diese Vorlage erstellt einen Webdienst, der Daten für einen Silverlight-Client oder front-End bereitstellt. Die Vorlage kann einer Website oder einem Webanwendungsprojekt hinzugefügt werden, um einen WCF-Dienst zu erstellen, der Dienstcode und Konfiguration umfasst, die die Kommunikation mit einem Silverlight-Client unterstützen. Anschließend können Sie Dienstverweis hinzufügen verwenden, um dem Client einen Dienst-Clientproxy hinzuzufügen und Daten zwischen dem Silverlight-Client und dem Silverlight-kompatiblen WCF-Dienst auszutauschen.

Wenn Sie auf diese Vorlage zugreifen möchten, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf eine Website oder ein Webanwendungsprojekt, klicken Sie auf "Neues Element hinzufügen" und dann auf "Silverlight-aktivierter WCF-Dienst".

Hinweis

Der Silverlight-fähige WCF-Dienst macht einen basicHttpBinding Endpunkt verfügbar, ohne Sicherheitseinstellungen zu aktivieren. Daher können Informationen zum Dienst von allen Clients abgerufen werden, die eine Verbindung mit diesem Dienst herstellen. Zwischen dem Dienst und dem Client ausgetauschte Nachrichten werden ebenfalls nicht signiert oder verschlüsselt. Um den Endpunkt ordnungsgemäß zu schützen, sollten Sie ASP.NET Authentifizierung, HTTPS oder andere Mechanismen verwenden.

Siehe auch