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.asmx
  

  Parameter	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?WSDL
  

  Parameter	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&parametername1=value1&...&parameternamen=valuen
  

  Parameter	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
  

Siehe auch

Konzepte

XML-Webdienstbeschreibung

Weitere Ressourcen

Erstellen von Webdiensten in verwaltetem Code