HowTo: Microsoft ASP.NET AJAX (PageMethods - Webmethoden aufrufen ohne ASMX Datein)
In diesem HowTo erklärte ich, wie man eine ASMX Datei so erweitern kann, dass man die Methoden auch über Javascript (und über den ScriptManager) zugänglich macht. Da man allerdings nicht immer eine ASMX Datei erstellen will um vielleicht nur eine kleine Aufgabe zu erledigen gibt es die so genannten PageMethods.
Da das nicht weiter schwer ist, werde ich kurz die Schritte zeigen:
Schritt 1: AJAX Enabeld Website erstellen & ScriptManager anpassen
Durch das Template (wie man das bekommt, ist hier beschrieben)
<asp:ScriptManager ID=”ScriptManager1” runat=”server” EnablePageMethods=”True” />
Wichtig hier ist das “EnablePageMethods” auf “True” zu setzen.
Schritt 2: Die PageMethod in der Code Behind erstellen
Meine einfache PageMethod sieht so aus:
[WebMethod] public static string HelloWorld(string name) { return “Hello World “ + name; }
Die wichtigen Teile sind fett markiert. Für das “WebMethod” Attribut muss der Namespace “System.Web.Services” eingebunden werden. Erst durch dieses Attribut baut der ScriptManager den JS Wrapper drum herum. Der nächste (und sehr wichtige Punkt) - nur statische Methoden können genutzt werden. Um die Objekthierarchie von ASP.NET nicht zu zerstören, können keine Instanzmethoden aufgerufen werden. In der CTP ging dies wohl noch, wurde aber aus Sicherheitsgründen aus dem Release herausgenommen. Allerdings hat man Zugriff auf die Session oder kann dort andere Klassen aufrufen.
Schritt 3: Die Methode im Javascript ansprechen
Die entscheidente Javascriptzeile (die Demoapplikation kann unten runtergeladen werden):
PageMethods.HelloWorld(“Robert”, onComplete);
Über das Javascript Objekt “PageMethods” sind alle Methoden zu finden, welche mit dem WebMethod-Attribut ausgestattet sind und statisch sind. Dann einfach die jeweilige Methode aufrufen und freuen.
