目錄

1.介紹

2.軟體環境

5.控制器擴充套件

1)資料實體

2)站點設定

3)站點檔案

介紹

“MVC網站教程”系列的目的是教你如何使用 ASP.NET MVC 建立一個基本的、可擴充套件的網站。

3)MVC網站教程（三）：動態佈局和站點管理（涉及技術：AJAX、jqGrid、Controller擴充套件、HTML Helpers等等）

系列的第一篇文章主要講解如何去建立一個支援多語言的MVC網站，同時也講解了使用者認證和註冊機制的實現。使用了微軟的Entity Framework框架和LINQ查詢技術。

系列的第二篇文章，提出了詳細的異常管理規則並在ASP.NET MVC網站中實現異常管理，還提供一些通用的日誌記錄和異常管理的原始碼。這些原始碼不僅可以在任何ASP.NET網站中被重用（或經過比較小的改動適用），而且可以重用到任何.NET專案中。

系列的第三篇文章（即本文），實現了動態佈局和站點管理，使用了AJAX、jqGrid、自定義操作結果、控制器擴充套件、HTML幫助器，還使用了一些通用的C#原始碼和javascript指令碼，這些都能被擴充套件和被重用到其它專案中。

“MVC網站教程”系列的示例網站是採用增量式和迭代式軟體過程開發的，這意味著系列中每一篇博文會在前一篇的解決方案中新增更多的功能，所以本文提供的示例下載只包含系列目前為止所介紹的功能。

網站的佈局通常包括標題頁首、選單和頁尾。注意,這些佈局對大多數網站都是不變的。

動態佈局，意思是網站管理員能通過網站應用程式提供的管理頁面修改網站的佈局。管理員的所有修改資料都會儲存在資料庫中，並且從此以後網站的佈局就會按照網站管理員的設定呈現。因此網站管理員能通過web瀏覽器在任何時候、任何地點改變網站的佈局。

本博文主要包含三個部分。第一部分描述網站中使用的構建塊；第二部分演示使用網站管理頁面來動態佈局；第三部分就如何擴充套件動態佈局給出一些提示。

網站的構建塊（如：自定義操作結果、控制器擴充套件、自定義HTML幫助器以及一些其他公用類，Razor檢視和Javascript指令碼等等）以及整個站點框架你可以重用和擴充套件成更復雜的網站。

軟體環境

1..NET 4.0 Framework

2.Visual Studio 2010 (or Express edition)

3.ASP.NET MVC 4.0

4.SQL Server 2008 R2 (or Express Edition version 10.50.2500.0)

在執行示例程式碼之前

在執行示例程式碼之前，你應該做下面事情：

1.首先使用“管理員身份”執行CreateEventLogEntry控制檯專案程式產生的exe，用來在事件日誌中建立“MVC Basic”事件源。（EventLog在寫日誌時會建立指定名稱的類別預設為“應用程式”的事件源。但是ASP.NET網站沒有足夠的許可權來建立事件源，需要本地桌面應用程式）

2.在你的SQL Server伺服器中建立一個名為MvcBasicSite的資料庫，然後用我提供的MvcBasicSiteDatabase.bak檔案進行資料庫還原。

3.修改MVC應用程式示例的Web.config配置檔案中的連結字串。

示例帳號

1)管理員帳戶：Administrator密碼：tm77dac

2)普通帳戶： Ana密碼：ana

本博文示例下載：

自定義操作結果和控制器擴充套件

在本節中，我將介紹自定義操作結果和控制器擴充套件，用於建立站點的動態佈局。

在控制器類中，響應使用者輸入的每個操作方法執行完工作後返回一個操作結果。操作結果代表MVC框架執行完一個操作指令。所有操作結果類必須繼承自ActionResult抽象類。這個抽象類包含下面成員：

public abstract class ActionResult
{
    // Summary:
    //     Initializes a new instance of the System.Web.Mvc.ActionResult class.
    protected ActionResult();

    // Summary:
    //     Enables processing of the result of an action method by a custom type that
    //     inherits from the System.Web.Mvc.ActionResult class.
    //
    // Parameters:
    //   context:
    //     The context in which the result is executed. The context information includes
    //     the controller, HTTP content, request context, and route data.
    public abstract void ExecuteResult(ControllerContext context);
}

這裡有一系列MVC4.0框架提供的操作結果，它們都直接或間接繼承自ActionResult抽象類：

1)ContentResult

2)EmptyResult

3)FileResult

4)FileContentResult

5)FilePathResult

6)FileStreamResult

7)HttpStatusCodeResult

