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.

image

[Download Demo Source Code]

Letzte Posts

  • Carriage Return / Neue Zeile in Textareas

    Eine kleine Aufgabe: Jede neue Textzeile (Carriage Return/Wenn man Enter drückt ) in einer Textarea soll ein Element in einer Auflistung sein – wie mach ich das jetzt am einfachsten? Eigentlich ein grundlegendes Element im Web und der Nutzer macht bewusst Absätze – daher wäre es nur gerecht, wenn man das auch entsprechend würdigt. Kleine ...

  • image.png
    Doom, Quake, Wolfenstein & co. Source Code auf GitHub

    id Software, die Macher von Doom, Quake, Wolfenstein & co., stellen regelmäßig ihre älteren Spieltitle als Open Source zur Verfügung. Das Ganze runterzuladen fand ich bisher immer recht mühselig, allerdings gibt es seit kurzer Zeit die Sourcen auch auf GitHub. Darunter Spiele wie Doom 3, Quake 3, Wolfenstein für iOS. Wer also schon immer mal ...

  • image.png
    Twitter Bootstrap 2.0 released & “Release Präsentation”

    Wie bereits vom Twitter Bootstrap Team angekündigt wurde offiziel die Version 2.0 des UI Toolskits “Twitter Bootstrap” veröffentlich. Zudem wurden die Slides, welche bei der Release Party gezeigt wurden auch veröffentlicht: Downloads finden sich auf der Twitter Bootstrap Seite auf GitHub.

  • image.png
    Javascript zu Dart Translator

    Dart, Google Javascript Alternative, wurde vor ein paar Monaten vorgestellt und die Webentwickler Szene ist noch etwas gespalten, ob Dart nun überflüssig ist oder einfach nur cool und längst überfällig ist. Um die Sprache näher zu erläutern hat Google die grundlegenden Javascript Basics nach Dart übersetzt. Das Ergebnis ist der “Translator”. Der Name mag momentan ...

  • Twitter Bootstrap 2.0–“Beta”

    Twitter Bootstrap, ein UI-Toolkit für Web-Applikationen von Twitter, erscheint (wie bereits berichtet) demnächst in der Version 2.0. Der offizielle Release ist am 31. Januar, allerdings beginnt jetzt laut Mark Otto (einer der Hauptentwickler von Twitter Bootstrap) die intensive Test-Phase. Das heisst, das es nun offiziel auch die 2.0 Dokumentation online gibt. Im Vergleich zur aktuellen ...