這一周我們用 XML 來建置自己的選單。之所以走這條路,是因為不同角色會有不同的權限選單;這裡先略過權限讀取,單靠一份 XML 檔就做出動態選單。
在 Models 上按右鍵 → Add → New Item…

新增一個 Menu.cs 類別檔:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
namespace MVCMembership.Models
{
public class Menu
{
/// <summary>
/// 標題
/// </summary>
public string Title
{
get;
set;
}
/// <summary>
/// Action
/// </summary>
public string Action
{
get;
set;
}
/// <summary>
/// Controller
/// </summary>
public string Controller
{
get;
set;
}
public Menu()
{
}
public Menu(string strTitle, string strAction, string strController)
{
Title = strTitle;
Action = strAction;
Controller = strController;
}
}
}
在 Models 目錄下新增 menu.XML:
<?XML version="1.0" encoding="utf-8" ?>
<Menu>
<MenuItem Order="1" Action="Index" Controller="Home">
Home
</MenuItem>
<MenuItem Order="2" Action="About" Controller="Home">
About
</MenuItem>
<MenuItem Order="3" Action="New" Controller="XML">
XML
</MenuItem>
</Menu>
其中 Order 決定排序,Action 與 Controller 則對應點選後要導向的位置。
在 Views/Shared 下 Add → View

勾選「Create a partial view (.ascx)」與「Create a strongly-typed view」,並把 View data class 選為 MVCMembership.Models.Menu。
接著有個關鍵動作:把產生的
<%@ Control Language="C#" Inherits="System.Web.Mvc.VIEwUserControl<MVCMembership.Models.Menu>" %>
改成
<%@ Control Language="C#" Inherits="System.Web.Mvc.ViewUserControl<IEnumerable<MVCMembership.Models.Menu>>" %>
如此一來就實作了 IEnumerable 介面,可以用 foreach 遍歷。完整的控制項程式碼如下:
<%@ Control Language="C#" Inherits="System.Web.Mvc.ViewUserControl<IEnumerable<MVCMembership.Models.Menu>>" %>
<%@ OutputCache Duration="10000" VaryByParam="none" %>
<ul id="menu">
<% foreach(var menu in Model)
{ %>
<li>
<%= Html.ActionLink(menu.Title,menu.Action,menu.Controller)%>
</li>
<% } %>
</ul>
這裡用 foreach 把選單列表輸出成 <ul>/<li>,並加上 OutputCache 減少重複讀檔的負擔。
最後修改 site.master。先加一個函式負責讀取 XML:
<script runat="server" type="text/C#">
public MVCMembership.Models.Menu[] GetMenu()
{
List <MVCMembership.Models.Menu> menus=new List<MVCMembership.Models.Menu>();
if (Session["Menu"] == null)
{
XElement menuElement = XElement.Load(Server.MapPath(Url.Content("~/Models/Menu.XML")));
var m = from p in menuElement.Elements("MenuItem")
orderby p.Attribute("Order").Value
select p;
foreach (var mm in m)
{
MVCMembership.Models.Menu menu = new MVCMembership.Models.Menu();
menu.Title = mm.Value.Trim();
menu.Controller = mm.Attribute("Controller").Value.Trim();
menu.Action = mm.Attribute("Action").Value.Trim();
menus.Add(menu);
}
Session["Menu"] = menus.ToArray();
return (MVCMembership.Models.Menu[])Session["Menu"];
}
else
return (MVCMembership.Models.Menu[])Session["Menu"];
}
</script>
這裡用 Session["Menu"] 快取值,避免每次請求都重新解析 XML;日後若要依角色顯示不同選單,就在這段加上權限判斷即可。
接著在原本放選單的位置寫入:
<%Html.RenderPartial("~/VIEws/Shared/Menu.ascx",
(MVCMembership.Models.Menu [])GetMenu());%>
RenderPartial() 用來做局部渲染,達到 Ajax 式的部分更新效果。它其實只寫控制項名稱也能運作,但這裡刻意給出完整路徑,省下搜尋的時間、速度更快一點。
成品外觀和原本寫死的選單看起來一樣,差別在於這份選單是動態的——只要改動 Menu.XML,整站選單就跟著變,不必重新發行。