Exemplarische Vorgehensweise: Entwerfen eines Webdiensts
Aktualisiert: November 2007
In dieser exemplarischen Vorgehensweise werden die wichtigsten Aspekte des Entwurfs eines Webdiensts mit dem Anwendungs-Designer in Visual Studio Team System Architecture Edition veranschaulicht. In dieser exemplarischen Vorgehensweise werden folgende Schritte beschrieben:
Definieren von Operationen für einen vorhandenen Webdienst
Implementieren des Webdiensts
Hinzufügen eines externen Webdiensts (ein Webdienst außerhalb der Projektmappe) und Anzeigen von Webmethoden für den Webdienst
Verbinden des externen Webdiensts mit anderen Anwendungen
Diese exemplarische Vorgehensweise baut auf den Konzepten auf, die in der einführenden exemplarischen Vorgehensweise Exemplarische Vorgehensweise: Definieren von Anwendungen in Anwendungsdiagrammen vorgestellt wurden.
So definieren Sie Operationen für den Catalog-Webdienst
Downloaden Sie das unter https://go.microsoft.com/fwlink/?LinkId=40867 bereitgestellte Beispiel.
Doppelklicken Sie auf die Datei Catalog.ad, um das Anwendungsdiagramm zu öffnen.
Daraufhin wird das Anwendungsdiagramm im Anwendungs-Designer angezeigt.
Klicken Sie mit der rechten Maustaste auf den CatalogWebService-Endpunkt in Catalog, und wählen Sie Vorgänge definieren aus, um das Fenster Webdienstdetails anzuzeigen.
Klicken Sie im Fenster Webdienstdetails auf <Vorgang hinzufügen>, und geben Sie GetProductDetails ein.
Geben Sie unter Typ den Wert ProductDetails ein.
Mit dem hier eingegebenen Vorgangstyp wird der Rückgabetyp des Vorgangs angegeben.
Erweitern Sie das Pluszeichen (+) auf der linken Seite von GetProductDetails, um dem Vorgang Parameter hinzuzufügen.
Klicken Sie auf <Parameter hinzufügen>, und geben Sie ProductNumber ein. Geben Sie unter Typ den Wert Integer ein.
.gif "Hinweis")
Hinweis:Wenn Sie mit Ihrer Eingabe in der Spalte Typ beginnen, wird in Visual Studio eine Liste verfügbarer Typen angezeigt.
Dieser Vorgang akzeptiert eine ganzzahlige Produktnummer und gibt eine ProductDetails-Struktur zurück.
Die definierte Operation ist standardmäßig ein Anforderung-Antwort-Paar. Weitere Informationen über das Ändern dieser Eigenschaft finden Sie unter Gewusst wie: Angeben von unidirektionalen oder Anforderungs-Antwort-Vorgängen für ASP.NET-Webdienste.
So legen Sie Projekteigenschaften fest und implementieren den Catalog-Webdienst
Klicken Sie in der Anwendung Catalog auf den CatalogWebService-Endpunkt.
Zeigen Sie das Eigenschaftenfenster an.
Ändern Sie die WSDL-Bindungsname-Eigenschaft in Catalog.
Ändern Sie die WSDL-Bindungsnamespace-Eigenschaft in http://Adventureworks/Products.
Klicken Sie auf die Anwendung Catalog, und ändern Sie deren Sprache-Eigenschaft in Visual C#.
Hinweis:Wenn Sie alle Sprachen mit Visual Studio installiert haben, ist der Standardwert dieser Eigenschaft Visual Basic.
Zeigen Sie bei ausgewählter Anwendung Catalog im Menü Diagramm auf Implementierung, und klicken Sie auf Anwendung implementieren.
Das Dialogfeld Anwendungsimplementierung bestätigen wird angezeigt.
Überprüfen Sie die Implementierungsdetails für die Anwendung Catalog, und klicken Sie auf OK.
Während der Implementierung wird ein Projekt für die Anwendung mit den entsprechenden Webverweisen generiert. Nach Abschluss der Implementierung wird die Anwendung mit einem Schatten angezeigt.
Hinweis:Wenn das Dialogfeld Sicherheitswarnung angezeigt wird, klicken Sie auf Schließen. Dieses Dialogfeld gibt an, dass die Datenbankverbindungszeichenfolge für die Datenbank im Anwendungsdiagramm unverschlüsselt und im Klartext in die Konfigurationsdatei geschrieben wird.
Überprüfen Sie im Projektmappen-Explorer die Proxyklassen und den Webverweis.
Öffnen Sie die Datei CatalogWebService.cs, und zeigen Sie den Code für die Webmethode ProductDetails an.
Beachten Sie, dass Visual Studio den WSDL-Bindungsnamen und WSDL-Bindungsnamespace festgelegt und die Methodensignatur erstellt hat.
Ändern Sie im Code den Vorgangsnamen von GetProductDetails in GetProductInformation.
Klicken Sie auf den CatalogWebService-Endpunkt, und zeigen Sie das Fenster Webdienstdetails an.
Im Fenster Webdienstdetails wurde der Vorgangsname entsprechend der Änderung der Webmethodensignatur im Code geändert. Alle im Code vorgenommenen Änderungen werden automatisch im Fenster Webdienstdetails wiedergegeben, und alle Änderungen in diesem Fenster werden im Code wiedergegeben.
So fügen Sie einen externen Webdienst hinzu und zeigen Webmethoden an
Öffnen Sie die Toolbox, und ziehen Sie einen ExternalWebService in das Anwendungsdiagramm.
Das Dialogfeld Webverweis hinzufügen wird angezeigt.
Suchen Sie den Speicherort von LegacyCatalog.wsdl auf dem lokalen Computer.
Geben Sie im Feld URL diesen Speicherort ein, und klicken Sie auf Gehe zu.
Die Beschreibung der WSDL-Datei wird gemeinsam mit der Methode angezeigt, die sie definiert.
Klicken Sie auf Verweis hinzufügen.
Der externe Webdienst wird im Anwendungsdiagramm angezeigt.
Klicken Sie auf den GetLegacyInfo-Endpunkt.
Zeigen Sie im Menü Ansicht auf Weitere Fenster, und klicken Sie dann auf Webdienstdetails, um das Fenster Webdienstdetails anzuzeigen.
Überprüfen Sie im Fenster Webdienstdetails die Webmethode.
Diese spezielle WSDL-Datei enthält Methoden für den Zugriff auf Informationen in einem Legacykatalog.
So verbinden Sie den externen Webdienst mit dem Catalog-Webdienst
Ziehen Sie im externen Webdienst bei gedrückter ALT-Taste den GetLegacyInfo-Endpunkt zum Rand der Anwendung Catalog.
Dadurch wird in Catalog ein Consumerendpunkt erstellt, der angibt, dass die Anwendung Catalog von LegacyInfo bereitgestellte Dienste nutzt. Bei der Implementierung der Anwendung Catalog generiert Visual Studio Proxyklassen für die Webmethoden, die für den GetLegacyInfo-Endpunkt definiert sind.
Visual Studio fügt der Projektmappe außerdem eine SDM-Datei für den externen Webdienst hinzu. Die Datei enthält SDM-Definitionen für diese Anwendung. Weitere Informationen finden Sie unter Übersicht über das System Definition Model (SDM).
Nächste Schritte
Im nächsten Schritt werden weitere Aufgaben mit Webdienstendpunkten ausgeführt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Vertragsgesteuerter Webdienstentwurf – Erstellen eines Endpunkts.