• Artikel

Lektion 2: Hinzufügen eines Webverweises

Webdienstsuche ist der Prozess, durch den ein Client einen Webdienst sucht und seine Dienstbeschreibung erhält. Dieser Prozess in Visual Studio beinhaltet das Abfragen einer Website gemäß einem vorher festgelegten Algorithmus. Ziel des Prozesses ist es, die Dienstbeschreibung zu finden. Diese Beschreibung ist ein XML-Dokument, das WSDL (Web Services Description Language) verwendet.

Die Dienstbeschreibung gibt an, welche Dienste verfügbar sind und wie mit diesen Diensten interagiert werden kann. Ohne eine Dienstbeschreibung ist es nicht möglich, programmgesteuert mit einem Webdienst zu interagieren.

Die Anwendung muss ein Kommunizieren mit dem Webdienst sowie eine Suche nach dem Webdienst zur Laufzeit ermöglichen. Das Hinzufügen eines Webverweises zum Projekt für den Webdienst generiert zu diesem Zweck eine Proxyklasse, die eine Schnittstelle mit dem Webdienst sowie eine lokale Darstellung des Webdiensts bietet. Weitere Informationen finden Sie in der Vorgehensweise zum Generieren eines XML-Webdienstproxys in der Dokumentation zu Visual Studio.

So fügen Sie einen Webverweis hinzu

  1. Klicken Sie im Menü Projekt auf Dienstverweis hinzufügen.

  2. Klicken Sie im Dialogfeld Dienstverweis hinzufügen auf Erweitert.

  3. Klicken Sie im Dialogfeld Dienstverweiseinstellungen auf Webverweis hinzufügen.

  4. Geben Sie im Dialogfeld Webverweis hinzufügen im Feld URL die URL ein, um die Dienstbeschreibung des Berichtsserver-Webdiensts zu erhalten, z. B. https://localhost/reportserver/reportservice.asmx. Klicken Sie dann auf die Schaltfläche Ausführen, um Informationen zu dem Webdienst abzurufen.

    - Oder -

    Wenn sich der Berichtsserver-Webdienst auf dem lokalen Computer befindet, klicken Sie im Browserbereich auf den Link Webdienste auf dem lokalen Computer. Klicken Sie dann in der angezeigten Liste auf den Link für den ReportService2005-Webdienst.

  5. Benennen Sie im Feld Webverweisname den Webverweis in 'ReportService2005' um. Dies ist der Namespace, den Sie für diesen Webverweis verwenden.

  6. Klicken Sie auf Verweis hinzufügen, um einen Webverweis für den Zielwebdienst hinzuzufügen.

    Visual Studio lädt die Dienstbeschreibung herunter und generiert eine Proxyklasse als Schnittstelle zwischen der Anwendung und dem Berichtsserver-Webdienst. Damit der Webverweis funktionsfähig ist, muss auch dem System.Web.Services-Namespace ein Verweis hinzugefügt werden.

  7. Klicken Sie im Menü Projekt auf Verweis hinzufügen.

  8. Wählen Sie im Dialogfeld Verweis hinzufügen auf der Registerkarte .NET den Eintrag System.Web.Services aus, und klicken Sie dann auf OK.

Weitere Informationen finden Sie unter Zugriff auf die SOAP-API.