Gewusst wie: Deaktivieren der Diensthilfeseite für einen Webdienst
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
Öffnen Sie die Datei Web.config im Stammverzeichnis der Webanwendung in einem Texteditor. (Erstellen Sie die Datei Web.config, wenn sie nicht vorhanden ist.)
Ändern Sie den
webServices
-Abschnitt der Web.config so, dass das Documentation-Protokoll explizit entfernt wird.<webServices> <protocols> <remove name="Documentation" /> </protocols> </webServices>
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 Ordnerdocs
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
Gewusst wie: Deaktivieren der Protokollunterstützung für Webdienste
Gewusst wie: 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
Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.