T4MVC geht aber noch viel weiter. Durch ein simples Kopieren zweier .tt Dateien ins Projekt stehen einem eine stattliche Anzahl stark typisierter Helper Klassen zur Verfügung, welche sich selber automatisch bei jedem Build aktualisieren.

So wird aus

<% Html.RenderPartial("UserControlName"); %>

die typisierte Variante

<% Html.RenderPartial(MVC.ProjektName.Views.UserControlName); %>

Nebst allen Views ist dasselbe verfügbar für alle Controller Actions und es werden Klassen für stark typisierte Links zu Script Files und statischen Ressourcen erzeugt.

Aus

<img src="/Content/bild.jpg" />

wird also

<img src="<%= Links.Content.bild_jpg %>" />

Die kommende Version 5 von Resharper wird einige praktische Refactorings für MVC an Bord haben, welche auch “Magic Strings” in Action Links und dergleichen berücksichtigt, besser ist es jedoch, solche potentielle Baustellen gar nicht erst entstehen zu lassen. T4MVC hilft einem dabei.

Meine zweite Empfehlung, um sich in das Thema einzuarbeiten, ist Pro ASP.NET MVC Framework von Steve Sanderson, dem Autor von xVal.
Im ersten Teil werden anhand eines Beispielprojekts alle relevanten Komponenten des ASP.NET MVC Frameworks vorgestellt. Im zweiten Buchteil werden das Routing, Controller, Views und die Dateneingabe im Detail erklärt. Gerade die Eingabe und die Verarbeitung von Daten aus Formularen benötigt besondere Beachtung, das im Vergleich zu regulären ASP.NET Projekten einiges anders gelöst wird.

Der Html Helper unterstützt alle Steuerelemente, welche Google in ihrem API anbietet. Das obenstehende Beispiel wurde mit folgendem Aufruf erzeugt:

<%= Html.GoogleMap()
        .Width(640)
        .Height(480)
        .ApiKey("ABCDEFGHIJKLMNOPQRSTUVWXYZ")
        .Language(MapLanguage.de)
        .Coordinates("47.1,8.1")
        .ZoomLevel(8)
        .ScrollZoom()
        .EnableMapType(MapType.Map)
        .EnableOverviewMap()
        .ZoomControlType(MapZoomControlType.LargeMapControl3D)
        .ScrollZoom()
        .Markers(new List<Marker>
                     {
                       new Marker("47.1, 8.1", "I'm a test bubble."),
                       new Marker("47.2, 8.2", "I can describe <strong>interesting</strong> <br />places using HTML.", true)
                     })
 %>

Die Komponente steht vorerst nur via Source Code zur Verfügung, ein Release folgt bald.

Die Routing Engine ist jedoch nicht Bestandteil des MVC Frameworks, sondern wurde mit .NET 3.5 SP1 eingeführt. Somit kann sie auch in einem WebForm Projekt verwendet werden. Der Aufwand hält sich dabei in Grenzen, das ganze ist recht schnell umgesetzt.

Teil 1 dieses Artikels zeigt die Konfiguration der Routing Engine in einer WebForms Applikation und das Anlegen eigener Routen. In einem zweiten Teil werden dann die Security Einstellungen betrachtet.

Konfiguration der WebForms Applikation

Um die Routing Engine nutzen zu können, müssen im Projekt zwei Verweise gesetzt werden: System.Web.Routing und System.Web.Abstractions sind beide im GAC installiert, sie können einfach über “Add Reference” hinzugefügt werden.

Danach muss das Routing Modul im web.config in die Request Pipeline konfiguriert werden. Unter IIS 6 geschieht dies wie folgt:

<httpModules>
  ...
  <add name="RoutingModule"
       type="System.Web.Routing.UrlRoutingModule, System.Web.Routing, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />

Wenn IIS 7 verwendet wird, müssen die folgenden Einträge gemacht werden:

<system.webServer>
  <modules runAllManagedModulesForAllRequests="true">
    ...
    <add name="UrlRoutingModule"
         type="System.Web.Routing.UrlRoutingModule, System.Web.Routing, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35&" />
    ...
  </modules>

  <handlers>
    ...
    <add name="UrlRoutingHandler"
         preCondition="integratedMode"
         verb="*" path="UrlRouting.axd"
         type="System.Web.HttpForbiddenHandler, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    ...
  </handlers>
</system.webServer>

Wenn die Zielumgebung bekannt ist, kann auf die eine Variante verzichtet werden, Einträge für IIS 6 werden allerdings vom IIS 7 ignoriert, und umgekehrt auch, so dass getrost beide Varianten eingetragen werden können.

Konfiguration der Routen

