Gewusst wie: Generieren eines Webdienstproxys
Aktualisiert: November 2007
Um aus einer Clientanwendung auf einen Webdienst zugreifen zu können, müssen Sie zunächst einen Webverweis hinzufügen, der auf einen Webdienst verweist. Beim Erstellen eines Webverweises erzeugt Visual Studio automatisch eine Webdienst-Proxyklasse und fügt diese zum Projekt hinzu. Diese Proxyklasse legt die Methoden des Webdiensts offen und übernimmt das Marshallen der geeigneten Argumente zwischen dem Webdienst und der Anwendung. Visual Studio verwendet die WSDL (Web Services Description Language) zum Erstellen des Proxys. Weitere Informationen hierzu finden Sie unter Infrastruktur von XML-Webdiensten.
Sie können die Eigenschaft für die Webverweis-URL verwenden, um die URL zum Webdienst anzugeben. Mit Webverweis hinzufügen wird diese Eigenschaft standardmäßig auf die URL des von Ihnen ausgewählten Webdiensts festgelegt. Hierbei handelt es sich um eine statische URL. Bei einem Webverweis kann entweder eine statische oder eine dynamische URL verwendet werden. Wenn Sie die Eigenschaft für das URL-Verhalten des Webverweises auf Dynamisch festlegen, ruft die Anwendung die URL zur Laufzeit aus dem Abschnitt appSettings-Element (allgemeines Einstellungsschema) der Konfigurationsdatei der Anwendung ab. Weitere Informationen finden Sie unter Webverweise in Visual Studio.
Nachdem Sie einer Clientanwendung einen Webverweis hinzugefügt haben, können Sie die verfügbar gemachten Methoden dieses Webdiensts aufrufen und wie bei jeder anderen Methode einer Komponente auf die Ergebnisse zugreifen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Aufrufen eines Webdiensts.
Wenn Sie keinen Webverweis hinzufügen können, können Sie mit dem Web Services Description Language-Tool (Wsdl.exe) eine Proxyklasse für den Webdienstclient generieren. Dieser Fall kann z. B. eintreten, wenn Sie von dem Computer, auf dem Sie Visual Studio verwenden, nicht auf den Webdienst zugreifen können. Weitere Informationen hierzu finden Sie unter Erstellen eines XML-Webdienstproxys.
So generieren Sie eine Webdienst-Proxyklasse
- Fügen Sie Ihrem Projekt einen Webverweis hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen und Entfernen von Webverweisen. Eine Proxyklasse wird automatisch generiert und Ihrer Lösung hinzugefügt. Sie kann dann wie andere Klassen instanziiert werden.
Siehe auch
Aufgaben
Gewusst wie: Aufrufen eines Webdiensts
Konzepte
Erstellen eines XML-Webdienstproxys
Referenz
Web Services Description Language-Tool (Wsdl.exe)