8)HttpUnauthorizedResult

9)JavaScriptResult

10)JsonResult

11)RedirectResult

12)RedirectToRouteResult

13)PartialViewResult

14)ViewResultBase

15)ViewResult

為了建立動態佈局，我使用了一些上面已經存在的操作結果類，但我也建立下面兩個自定義操作結果類：

1)OpenFileResult

2)ImageResult

1.OpenFileResult

這個操作結果類被用於在新瀏覽器視窗中開啟一個檔案。在本網站示例中用於在獨立的瀏覽器視窗中開啟一個PDF、JPG或PNG檔案，同樣也能用於開啟其他型別的檔案。

從上面類圖可知，OpenFileResult包含3個屬性，被用於設定內容型別、檔名字和檔案存放的虛擬路徑。主要功能方法ExecuteResult()如下：

public override void ExecuteResult(ControllerContext context)
{
    context.HttpContext.Response.Clear();
    context.HttpContext.Response.ClearContent();
    //
    if(this.ContentType != null)
        context.HttpContext.Response.ContentType = ContentType;
    else
        context.HttpContext.Response.AddHeader("content-disposition", "attachment;filename=" + this.FileName);
    //
    context.HttpContext.Response.Cache.SetCacheability(System.Web.HttpCacheability.Public);
    string filePath = (_isLocal 
        ? this.FileName 
        : string.Format("{0}\\{1}", context.HttpContext.Server.MapPath(this.VirtualPath), this.FileName));
    //
    if (System.IO.File.Exists(filePath))
    {
        context.HttpContext.Response.TransmitFile(filePath);
    }
    else
    {
        context.HttpContext.Response.Write(Resources.Resource.OpenFileResultFileNotFound);
    }
    //
    context.HttpContext.Response.End();
}

從上面程式碼可知，這個方法首先設定內容型別，然後將檔案傳送到HTTP響應中，收到響應結果的瀏覽器將在新視窗中開啟一個檔案。

應該像下面例子一樣使用OpenFileResult：

public ActionResult GetFileResult(int id)
{
    SiteDocument SiteDocument = _db.SiteDocuments.FirstOrDefault(d => d.ID == id);
    if (SiteDocument == null)
        return RedirectToAction("Home", "Index");
    //
    OpenFileResult result = new OpenFileResult(
       SiteDocument.IsSystemDoc == null && this.Request.IsLocal, "\\Content\\Doc");
    result.FileName = SiteDocument.FileFullName;
    result.ContentType = SiteDocument.ContentType;
    //
    return result;
}

如果是PDF文件，那麼將在瀏覽器新視窗中開啟PDF。

2.ImageResult

這個操作結果類將圖片資料流在當前檢視中呈現一個圖片。這個資料流可能是從資料庫中載入的包含影象的資料流、也可能是從一個檔案中載入的包含影象的檔案流、或者其他地方傳入的資料流。

從上面類圖中可知，這個類包含兩個屬性用於設定內容型別和影象流，主要功能方法ExecuteResult()如下：

public override void ExecuteResult(ControllerContext context)
{
    if (context == null)
        throw new ArgumentNullException("context");
    //
    try
    {
        HttpResponseBase response = context.HttpContext.Response;
        response.ContentType = this.ContentType;
        //
        if (this.ImageStream == null)
        {
            string filePath = context.HttpContext.Server.MapPath("/Content/noimageSmall.jpg");
            System.Drawing.Image imageIn = System.Drawing.Image.FromFile(filePath);
            MemoryStream ms = new MemoryStream();
            //
            imageIn.Save(ms, System.Drawing.Imaging.ImageFormat.Jpeg);
            response.OutputStream.Write(ms.ToArray(), 0, (int)ms.Length);
        }
        else
        {
            byte[] buffer = new byte[4096];
            //
            while (true)
            {
                int read = this.ImageStream.Read(buffer, 0, buffer.Length);
                if (read == 0)
                    break;
                //
                response.OutputStream.Write(buffer, 0, read);
            }
        }
        //
        response.End();
    }
    catch (Exception ex)
    {
        MvcBasicLog.LogException(ex);
    }
}

從上面原始碼中可知，這個方法首先設定內容型別，然後讀取影象並存到資料流中，最後將資料流以位元組流的方式寫到HTTP響應輸出流中。在接收到響應的瀏覽器上會將圖片呈現到當前檢視中。

ImageResult操作結果的使用方法和上文提到的OpenFileResult相似，但是在MVC示例網站中我是直接作為控制器擴充套件（ControllerExtensions類）來使用的，詳細見下文。

相關推薦