Falls nicht bereits vorhanden, wird eine global.asax Datei zum Projekt hinzugefügt. In dessen Application_Start Event können die Routen eingetragen werden. Eine Route hat immer einen eindeutigen Namen, definiert ein Adressenmuster und legt fest, von welchem Handler Anfragen an diese Adresse bearbeitet werden:

RouteTable.Routes.Add("Customers", new Route("customer/", new PageRouteHandler("~/Customers/Customers.aspx")));
RouteTable.Routes.Add("CustomerDetails", new Route("customer/{id}", new PageRouteHandler("~/Customers/CustomerDetails.aspx")));

Dies erstellt zwei Einträge in der Routing Tabelle. Der zweite Eintrag verwendet einen Parameter “id”, wenn also ein Request in der Form “customer/42″ eintrifft, wird dieser Eintrag verwendet.

Zu beachten ist, dass beim Eintreffen eines Requests diese Routing Tabelle von oben nach unten abgearbeitet wird, und der erste zur Request Adresse passende Eintrag verwendet wird. Nachfolgende Einträge werden ignoriert.

Nun muss der PageRouteHandler angelegt werden, welcher diese Anfragen bearbeiten kann. Dies ist eine Klasse, welche das IRouteHandler Interface implementiert:

public class PageRouteHandler : IRouteHandler
{
    private readonly string _virtualPath;

    public PageRouteHandler(string virtualPath)
    {
        _virtualPath = virtualPath;
    }

    public IHttpHandler GetHttpHandler(RequestContext requestContext)
    {
       var page = BuildManager.CreateInstanceFromVirtualPath(_virtualPath, typeof(Page));
       return (IHttpHandler)page;
    }
}

Dies ist bereits alles, was benötigt wird, um eigene Routen zu definieren und an Webforms weiterzuleiten. Jedoch gelangt im zweiten Fall, wenn eine ID übergeben wird, diese nicht bis zum Webform. Dies kann gelöst werden, indem innerhalb des Routing Handlers die Routing Daten des RequestContext an das Webform weitergeleitet werden. Die Methode GetHttpHandler sieht also wie folgt aus:

public IHttpHandler GetHttpHandler(RequestContext requestContext)
{
    var page = BuildManager.CreateInstanceFromVirtualPath(_virtualPath, typeof(Page));

    var queryString = new StringBuilder("?");
    foreach (var rdv in requestContext.RouteData.Values)
    {
        queryString.Append(requestContext.HttpContext.Server.UrlEncode(rdv.Key));
        queryString.Append("=");
        queryString.Append(requestContext.HttpContext.Server.UrlEncode(rdv.Value.ToString()));
        queryString.Append("&");
    }
    queryString.Remove(queryString.Length - 1, 1);

    HttpContext.Current.RewritePath(string.Concat(_virtualPath, queryString));

    return (IHttpHandler)page;
}

Das Markup für eine solche Dropdown Liste wird wie folgt definiert:

<select id="GameConsole" name="GameConsole">
 <option value="">Select your favorite...</option>
 <optgroup label="Microsoft">
   <option value="1">XBox</option>
   <option value="2">XBox 360</option>
 </optgroup>
 <optgroup label="Nintendo">
   <option value="3">Wii</option>
   <option value="4">Gameboy</option>
 </optgroup>
 <optgroup label="Sega">
   <option value="5">Dreamcast</option>
 </optgroup>
 <optgroup label="Sony">
   <option value="6">Playstation</option>
   <option value="7">Playstation 2</option>
   <option value="8">Playstation 3</option>
   <option value="9">PSP</option>
 </optgroup>
</select>

Ich habe eine neue HTML Helper Komponente DropDownListEx in meine Library etcetera.Mvc aufgenommen. Diese unterstützt das eben beschriebene Tag.

etcetera.Mvc DropDownListEx

Dazu habe ich auch eine Hilfsklasse OptionGroupSelectList erstellt, welche eine ähnliche Aufgabe wie die SelectList erfüllt. Die DropDownListEx erwartet im Konstruktor eine solche OptionGroupSelectList. Diese kann vom Controller wie folgt erstellt werden:

GameConsoleViewModel gcvm = new GameConsoleViewModel();
gcvm.GameConsoles = new OptionGroupSelectList<GameConsole>(gameConsoles,
                                                           x => x.Id,
                                                           x => x.Name,
                                                           x => x.Manufacturer.Name);
ViewData.Model = gcvm;

Die drei Lambda Expressions geben die jeweiligen Properties des Aufzählungstyps für das Wert und Namensfeld der Optionen, sowie das Label der Option Group an.

Im View kann der HTML Helper wie folgt aufgerufen werden:

<%= Html.DropDownListEx("GameConsole", Model.GameConsoles, "Select your favorite...") %>

Ich habe noch keinen Release erstellt, die Komponente ist bislang nur als Source Code verfügbar. Ich werde aber bald einen Release erstellen, welcher auch noch weitere Komponenten enthalten wird.

