Gewusst wie: Durchsuchen des Inhalts von Webdiensten
Aktualisiert: November 2007
Die ASMX-Datei stellt den adressierbaren Einstiegspunkt für mit verwaltetem Code erstellte Webdienste dar. Der Zugriff auf diese Datei über HTTP legt den Typ der zurückgegebenen Antwort fest.
Diensthilfeseite
Wenn die ASMX-Datei ohne Angabe einer bekannten Abfragezeichenfolge über einen Webbrowser aufgerufen wird, gibt sie eine automatisch generierte Diensthilfeseite für den Webdienst zurück. Dies entspricht dem Ausführen von HTTP GET im Zusammenhang mit der ASMX-Datei.
Diese Hilfeseite für Dienstmethoden enthält eine Liste der vom Webdienst bereitgestellten Methoden, auf die Sie programmgesteuert zugreifen können. Diese Seite verfügt über Links, die Ihnen weitere Informationen zu jeder einzelnen Methode bereitstellen. Außerdem enthält diese Seite einen Link zum Dokument für die Webdienstbeschreibung.
So greifen Sie auf die Diensthilfeseite zu
Geben Sie in das Adressfeld des Browsers die Basis-URL für den Webdienst im folgenden Format ein:
https://servername/projectname/webservicename.asmxParameter
Value
servername
Der Server, auf dem der Webdienst gespeichert ist.
projectname
Der Name des Projekts für den Webdienst sowie zusätzliche Verzeichnisinformationen, die für den Zugriff auf die ASMX-Datei des Webdiensts erforderlich sind.
webservicename.asmx
Der Name der ASMX-Datei für den Webdienst.
Um z. B. auf einen Webdienst mit dem Namen Service1.asmx zuzugreifen, der Teil eines Projekts mit dem Namen WebService1 auf dem lokalen Computer ist, müssen Sie Folgendes eingeben:
https://localhost/WebService1/Service1.asmx
Die Dienstmethodenhilfeseite enthält zusätzliche Informationen zur betreffenden Webdienstmethode.
Auf dieser Seite haben Sie die Möglichkeit, die Methode mit dem HTTP-POST-Protokoll aufzurufen. Um diese Funktion aktivieren zu können, muss die Webdienstmethode jedoch das HTTP-POST-Protokoll unterstützen.
Unten auf der Dienstmethodenhilfeseite befinden sich eine Beispielanforderung sowie Antwortmeldungen für die Protokolle, die von der Webdienstmethode unterstützt werden.
Dienstbeschreibung
Die Diensthilfeseite enthält auch einen Link zur Beschreibung des Webdiensts. Diese besteht aus einer formalen Beschreibung der Funktionen des Webdiensts. Die Dienstbeschreibung ist ein Dokument, das die Grammatik der Web Service Description Language (WSDL) verwendet. Die Dienstbeschreibung definiert die Vereinbarung für die Meldungsformate, die Clients beachten müssen, wenn sie Meldungen mit dem Webdienst austauschen. Weitere Informationen hierzu finden Sie unter XML-Webdienstbeschreibung.
So greifen Sie auf die Dienstbeschreibung zu
Geben Sie in das Adressfeld des Browsers die Basis-URL für den Webdienst ein, und stellen Sie die WSDL-Abfragezeichenfolge im folgenden Format bereit:
https://servername/projectname/webservicename.asmx?WSDLParameter
Value
servername
Der Server, auf dem der Webdienst gespeichert ist.
projectname
Der Name des Projekts für den Webdienst sowie zusätzliche Verzeichnisinformationen, die für den Zugriff auf die ASMX-Datei des Webdiensts erforderlich sind.
webservicename.asmx
Der Name der ASMX-Datei für den Webdienst.
Um z. B. auf die Dienstbeschreibung eines Webdiensts Service1.asmx zuzugreifen, der Teil eines Projekts WebService1 auf dem lokalen Computer ist, müssen Sie Folgendes eingeben:
https://localhost/WebService1/Service1.asmx?WSDL
Zugreifen auf Webdienste über einen Webbrowser
Sie können über einen Webbrowser auf einen Webdienst zugreifen, der das HTTP-GET-Protokoll unterstützt. Standardmäßig unterstützen Webdienste, die in Visual Studio mit der Projektvorlage für ASP.NET-Webdienste erstellt werden, HTTP-GET, HTTP-POST und HTTP-SOAP. Nicht alle Protokolle unterstützen alle Methoden. In der Regel unterstützen die Protokolle HTTP-GET und HTTP-POST weniger Datentypen als HTTP-SOAP.
So greifen Sie über einen Webbrowser auf einen Webdienst zu
Geben Sie in das Adressfeld des Browsers die Basis-URL für den Webdienst zusammen mit dem Methodennamen und den Parametern in der Abfragezeichenfolge ein. Verwenden Sie dazu folgendes Format:
https://servername/projectname/webservicename.asmx/methodname?parametername0=value0¶metername1=value1&...¶meternamen=valuenParameter
Value
servername
Der Server, auf dem der Webdienst gespeichert ist.
projectname
Der Name des Projekts für den Webdienst sowie zusätzliche Verzeichnisinformationen, die für den Zugriff auf die ASMX-Datei des Webdiensts erforderlich sind.
webservicename.asmx
Der Name der ASMX-Datei für den Webdienst.
methodname
Der Name der Webmethode; bei diesem Namen ist die Schreibweise relevant.
parametername
Die Namen der Webmethodenparameter
value
Die URL-codierten Werte der einzelnen Webmethodenparameter.
Wenn Sie z. B. auf die ReturnThisString-Methode eines Webdiensts Service1.asmx mit einem Parameter MyString zugreifen möchten, der auf den Wert "This is my test string" festgelegt wurde und Teil eines Projekts WebService1 auf dem lokalen Computer ist, müssen Sie Folgendes eingeben:
https://localhost/WebService1/Service1.asmx/ReturnThisString?MyString=This+is+my+test+string