传统ADO.NET的情况下使用ObjectDataSource使得我们可以使用任何数据源作为底层进行CRUD的操作,简单易行。不过ObjectDataSource用的不好往往调试起来很困难(当然这是微软控件封装了太好的缘故:-))。在常见的此类数据源控件出错中,最最常见切频繁出现的就是“XXXDataSource未能找到带参数的……”一类红色的提示。如何解决此类问题呢?
俗话说得好——工欲善其事,必先利其器——我们就从提示入手,仔细研究揣摩ObjectDataSource究竟是如何映射ObjectDataSource的Update方法参数的。
方便期间,我们先创建一个工程(我目前用VS2011 Beta),其中包含一个静态类,用于模拟从数据库中读取的数据资料,以及一个更新方法,大体上代码如下:
[C#]
/// <summary>
/// 实体类
/// </summary>
public class Product
{
public int Id{get;set;}
public string Name{get;set;}
}
public static class DataSourceFile
{
static List<Product> _products = null;
//第一次加载,就初始化仅一次
static DataSourceFile()
{
_products = new List<Product>();
for (int i = 1; i < 11; i++)
{
_products.Add(new Product { Id = i, Name = "Product" + i});
}
}
/// <summary>
/// 选出全部记录的静态方法
/// </summary>
public static IList<Product> GetAllProducts()
{
return _products;
}
public static void UpdateProducts(int Id,string Name)
{
Product up= _products.Find(pro => pro.Id == Id);
up.Name = Name;
}
}
[VB.NET]
''' <summary>
''' 实体类
''' </summary>
Public Class Product
Public Property Id() As Integer
Get
Return m_Id
End Get
Set
m_Id = Value
End Set
End Property
Private m_Id As Integer
Public Property Name() As String
Get
Return m_Name
End Get
Set
m_Name = Value
End Set
End Property
Private m_Name As String
End Class
Public NotInheritable Class DataSourceFile
Private Sub New()
End Sub
Shared _products As List(Of Product) = Nothing
'第一次加载,就初始化仅一次
Shared Sub New()
_products = New List(Of Product)()
For i As Integer = 1 To 10
_products.Add(New Product() With { _
Key .Id = i, _
Key .Name = "Product" & i _
})
Next
End Sub
''' <summary>
''' 选出全部记录的静态方法
''' </summary>
Public Shared Function GetAllProducts() As IList(Of Product)
Return _products
End Function
Public Shared Sub UpdateProducts(Id As Integer,Name As String)
Dim up As Product = _products.Find(Function(pro) pro.Id = Id)
up.Name = Name
End Sub
End Class
对应的aspx代码生成如下:
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="False"
DataSourceID="ProductObjectDataSource" EnableModelValidation="True">
<Columns>
<asp:CommandField ShowEditButton="True" ShowDeleteButton="True" />
<asp:BoundField DataField="Id" HeaderText="Id" SortExpression="Id" ReadOnly=true />
<asp:BoundField DataField="Name" HeaderText="Name" SortExpression="Name" />
</Columns>
</asp:GridView>
<asp:ObjectDataSource ID="ProductObjectDataSource" runat="server" SelectMethod="GetAllProducts"
TypeName="WebCSharp.DataSourceFile"
UpdateMethod="UpdateProducts">
</asp:ObjectDataSource>
这是最简单的情况,假设现在Id是主键(自然只读不允许修改)的情况下,我们在UpdateProducts这里设置断点,然后F5调试,我们便可以发现p已经填充了更新后的数据,但是Id不会发生变化(回传原来的Id),因此可以进行更新。
不过这里提醒大家注意一点:当把objectDataSource绑定到GridView上的时候,默认生成的<asp:ObjectDataSource……>这里边应该还包括了<UpdateParameters>……</UpdateParameters>一节,其中生成的内容与UpdateProducts参数类型、名称完全一致。这很容给大多数读者造成误会——似乎更新以后的数据就是通过这些Parameters进行传递的,如果你这样认为,那就大错特错了!其实,UpdateParameters只是用于定义额外需要的更新字段,并非是数据模型自身。换句话说,如果你定义了一个UpdateParameter,那么对应的UpdateMethod必须拥有这一个额外的字段(包括类型也必须匹配)!而数据表模型自身的字段即便不定义(当然定义了也无所谓),也会自动传递到UpdateMethod,和其中的参数一一匹配(参数顺序并不重要)。
下面给一个例子进行严格证明(其它地方不变,我只多定义一个UpdateParameter):
<asp:ObjectDataSource ID="ProductObjectDataSource" runat="server" SelectMethod="GetAllProducts"
TypeName="WebCSharp.DataSourceFile"
UpdateMethod="UpdateProducts">
<UpdateParameters>
<asp:Parameter Name="s" Type="string" />
</UpdateParameters>
</asp:ObjectDataSource>
因为多定义了一个参数为string类型的s,因此在对应的UpdateMethod中必然也要有所映射,所以UpdateMethod必须写成:
[C#]
public static void UpdateProducts(int Id,string Name,string s)
{
………………
}
[VB.NET]
Public Shared Sub UpdateProducts(Id As Integer, Name As String, s As String)
…………
End Sub
此时,如果你没有定义s,那么就会引发我说指出的上面错误。
因此我们可以先这样总结:Update方法的参数必须包含由Select语句或者是模型类中的各个公共属性字段作为参数,同时还要包含UpdateParameters中额外定义的参数。更进一步地——如果ObjectDataSource设置了ConflictDection和OldValuesParameterFormatString,那么Update方法必须同时包含这两类参数名称和类型。
Delete方法:未设置“冲突检测”之时,必须指定DataKeyNames(主键作为删除的依据)以及对应的参数名和类型,设置了“冲突检测”之后,则只需指定全部的OldParameterValueFormation的格式化参数名称以及类型即可。
如果上面一个示例使用了“冲突检测”机制,那么Update方法必然要加入OldValuesparameterFormatString(假设设置为old_{0},那么参数就还要多出“int old_Id”、“string old_Name”)。
说了那么半天,你大概感悟颇多,不过同时觉得把字段作为参数一个个写未免有些太过于麻烦。下面我们来介绍一种更为直接的方法——模型实体映射:
所谓“模型实体映射”就是说参数不再是一个个独立的参数那么离散,而是统一扔给一个模型做处理,这样,我们直接就针对类对象处理,而不是一个个单独离散的数据啦(PS:毕竟OOP嘛!)
模型映射分两种情况:
第I型:自映射——
所谓自映射,就是人工无需写任何的代码,直接把一个模型类取代先前的参数即可。那么一开始的例子就直接可以这样表示:
[C#]
public static void UpdateProducts(Product p)
{
Product up= _products.Find(pro => pro.Id == p.Id);
up.Name = p.Name;
}
[VB.NET]
Public Shared Sub UpdateProducts(p As Product)
Dim up As Product = _products.Find(Function(pro) pro.Id = p.Id)
up.Name = p.Name
End Sub
和第一次的例子一样,因为p包含了Id和Name,也被自动映射了。
不过这里注意:如果使用了冲突检测机制,则不能使用此方法(即便为Product定义了OldParameterValueFormation);你只能老老实实定义参数哦!
第II型:自定义实体模型映射:
在第I型的例子中和先前所有的例子中,我们的Id都假设是不改变的。但是现在我们撤去这个理想化的条件,让Id也可以改变,那么如何更新呢?显然,使用只用一个Product只能获取更新后的数据,而我们需要更新前的数据作为参考才可以借助更新前的旧Id来更新旧Id对应的那个模型实体的数据。
你可以选择使用参数化的方式(一个个定义参数),同时设置objectDataSource的ConflictDection和OldParameterValueFormat进行更新。如果我们需要你用OOP的方式呢?也就是定义类似这样的一个Update方法——其中包含一个旧的Product实体和新一个Product实体数据,这样我们直接从List中找到符合条件的旧实体数据,然后逐一把新的值赋给他。
怎么做呢?如果我们直接这样定义:
[C#]
public static void UpdateProducts(OldProduct oldp,Product p)
[VB.NET]
Public Shared Sub UpdateProducts(oldp As OldProduct, p As Product)
显然无论是UpdateParameter或者是自动模型的I方法都无法识别,也会报出本篇抬头的那个错误。
要自定义更新参数,我们还必须了解究竟ObjectDataSource是如何自定义映射的。其实在做映射之前,ObjectDataSource将首先触发Updating事件,把映射的参数名称和对应的数值全部存入一个InputParameters的Dictionary中。因此如果要实现自定义的参数,我们只需在这个方法中逐个取出需要的参数值,并且使用Add方法包含全部UpdateMethod中的参数名称即可。
接着上面的定义,我们给出完整的代码:
[C#]
protected void ProductObjectDataSource_Updating(object sender, ObjectDataSourceMethodEventArgs e)
{
Product p = new Product() { Id = Convert.ToInt32(e.InputParameters["Id"]),Name=e.InputParameters["Name"].ToString() };
OldProduct oldp = new OldProduct() { old_Id = Convert.ToInt32(e.InputParameters["old_Id"]), old_Name = e.InputParameters["old_Name"].ToString() };
e.InputParameters.Clear();
e.InputParameters.Add("p", p); //Product类型,名称p(对应UpdateMethod方法"p"名称)
e.InputParameters.Add("oldp", oldp); //OldProduct类型,名称oldp(对应UpdateMethod方法"oldp"名称)
}
[VB.NET]
Protected Sub ProductObjectDataSource_Updating(sender As Object, e As ObjectDataSourceMethodEventArgs)
Dim p As New Product() With { _
Key .Id = Convert.ToInt32(e.InputParameters("Id")), _
Key .Name = e.InputParameters("Name").ToString() _
}
Dim oldp As New OldProduct() With { _
Key .old_Id = Convert.ToInt32(e.InputParameters("old_Id")), _
Key .old_Name = e.InputParameters("old_Name").ToString() _
}
e.InputParameters.Clear()
e.InputParameters.Add("p", p) 'Product类型,名称p(对应UpdateMethod方法"p"名称)
e.InputParameters.Add("oldp", oldp) 'OldProduct类型,名称oldp(对应UpdateMethod方法"oldp"名称)
End Sub