In meinen MVC Projekten habe ich nach anfänglichen Rumspielen mit jQuery Plugins für tabellarische Daten ausschliesslich das MvcContrib Grid verwendet, habe aber bald begonnen, dieses so zu erweitern, dass auch AJAX basiertes Paging und ein Sortieren der Spalten in einem HTML Helper gekapselt wurden.
Das ganze hat sich zu einer kleinen Library gemausert, die ich nun auf CodePlex als Open Source Projekt veröffentlicht habe. Das Projekt nennt sich etcetera.Mvc und ist in einer ersten Version 0.1 verfügbar.

Momentan sind drei UI Komponenten enthalten:

Grid

etcetera.Mvc Grid

Das Grid basiert auf demjenigen von MvcContrib. Dazu gehört eine separate und flexibel konfigurierbare Toolbar, welche für das Paging eingesetzt werden kann. Das Grid verwendet den selben Syntax wie MvcContrib undfügt folgendes hinzu:

• Effizientes asynchrones Paging via AJAX ohne eine einzige Zeile eigenem JavaScript
• Falls der Client kein JavaScript unterstützt, werden regulare Seiten Requests ausgeführt.
• Sortierbare Spalten
• Optionaler Grid Header welcher das Grid ein- und ausfahren kann
• Toolbar für das Paging, mit Anzeige und direkter Wahl der Seitennummer
• Die Toolbar kann einfach und beliebig auch mit eigenen Buttons erweitert werden
• Konfigurierbarer Export der Grid Daten nach Excel
• Alle Labels und Tooltips können selber definiert werden

Das Grid enthält ein jQuery Plugin, die Beispiel Icons und Stylesheets des Screenshots.

Kalender

etcetera.Mvc Calendar

Der Kalender zeigt eine Monatsansicht und unterstützt die Anzeige von Einträgen wie Meetings. Die Kalender Datenstrukturen sind komplett unabhängig von eigenen Projekten. Der Kalender unterstützt folgende Einstellungen:

• Den Wochentag, an dem die Woche beginnt. In den USA ist dies z.B. der Sonntag.
• Anzeige der Tage des Vor- und Folgemonats
• Highlighting des aktuellen Tags
• Komplette Kontrolle über die Links zu Einträgen oder Daten

Wie die anderen UI Komponenten lässt sich das Aussehen komplett über Stylesheets definieren.

Progressbar

etcetera.Mvc Progressbar

Die Progressbar ist ein sehr simples Element. Ich habe es hauptsächlich dafür benötigt, um die Progressbar von jQuery-UI zu ersetzen.

Weitere Komponenten und Framework Erweiterungen werden folgen.

Ein sehr praktisches Feature der klassischen Webforms ist das Security Trimming, also das Anzeigen von rollenbasierten Inhalten. Je nach Rolle, welche der eingeloggte Benutzer zugewiesen hat, werden ihm nur für diese Rolle passende Inhalte angezeigt. Das ganze Membership System der Webforms wird vom MVC Framework unterstützt. Auch das LoginView Control lässt sich im MVC Framework verwenden, da es keinen ViewState benötigt:

<asp:LoginView ID="LoginView1" runat="server">
  <AnonymousTemplate>I can be seen when the user is Anonymous.</AnonymousTemplate>
  <LoggedInTemplate>I can only be seen when a user without group membership is logged in.</LoggedInTemplate>
  <RoleGroups>
    <asp:RoleGroup Roles="Admin,User">
      <ContentTemplate>Only users with the "Admin" and "User" role can see this.</ContentTemplate>
    </asp:RoleGroup>
    <asp:RoleGroup Roles="Admin">
      <ContentTemplate>Only users with the "Admin" role can see this.</ContentTemplate>
    </asp:RoleGroup>
    <asp:RoleGroup Roles="User">
      <ContentTemplate>Only users with the "User" role can see this.</ContentTemplate>
    </asp:RoleGroup>
  </RoleGroups>
</asp:LoginView>

Zu beachten ist, dass die RoleGroups Templates der Reihe nach ausgewertet werden. Nur das erste zu einer Benutzerrolle passende Template wird angezeigt, die anderen nicht. Wenn sich also im Beispielprojekt ein Benutzer mit einer “User” Rolle einloggt, wird er nur das erste RoleGroup Template sehen.
Das LoggedInTemplate wird nur dann angezeigt, wenn kein RoleGroup Template zur Benutzerrolle passt.

Ich habe ein Beispielprojekt zusammengestellt, welches das LoginView Control im Einsatz zeigt. Das Projekt verwendet eine SQLite Datenbank und die SQLite Membership Provider von Roger Martin.

Download des Beispielprojekts: SecurityTrimming.zip