HowTo: ASP.NET MVC RenderAction mit Parametern

Es gibt unter den MVC Futures ein nettes Feature namens "RenderAction". Damit kann man aus dem View heraus eine Controller-Action aufrufen und das Ergebnis wird in den Output geschrieben. Für MVC Puristen ist dies zwar der Tod schlecht hin, aber das Feature ist sehr praktisch um kleine "Widgets" auf eine Webseite zu bringen.

Futures

Die ASP.NET MVC Futures findet man (mit Source Code) auf Codeplex. Ob dieses Feature auch so in MVC V2 Einzug halten wird, bleibt abzuwarten. Ich denke jedoch, dass irgendwas in dieser Art kommen wird. Und falls nicht: Dann bleibt man bei den Futures und durch den Zugriff auf den Source Code kann man da sich auch selber helfen :)

Nach dem Download der Datei bekommt man die Microsoft.Web.Mvc.dll.

Anwendung

Links zu sehen ist mein Demoprojekt. Wichtig ist eigentlich nur der HomeController und im Home - Viewordner die Index.aspx und die News.aspx.

Die News.aspx:
Hier liegt der HTML Code unseres "Widgets".

In der Index.aspx machen wir folgenden Aufruf:

     <% Html.RenderAction("News", "Home"); %>

Damit wird die "News" Actionmethod des "Home" Controller aufgerufen und das Ergebnis wird dort in den Output geschrieben:

public ActionResult News(int? count)
        {
            // Default Value
            int newsCount = 5;

            // Check if Parameter has value
            if(count.HasValue) {
                newsCount = count.Value;
            }

            // Prepare News
            List<string> newsEntry = new List<string>();

            for(int i = 0; i <= newsCount; i++)
            {
                newsEntry.Add("Test " + i);
            }

            ViewData["News"] = newsEntry;

            return View();
        }

Hier passiert keine große Magie: Ich habe einen "optionalen"/nullable Parameter. Wenn dieser nicht gesetzt ist, dann füge ich einfach 5 strings in mein ViewData["News"] und render nun die "News.aspx":

<%@ Page Language="C#" Inherits="System.Web.Mvc.ViewPage" %>

<%
  List<string> result = (List<string>)ViewData["News"];
      
  foreach (string item in result)
  { %>
    <%=item %>
<% } %>

Mit Parametern:

Natürlich kann ich beim Aufruf von RenderAction auch Parameter mitgeben:

    <% Html.RenderAction("News", "Home", new { count = 15 }); %>

Im letzten Abschnitt wird ein anonymer Typ mit dem Property "count" übergeben. Dies wird direkt auf den "count" Parameter gemappt.

Nachlesen:

Steve Sanderson hat in seinem Buch "Pro ASP.NET MVC Framework" den Mechanismus sehr gut beschrieben.

Ergebnis:

Um kleine "Komponenten" abzubilden finde ich dieses Werkzeug ideal.

[ Download Demoanwendung ]