Vorgehensweise: Deaktivieren der Diensthilfeseite für einen Webdienst

Dieses Thema bezieht sich auf eine veraltete Technologie. XML-Webdienste und XML-Webdienstclients sollten nun mithilfe der folgenden Technologie erstellt werden: Windows Communication Foundation.

Wird in einem Webbrowser ohne Parameter zur URL für den Webdienst navigiert, wird eine HTML-Hilfeseite erzeugt, sofern die Seite aktiviert ist (in der Datei machine.config eines Servers ist dies standardmäßig der Fall). Die Diensthilfeseite und ihre Konfiguration werden in Konfigurationsoptionen für mit ASP.NET erstellte XML-Webdienste näher erläutert.

So deaktivieren Sie die Diensthilfeseite für eine einzelne Webanwendung

1. Öffnen Sie die Datei Web.config im Stammverzeichnis der Webanwendung in einem Texteditor. (Erstellen Sie die Datei Web.config, wenn sie nicht vorhanden ist.)

2. Ändern Sie den webServices-Abschnitt der Web.config so, dass das Documentation-Protokoll explizit entfernt wird.

   <webServices>
        <protocols>
          <remove name="Documentation" />
        </protocols>
   </webServices>
   

3. Speichern Sie die Datei Web.config.

   Diese Konfigurationsänderung tritt bei der nächsten Anforderung für einen Webdienst in Kraft, der von der Webanwendung gehostet wird.

   Hinweis:

   Beim Entfernen des Documentation-Protokolls wird die WSDL-Dateigenerierung für alle Webdienste innerhalb der Webanwendung ebenfalls deaktiviert. Dies verhindert, dass Clients eine Proxyklasse generieren, sofern nicht eine benutzerdefinierte WSDL-Datei für sie erstellt und bereitgestellt wird. Wenn die WSDL-Dateigenerierung für Webdienste innerhalb einer Webanwendung aktiviert bleiben soll, aber keine lesbaren Informationen hinsichtlich der Webdienste bereitgestellt werden sollen, können Sie der Datei Web.config der Webanwendung ein <wsdlHelpGenerator>-Element hinzufügen und das href-Attribut auf eine leere, von Ihnen erstellte HTML-Seite festlegen. Das folgende Codebeispiel ist ein Auszug aus einer Web.config-Datei, in der die Diensthilfeseite auf die Datei MyBlank.htm im Ordner docs festgelegt wird. Dieser Ordner ist ein Unterordner des Ordners, der die Datei Web.config enthält.

   <webServices>
      <wsdlHelpGenerator href="docs/MyBlank.htm"/>
   </webServices>
   

Siehe auch

Aufgaben

Vorgehensweise: Deaktivieren der Protokollunterstützung für Webdienste
Vorgehensweise: Aktivieren der Suche für XML-Webdienste

Konzepte

Konfigurationsoptionen für mit ASP.NET erstellte XML-Webdienste
Bereitstellen von XML-Webdiensten

Weitere Ressourcen

XML-Webdienste, die ASP.NET verwenden