.NET 3.5 sp1(8) - Dynamic Data(动态数据)

介绍
以Northwind为示例数据库，演示Dynamic Data(动态数据)

• MetaModel - 数据库和域对象之间的映射的抽象
• MetaModel.RegisterContext() - 使用指定的配置上下文注册指定的数据上下文
• Scaffold - 译为基架。即基于数据库架构（linq to sql 或 entity framework）生成网页模板的机制
• ScaffoldTableAttribute(false) - 隐藏指定的表
• ScaffoldColumn(false) - 隐藏指定的字段
• MetadataTypeAttribute(Type metadataClassType) - 指定要与数据模型类关联的元数据类
• DynamicField - 显示指定的动态数据字段，相当于 BoundField
• DynamicControl - 通过指定的字段模板显示指定的动态数据字段

示例
全局配置
Global.asax
<%@ Application Language="C#" %>
<%@ Import Namespace="System.Web.Routing" %>
<%@ Import Namespace="System.Web.DynamicData" %>

<script runat="server">
    
    public static void RegisterRoutes(RouteCollection routes)
    {
        MetaModel model = new MetaModel();

        // MetaModel - 数据库和域对象之间的映射的抽象
        // MetaModel.RegisterContext(Type contextType, ContextConfiguration configuration) - 使用指定的配置上下文注册指定的数据上下文
        //     contextType - 数据模型中所定义的数据上下文类型
        //     configuration - 相关的配置。其 ScaffoldAllTables 属性为是否要启用基架，基架就是基于数据库架构（linq to sql 或 entity framework）生成网页模板的机制
        model.RegisterContext(typeof(VS2008SP1.Business.NorthwindEntities), new ContextConfiguration() { ScaffoldAllTables = true });

        // 下面的语句支持分页模式，在这种模式下，“列表”、“详细”、“插入”
        // 和“更新”任务是使用不同页执行的。若要启用此模式，请取消注释下面
        // 的 route 定义，并注释掉后面的合并页模式部分中的 route 定义。
        routes.Add(new DynamicDataRoute("{table}/{action}.aspx")
        {
            Constraints = new RouteValueDictionary(new { action = "List|Details|Edit|Insert" }),
            Model = model
        });

        // 下面的语句支持合并页模式，在这种模式下，“列表”、“详细”、“插入”
        // 和“更新”任务是使用同一页执行的。若要启用此模式，请取消注释下面
        // 的 routes，并注释掉上面的分页模式部分中的 route 定义。
        // routes.Add(new DynamicDataRoute("{table}/ListDetails.aspx") {
        //     Action = PageAction.List,
        //     ViewName = "ListDetails",
        //     Model = model
        // });

        // routes.Add(new DynamicDataRoute("{table}/ListDetails.aspx") {
        //     Action = PageAction.Details,
        //     ViewName = "ListDetails",
        //     Model = model
        // });
    }

    void Application_Start(object sender, EventArgs e)
    {
        RegisterRoutes(RouteTable.Routes);
    }

</script>



1、数据驱动的 Web 应用程序
详见源代码中的DynamicDataSite项目。动态数据的目录结构详见MSDN
Scaffold.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using System.ComponentModel.DataAnnotations;
using System.ComponentModel;

namespace VS2008SP1.Business
{
    /**//*
     * Scaffold - 译为基架。即基于数据库架构（linq to sql 或 entity framework）生成网页模板的机制
     * ScaffoldTableAttribute(false) - 隐藏指定的表
     * ScaffoldColumn(false) - 隐藏指定的字段
     * MetadataTypeAttribute(Type metadataClassType) - 指定要与数据模型类关联的元数据类
     */

    [ScaffoldTable(false)]
    public partial class Region
    {
        // Region 表不会被路由（显示）
    }

    [MetadataType(typeof(Customers_Metadata))]
    public partial class Customers
    {
        // 将 Customers 的元数据关联到 Customers_Metadata
    }

    public class Customers_Metadata
    {
        [ScaffoldColumn(false)]
        public object Phone;

        // Phone 不会在 Customers 表中被显示
    }
}

Validation.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using System.ComponentModel.DataAnnotations;
using System.ComponentModel;

namespace VS2008SP1.Business
{
    [MetadataType(typeof(Products_Metadata))]
    public partial class Products
    {
        // entity framework 会自动生成类似 OnFieldChanging() 的部分方法
        // 如果想做字段的自定义输入验证，则可以重写此方法
        partial void OnUnitPriceChanging(global::System.Nullable<decimal> value)
        {
            if (value > 1000)
            {
                throw new ValidationException("UnitPrice 不能大于 1000");
            }
        }
    }

    public class Products_Metadata
    {
        // [DataType(DataType.EmailAddress)] // 指定要与数据字段关联的附加类型的名称
        // [DisplayFormat()] // 格式化输出
        // [Range()] // 指定字段的范围约束
        // [RegularExpression()] // 正则表达式验证
        // [StringLength()] // 字段的字符长度验证
        [Required()] // 必填
        [UIHint("MyDecimal")] // 使用名为 MyDecimal 的字段模板
        public object UnitPrice;

        [DisplayName("产品名称")] // 指定的字段所显示的名称。在动态数据中，查看 Products 表，其 header 将显示为 产品名称
        [StartsWith("webabcd", ErrorMessage = "{0} 必须以 {1} 开头")] // 应用自定义 ValidationAttribute
        public object ProductName { get; set; }

    }


