Gewusst wie: Steuern der Generierung von WSDL-Dateien für ASP.NET-Webdienste
Aktualisiert: November 2007
Wenn Sie mit dem Anwendungs-Designer in Visual Studio Team System Architecture Edition arbeiten, können Sie die Generierung von WSDL-Dateien für alle Webdienste einer ASP.NET-Anwendung aktivieren bzw. deaktivieren. Die WSDL-Dateigenerierung ist in Visual Studio standardmäßig aktiviert. Weitere Informationen finden Sie unter Generieren von WSDL-Dateien für ASP.NET-Webdienste.
Hinweis: |
---|
Das Deaktivieren oder Aktivieren der Generierung von WSDL-Dateien gilt für alle Webdienste einer ASP.NET-Anwendung. Wenn Sie die Generierung von WSDL-Dateien deaktivieren, ohne einen anderen Speicherort für die WSDL-Datei anzugeben, wird das Generieren von Webverweisen verhindert. Dadurch wird ein Fehler ausgelöst, da die WSDL-Datei nicht am angegebenen Speicherort gefunden werden konnte. Durch das Deaktivieren der Generierung von WSDL-Dateien wird auch das Erstellen der ASP.NET-Standardtestseite beim Zugriff auf den Webdienst-URL von einem Browser verhindert. Weitere Informationen finden Sie unter Gewusst wie: Überschreiben von WSDL-Bindungsdefinitionen in WSDL-Dateien. |
Sie können diese Aufgabe vor Implementierung mithilfe des Einstellungs- und Einschränkungs-Editors ausführen. Nach dem Implementieren der ASP.NET-Anwendung können Sie auch die entsprechende Einstellung in der Datei Web.config entfernen oder hinzufügen, die Sie je nach gewünschtem Umfang im Anwendungsprojekt oder in der Datei Machine.config des Webservers finden, auf dem die Anwendung bereitgestellt wird.
So deaktivieren Sie die Generierung von WSDL-Dateien für eine ASP.NET-Anwendung
Klicken Sie im Anwendungsdiagramm auf die gewünschte ASP.NET-Anwendung.
Wählen Sie im Menü Diagramm die Option Einstellungen und Einschränkungen aus.
Erweitern Sie im Einstellungs- und Einschränkungs-Editor unter Einstellungen den Knoten Verzeichnis und dann den Knoten Konfiguration.
Klicken Sie mit der rechten Maustaste auf Konfiguration, zeigen Sie auf Ressource hinzufügen, und wählen Sie SystemWebSectionGroup aus.
Klicken Sie mit der rechten Maustaste auf den Knoten SystemWebSectionGroup, zeigen Sie auf Ressource hinzufügen, und wählen Sie WebServicesSection aus.
Erweitern Sie im rechten Bereich des Einstellungs- und Einschränkungs-Editors den Knoten Einstellungen.
Klicken Sie in der Zeile Protokolle auf die Spalte Wert und dann auf die Auslassungszeichen (…).
Der ComplexSetting-Auflistungs-Editor wird angezeigt.
Wählen Sie in der Member-Liste den Eintrag Dokumentation aus, und klicken Sie auf Entfernen und dann auf OK.
Der folgende Eintrag wird nicht in den <System.Web>-Abschnitt der Konfigurationsdatei Web.config der Anwendung eingefügt, die nach dem Implementieren der Anwendung generiert wird:
<add name="Documentation" />
Sie können diesen Eintrag auch aus der Datei Machine.config des Webservers entfernen, um die Generierung von WSDL-Dateien für alle ASP.NET-Anwendungen auf diesem Server zu deaktivieren.
So aktivieren Sie die Generierung von WSDL-Dateien für eine ASP.NET-Anwendung
Wählen Sie im Diagramm die gewünschte ASP.NET-Anwendung aus.
Wählen Sie im Menü Diagramm die Option Einstellungen und Einschränkungen aus.
Erweitern Sie im Einstellungs- und Einschränkungs-Editor unter Einstellungen den Knoten Verzeichnis und dann den Knoten Konfiguration.
Erweitern Sie den Knoten SystemWebSectionGroup, und wählen Sie die Ressource WebServicesSection aus.
Erweitern Sie im rechten Bereich des Einstellungs- und Einschränkungs-Editors den Knoten Einstellungen.
Klicken Sie in der Zeile Protokolle auf die Spalte Wert und dann auf die Auslassungszeichen (…).
Der ComplexSetting-Auflistungs-Editor wird angezeigt.
Klicken Sie im ComplexSetting-Auflistungs-Editor auf Hinzufügen.
In der Member-Liste wird eine neue Einstellung angezeigt.
Benennen Sie die Einstellung in der zugehörigen Eigenschaftenliste mit "Dokumentation", und klicken Sie auf OK.
Der folgende Eintrag wird in den <System.Web>-Abschnitt der Konfigurationsdatei Web.config der Anwendung eingefügt, die nach dem Implementieren der Anwendung generiert wird:
<add name="Documentation" />
Sie können diesen Eintrag auch in der Datei Machine.config des Webservers hinzufügen, um die Generierung von WSDL-Dateien für alle ASP.NET-Anwendungen auf diesem Server zu aktivieren.
Siehe auch
Weitere Ressourcen
Konfigurieren der Generierung von WSDL-Dateien für ASP.NET-Webdienste