Gewusst wie: Definieren von Vorgängen für ASP.NET-Webdienste
Aktualisiert: November 2007
Im Anwendungs-Designer und im System-Designer können Sie Vorgänge für einen .NET-Webdienst-Anbieterendpunkt definieren. Sie können diese Aufgabe mithilfe des Fensters Webdienstdetails ausführen. Weitere Informationen finden Sie unter Übersicht über ASP.NET-Anwendungen in Anwendungsdiagrammen.
.gif "Tipp") Tipp: |
|---|
Sie können einen .NET-Webdienst-Anbieterendpunkt mit vordefinierten Vorgangssignaturen und Typen erstellen, indem Sie eine WSDL-Datei oder DISCO-Datei angeben. Sie können diese Vorgänge dann im Fenster Webdienstdetails bearbeiten. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Endpunkten zu Anwendungen. |
Wenn Sie die Vorgänge für einen .NET-Webdienst-Anbieterendpunkt definieren, definieren Sie sie für alle Verwendungen dieses Endpunkts. Sie können die Vorgänge nach dem Definieren jederzeit im Fenster Webdienstdetails bearbeiten. Nach dem Implementieren einer ASP.NET-Anwendung mit einem .NET-Webdienst-Anbieterendpunkt können Sie die Vorgänge des Endpunkts im Fenster Webdienstdetails oder im Code bearbeiten, wobei jeweils eine Synchronisierung erfolgt. Weitere Informationen finden Sie unter Gewusst wie: Bearbeiten von Vorgängen für ASP.NET-Webdienste.
| Hinweis: |
|---|
Das ASP.NET-Anwendungsprojekt enthält eine Klassendatei für den Webdienst für jeden Webdienst-Anbieterendpunkt in der Anwendung. Jede Klassendatei für einen Webdienst enthält die Vorgangssignaturen für den entsprechenden Anbieterendpunkt des Webdiensts. Jede Vorgangssignatur wird zusammen mit sämtlichen Kommentaren in der Klassendatei des Webdiensts als Methode mit dem WebMethod-Attribut angezeigt. Sie können den entsprechenden Methodentextcode hinzufügen, um die Implementierung der Vorgänge abzuschließen. |
So definieren Sie einen Webdienstvorgang
Wählen Sie im Diagramm einen Webdienst-Anbieterendpunkt aus.
Wählen Sie im Menü Diagramm den Befehl Vorgänge definieren aus.
Tipp:Sie können auch mit der rechten Maustaste auf den Endpunkt klicken und Vorgänge definieren auswählen.
Das Fenster Webdienstdetails wird angezeigt.
Klicken Sie im Fenster Webdienstdetails in der Vorgangszeile unter Name auf <Vorgang hinzufügen>, und benennen Sie den Vorgang.
Geben Sie in derselben Zeile unter Typ ggf. den Rückgabetyp des Vorgangs an. Wenn Sie keinen Typ angeben möchten, fahren Sie mit Schritt 7 fort.
Hinweis:Standardmäßig gibt ein Vorgang nur dann Daten zurück, wenn er explizit dafür definiert wurde. Die Darstellung eines Vorgangs ohne Datenrückgabe ist von der für den Webdienst angegebenen Sprache abhängig. In Visual Basic wird kein Rückgabetyp für den Vorgang angegeben. In Visual C# lautet der Standardrückgabetyp für einen Vorgang void. Schnittstellentypen können nicht serialisiert werden und generieren beim Erstellen von Webverweisen, die mit dem Webdienst verbunden sind, Fehler.
Beginnen Sie zur Auswahl eines Typs mit der Eingabe, um die Typliste anzuzeigen.
Bei der Eingabe wird die Liste mit den verfügbaren Typen geöffnet.
Tipp:Wenn der gewünschte Typ nicht in der Liste enthalten ist, verwenden Sie den vollqualifizierten Namen, oder Sie geben einen in einen anderen Projekt bzw. einer anderen Typbibliothek definierten Typ an, oder Sie geben einen neuen Typ für die Definition nach der Implementierung an. Um die Angabe des Typs abzuschließen, setzen Sie die Eingabe des gewünschten Typnamens fort.
Verlassen Sie die Zelle durch das Drücken der EINGABETASTE oder durch Klicken in eine andere Zelle.
Hinweis:Wenn Sie die TAB-TASTE drücken, wird der eingegebene Typ durch die nächste Übereinstimmung in der Typliste ersetzt.
Fügen Sie unter Zusammenfassung sämtliche Kommentare über den Vorgang hinzu.
Tipp:Um weitere Informationen hinzuzufügen, klicken Sie auf die Auslassungszeichen (…), um das Dialogfeld Beschreibung zu öffnen. Sie können dann zusätzliche Kommentare für die WSDL-Beschreibung, den Rückgabetyp des Vorgangs und andere Anmerkungen angeben. Alle eingegebenen WSDL-Beschreibungen werden in der WSDL-Datei angezeigt.
Bevor Sie eine ASP.NET-Anwendung implementieren, werden in der Typliste nur die Typen angezeigt, die in der Microsoft-Hauptbibliothek (MSCorLib.dll) sowie in einigen Typbibliotheken, auf die implizit verwiesen wird, definiert sind. Sie können aber auch auf Typen in anderen Typbibliotheken und Projekten verweisen, und Sie können auf Typen verweisen, die Sie zu einem späteren Zeitpunkt im Code oder mithilfe des Klassen-Designers definieren werden, nachdem die Anwendung implementiert wurde.
Wenn Sie auf Typen verweisen, die in andere Projekten oder Typbibliotheken definiert sind, müssen Sie nach dem Implementieren der Anwendung Verweise auf diese Projekte bzw. Bibliotheken hinzufügen. Die Typliste wird dann alle Typen enthalten, die in allen Projekten und Typbibliotheken, auf die explizit verwiesen wird, definiert sind. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Verweisen in Visual Studio (C#).
Wenn Sie auf Typen verweisen, die Sie später definieren werden, werden diese erst dann in der Typliste angezeigt, wenn Sie nach dem Implementieren der Anwendung eine Klassendatei oder ein Klassendiagramm zum Anwendungsprojekt hinzufügen, um die Typen zu definieren. Weitere Informationen finden Sie unter Gewusst wie: Definieren von Vorgängen und Parametertypen für ASP.NET-Webdienste.
Nach dem Definieren eines Vorgangs können Sie dessen Parameter oder einen weiteren Vorgang in der nächsten Vorgangszeile definieren.
So definieren Sie Parameter für einen Webdienstvorgang
Erweitern Sie im Fenster Webdienstdetails den Vorgangsknoten.
Klicken Sie auf der Parameterzeile unter dem Vorgang unter Name auf <Parameter hinzufügen>, und benennen Sie den Parameter.
Tipp:Wählen Sie einen eindeutigen Parameternamen innerhalb des Vorgangs aus.
Geben Sie unter Typ ggf. den Parametertyp an.
Wählen Sie unter Modifizierer aus, wie der Parameter übergeben wird.
Fügen Sie unter Zusammenfassung sämtliche Kommentare über den Parameter hinzu.
Tipp:Um weitere Informationen hinzuzufügen, klicken Sie auf die Auslassungszeichen (…), um das Dialogfeld Beschreibung zu öffnen.
Nachdem Sie einen Parameter definiert haben, können Sie auf der nächsten Parameterzeile einen neuen Parameter definieren. Sie können einen Parameter auch im Eigenschaftenfenster über seine Eigenschaften definieren.
Siehe auch
Aufgaben
Gewusst wie: Angeben von unidirektionalen oder Anforderungs-Antwort-Vorgängen für ASP.NET-Webdienste
Gewusst wie: Bearbeiten von Vorgängen für ASP.NET-Webdienste
Gewusst wie: Löschen von Vorgängen und Parametern aus ASP.NET-Webdiensten
Referenz
Tastenkombinationen für das Fenster "Webdienstdetails"