ASP.NET 3.5 Extensions: Dynamic Data Web Site 要點整理(转载)

前面的練習當 中,很多地方都是由專案範本、IDE、以及 Dynamic Data 框架幫我們處理掉,我們就只是用滑鼠拖拉幾下,再到 web.config 中設定一下屬性就完成了。即使做了練習,可能還會有一點知其然不知其所以然的感覺:為什麼這樣網站就可以 run 了?其中各個環節是怎麼串起來的?因此,這裡簡短地將前面練習過程中幾個要點整理一下,希望能讓 Dynamic Data Web Site 的拼圖更完整。

以下就分別針對建立 Dynamic Data Web Site 的過程,以及網頁客製化的部份分別整理其重點。

關於建立 Dynamic Data Web Site 的幾個重點

  • 若要迅速建立一個具備增刪改查的資料維護網站,可用 VS2008 直接 New 一個 Dynamic Data Web Site(當然你必須先安裝 ASP.NET 3.5 Extensions preview 版)。透過此方式建立的網站,主要是運用 Dynamic Data 的 scaffolding 功能。
  • Dynamic Data Web Site 專案範本會自動產生相關的樣板網頁及樣式,包括一個可瀏覽資料表清單的首頁(Default.aspx)。當然,它不會知道你想要處理哪些資料表,因此這 部份的空白須由你來填補。說得更明白些,就是要建立 Data Context 類別。Data Context 類別有點像是一個資料庫,裡面包含許多類別,而每個類別都是對應到實體資料庫中的一個資料表。
  • 建立 Data Context 類別的方法,是在專案中加入一個 LINQ to SQL class。若將它命名為 Foo.dbml,那麼除了產生 Foo.dbml(這是個 XML 檔案),還會產生 Foo.dbml.layout 以及 Foo.designer.cs,前者只存放設計檢視的畫面編排資訊,後者才包含真正的 Data Context 類別,而其類別名稱會是 FooDataContext。你從 Server Explorer 中拖到 .Foo.dbml 設計區域的那些資料表,IDE 都會幫你在 .designer.cs 中建立對應的類別。換句話說,IDE 和 Dynamic Data 框架自動幫你處理了物件/關聯對應(object-relation mapping)的繁瑣工作。
  • 當你瀏覽 Default.aspx 時,Dynamic Data 框架會去你指定的 Data Context 類別中取得資料表清單及其欄位資料。那麼如何告訴 Dynamic Data 框架該使用哪個 Data Context 類別?答案是 Web.config 裡面的 <dynamicData> 元素的 dataContextType 屬性。

網頁客製化

  • 維護資料表的樣板網頁放在 App_Shared\DynamicDataPages 目錄下,共有三個檔案:ListTemplate.aspx、DetailsTemplate.aspx、以及 ListDetailstemplate.aspx。當你在網站首頁(Default.aspx)點擊某個資料表連結,Dynamic Data 框架就會使用這些樣板來呈現資料表的欄位資料。
  • 若要客製化資料表維護網頁,可將上述的樣板網頁複製到網站根目錄下的特定資料夾,並將檔名中的 "Template" 去除。所謂的特定資料夾,指的是該資料夾名稱必須跟資料表名稱一樣。例如,想要自訂 Customers 資料表的維護頁面,就可以在網站根目錄下建立名為 Customers 的資料夾,然後將樣板檔複製到該資料夾下,再修改它們。從 web.config 中的 <dynamicData> 元素的 <mappings> 子元素的 patterns 屬性可看出資料夾命名的規則,以及其名稱與瀏覽網站時的 URI 有何關聯。
  • 你可以在自訂網頁中使用 <DynamicField> 標籤來定義該資料表維護頁面要有哪些欄位,以及各欄位的顯示樣式、欄位標題(HeaderText 屬性)、欄位的顯示/編輯控制項(RenderHint 屬性)。

自訂欄位驗證

  • ASP.NET 3.5 Extensions 內建三個欄位驗證特徵項 (validation attributes),可用來套用至特定欄位,它們是:RequiredAttributeRegexAttribute、以及 RangeAttribute
  • 套用欄位驗證特徵項的方法:先在 App_Code 資料夾中建立一個對應某 entity class 的 partial 類別(如第一篇的 Customer.cs),然後將驗證特徵項套用至類別。參考以下範例:

    using System.Web.DynamicData;

    [Required("CustomerID", ErrorMessage="客戶編號不可空白!")]

    public partial class Customer
    {
    }
     
  • 除了內建的驗證特徵項,開發人員也可以自訂其他驗證規則,做法是在自訂的 entity class 中「實作」On<FieldName>Changing 方法。這裡的「實作」須用到 partial methods 語法。參考以下範例:

    public partial class Customer
    {
        partial void OnCustomerIDChanging(string value)
        {
            if (String.IsNullOrEmpty(value))
            {
                throw new Exception("客戶編號不可空白!");
            }
        }
    }

自訂欄位顯示/編輯控制項

  • ASP.NET Dynamic Data 框架會根據欄位型態自動使用內建的控制項來顯示及編輯欄位值,例如:文字類型的欄位就會使用 TextBox。這些顯示/編輯欄位的控制項叫做「動態資料欄位」(dynamic data fields),它們都是 user controls。你可以在網站的 App_Shared\DynamicDataFields 資料夾中找到這些內建的動態資料欄位控制項。
  • 你也可以自行設計動態資料欄位控制項,以補內建動態資料欄位控制項之不足。作法是在 App_Shared\DynamicDataFields 資料夾上點右鍵,Add New Item,然後選擇 "Dynamic Data Field"。此方式會幫你產生兩個 user controls,一個用來顯示欄位值,一個用來編輯欄位值,而且它們都是 single file 的寫法(而非 code-behind 寫法)。
  • 動態資料欄位控制項必須繼承自父類別:System.Web.DynamicData.FieldTemplateUserControlBase
  • 設計好動態資料欄位控制項之後,可利用 RenderHint 屬性來指定某個欄位要用你自己撰寫的控制項來顯示和編輯,作法有兩種:
    (1) 在自訂網頁(如前例的 Customers\ListDetails.aspx)中指定 <DynamicField> 標籤的 RenderHint 屬性。如下所示:

    <asp:DynamicField DataField="OrderDate" HeaderText="訂單日期" RenderHint="CalendarDate" />

    (2) 在自訂 entity class 中套用 RenderHint 特徵項,如下所示:

    [RenderHint("OrderDate", "CalendarDate")]
    public partial class Order
    {
    }

    其中第一個參數是欄位名稱,第二個參數就是你的動態資料欄位控制項類別名稱。

 

OK! 有關 Dynamic Data Web site 的部分就先整理到這邊。

posted @ 2008-08-30 11:24 InFuture 阅读(...) 评论(...) 编辑 收藏