    // 编写一个自定义 ValidationAttribute，验证指定字段是否是以指定的字符串开头
    [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field, AllowMultiple = false)]
    sealed public class StartsWithAttribute : ValidationAttribute
    {
        readonly string _param;

        /**//// <summary>
        /// 构造函数
        /// </summary>
        /// <param name="param">指定的开头字符串</param>
        public StartsWithAttribute(string param)
        {
            _param = param;
        }

        /**//// <summary>
        /// 是否通过验证
        /// </summary>
        /// <param name="value">输入值</param>
        /// <returns></returns>
        public override bool IsValid(object value)
        {
            return ((string)value).ToLower().StartsWith(this._param.ToLower());
        }

        /**//// <summary>
        /// 格式化错误信息
        /// </summary>
        /// <param name="name">指定的字段名</param>
        /// <returns></returns>
        public override string FormatErrorMessage(string name)
        {
            return string.Format(ErrorMessageString, name, this._param);
        }
    }
}


2、以 Products 表为例，演示动态数据的应用
MyProducts.aspx
<%@ Page Language="C#" MasterPageFile="~/Site.master" CodeFile="MyProducts.aspx.cs"
    Inherits="MyProducts" Title="以 Products 表为例，演示动态数据的应用" %>

<%@ Register Assembly="System.Web.Entity, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
    Namespace="System.Web.UI.WebControls" TagPrefix="asp" %>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
    <asp:DynamicDataManager ID="DynamicDataManager1" runat="server" AutoLoadForeignKeys="true" />
    <h2>
        以 Products 表为例，演示动态数据的应用</h2>
    <asp:FormView ID="FormView1" runat="server" DataSourceID="FormDataSource" AllowPaging="True"
        DataKeyNames="ProductId">
        <ItemTemplate>
            <table>
                <tr>
                    <td>
                        ProductId:
                    </td>
                    <td>
                        <!--DynamicField - 显示指定的动态数据字段，相当于 BoundField-->
                        <!--DynamicControl - 通过指定的字段模板显示指定的动态数据字段-->
                        <asp:DynamicControl ID="ProductId" runat="server" DataField="ProductId" />
                    </td>
                </tr>
                <tr>
                    <td>
                        ProductName:
                    </td>
                    <td>
                        <asp:DynamicControl ID="ProductName" runat="server" DataField="ProductName" />
                    </td>
                </tr>
                <tr>
                    <td>
                        UnitPrice:
                    </td>
                    <td>
                        <asp:DynamicControl ID="UnitPrice" runat="server" DataField="UnitPrice" />
                    </td>
                </tr>
                <tr>
                    <td colspan="2">
                        <asp:LinkButton ID="InsertButton" runat="server" CommandName="New" CausesValidation="false"
                            Text="New" />
                        <asp:LinkButton ID="EditButton" runat="server" CommandName="Edit" CausesValidation="false"
                            Text="Edit" />
                        <asp:LinkButton ID="DeleteButton" runat="server" CommandName="Delete" CausesValidation="false"
                            Text="Delete" />
                    </td>
                </tr>
            </table>
        </ItemTemplate>
        <EditItemTemplate>
            <table>
                <tr>
                    <td>
                        ProductId:
                    </td>
                    <td>
                        <asp:DynamicControl ID="ProductId" runat="server" DataField="ProductId" Mode="ReadOnly" />
                    </td>
                </tr>
                <tr>
                    <td>
                        ProductName:
                    </td>
                    <td>
                        <!--
                            UIHint - 指定字段模板，此例的字段模板会以黄色背景显示数据
                            Mode - 设置呈现模式 [System.Web.UI.WebControls.DataBoundControlMode 枚举] 
                                DataBoundControlMode.ReadOnly - 只读模式。默认值
                                DataBoundControlMode.Edit - 编辑模式
                                DataBoundControlMode.Insert - 插入模式
                        -->
                        <asp:DynamicControl ID="ProductName" runat="server" DataField="ProductName" Mode="Edit"
                            UIHint="YelloText" />
                    </td>
                </tr>
                <tr>
                    <td>
                        UnitPrice:
                    </td>
                    <td>
                        <asp:DynamicControl ID="UnitPrice" runat="server" DataField="UnitPrice" Mode="Edit" />
                    </td>
                </tr>
                <tr>
                    <td colspan="2">
                        <asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update">Update</asp:LinkButton>
                        <asp:LinkButton ID="CancelEditButton" runat="server" CommandName="Cancel" CausesValidation="false">Cancel</asp:LinkButton>
                    </td>
                </tr>
            </table>
        </EditItemTemplate>
        <InsertItemTemplate>
            <table>
                <tr>
                    <td>
                        ProductName:
                    </td>
                    <td>
                        <asp:DynamicControl ID="ProductName" runat="server" DataField="ProductName" Mode="Insert" />
                    </td>
                </tr>
                <tr>
                    <td colspan="2">
                        <asp:LinkButton ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
                        <asp:LinkButton ID="CancelInsertButton" runat="server" CommandName="Cancel" CausesValidation="false"
                            Text="Cancel" />
                    </td>
                </tr>
            </table>
        </InsertItemTemplate>
        <PagerSettings Position="Bottom" Mode="NumericFirstLast" />
    </asp:FormView>
    <asp:EntityDataSource ID="FormDataSource" runat="server" ConnectionString="name=NorthwindEntities"
        DefaultContainerName="NorthwindEntities" EntitySetName="Products" ContextTypeName="VS2008SP1.Business.NorthwindEntities"
        EnableInsert="True" EnableUpdate="True" EnableDelete="True">
    </asp:EntityDataSource>
</asp:Content>

[源码下载]