ASP.NET 2.0高级数据处理之冲突检测

 

天马星空&华夏物语

生活之于生活意义在于对生活的平实和意义的选择

 

主页博客相册|个人档案

 

查看文章

   

ASP.NET 2.0高级数据处理之冲突检测

2006-12-22 20:27

在默认情况下，SqlDataSource和ObjectDataSource会忽略OldValues字段，只使用Keys和Values

　　你可以处理Select、Update、Insert、Delete和Filter的事件，以验证并处理传递给这些操作的参数值。为了达到这个目标，数据绑定的控件和数据源控件都暴露了适当的事件。例如，在GridView的Updating事件中，你就可以看到Keys、NewValues和OldValues字典中的参数名称和值，而它们将会被传递到数据源。在数据源一端，你可以处理SqlDataSource的Updating事件，看到这些应用到下层命令对象的参数，而这些命令将会执行以完成相关操作。类似的，你可以处理ObjectDataSource的Updating事件来查看或改变参数字典，而这些字典将用于分析UpdateMethod的适当操作。你可以使用这些事件来增加或删除字典或命令的参数、改变它们的值、或者简单地验证参数的输入格式是否正确。

　　请注意：你尤其需要验证Filtering事件的参数输入，因为在它应用到相关的DataView对象的FilterExpression（过滤器表达式）之前不会获得SQL编码（encoded）。

　　下面的示例演示了处理多个数据控件的事件来枚举那些通过事件参数传递的参数集合。请注意，这个示例把与OrderID主键字段相关联的绑定字段的InsertVisible属性设置为假，这是因为在下层数据库中OrderID是一个标识列，不应该传递给Insert操作（当插入发生的时候数据库自动地增加这个值）。同时请注意，在DataKeyNames中，OrderID字段被标记为主键，因此这个字段的原始值保留在数据绑定控件所传递的Keys字典中。用户输入控件的值都传递进NewValues字典（除了那些标记了ReadOnly=false的字段）。非键字段的原始值由数据绑定控件保留在OldValues字典中，以供传递给数据源。这些参数值都被SqlDataSource按照NewValues、Keys和OldValues的次序附加到命令上，尽管在默认情况下，当ConflictDetection被设置为OverwriteChanges的时候，数据源不会附加OldValues。你可以在后面的"使用冲突检测"部分看到数据源是如何使用OldValues的。

＜script runat="server"＞
Protected Sub EnumerateDictionary(ByVal dictionary As System.Collections.Specialized.IOrderedDictionary)
　Dim entry As DictionaryEntry
　For Each entry In dictionary
　　Response.Write(" ＜b＞" & Server.HtmlEncode(entry.Key) & "＜/b＞=" & Server.HtmlEncode(entry.Value) & " (" & Server.HtmlEncode(entry.Value.GetType().Name) & ")＜br /＞")
　Next
End Sub

Protected Sub EnumerateCommandParameters(ByVal command As System.Data.Common.DbCommand)
　Response.Write("＜br/＞Parameter order in data source...＜br /＞")
　Dim param As System.Data.Common.DbParameter
　For Each param In command.Parameters
　　Response.Write(" ＜b＞" & Server.HtmlEncode(param.ParameterName) & "＜/b＞=" & Server.HtmlEncode(param.Value) & " (" & Server.HtmlEncode(param.Value.GetType().Name) & ")＜br /＞")
　Next
End Sub

Protected Sub DetailsView1_ItemUpdating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.DetailsViewUpdateEventArgs)
　Response.Write("＜br/＞New Values passed from DetailsView...＜br /＞")
　EnumerateDictionary(e.NewValues) 
　Response.Write("＜br/＞Keys passed from DetailsView...＜br /＞")
　EnumerateDictionary(e.Keys)
　
　Response.Write("＜br/＞Old Values passed from DetailsView...＜br /＞")
　EnumerateDictionary(e.OldValues)
End Sub

Protected Sub SqlDataSource1_Updating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.SqlDataSourceCommandEventArgs)
　EnumerateCommandParameters(e.Command)
　e.Cancel = True
　Response.Write("＜br/＞Update canceled")
End Sub
　　你可以通过向数据源使用的参数集合添加静态的Parameter对象来改变SqlDataSource附加到命令上的参数次序。SqlDataSource会根据这些参数对象的次序来重新排列数据绑定控件所传递的参数。当数据源的ProviderName属性被设置为System.Data.OleDb的时候，这种操作就有用处了，这是由于它不支持命名（named）参数，因此附加到命令上的参数的次序必须与命令中的匿名参数占位符（'?'）的次序相匹配。当我们使用命名参数的时候，参数的次序就是无关紧要的。你可以指定Parameter对象的Type属性，确保在执行命令或方法之前，强制数据绑定控件传递的值被转换为适当的数据类型。同样地，你还可以设置Parameter的Size属性，规定SqlDataSource命令中DbParameter的位数大小（必须用于输入/输出、输出和返回值参数）。

＜asp:SqlDataSource ConnectionString="＜%$ ConnectionStrings:NorthwindOLEDB %＞" ID="SqlDataSource1" ProviderName="＜%$ ConnectionStrings:NorthwindOLEDB.ProviderName %＞" runat="server" SelectCommand="SELECT TOP 10 [OrderID], [OrderDate], [ShipCountry] FROM [Orders]" UpdateCommand="UPDATE [Orders] SET [OrderDate] = ?, [ShipCountry] = ? WHERE [OrderID] = ?" OnUpdating="SqlDataSource1_Updating"＞
＜UpdateParameters＞
　＜asp:Parameter Name="OrderDate" Type="DateTime" /＞
　＜asp:Parameter Name="ShipCountry" Type="String" /＞
　＜asp:Parameter Name="OrderID" Type="Int32" /＞
＜/UpdateParameters＞
＜/asp:SqlDataSource＞
参数命名习惯要求新值根据数据源Select操作所选定的字段来命名。我们也可以通过指定OldValuesParameterFormatString属性（例如指定为"original_{0}"）对Keys或OldValues中的参数进行重命名，以便于把它们和NewValues参数区分开来。你还可以通过处理适当的事件，在数据源操作执行之前改变参数的值，从而自定义参数名称。例如，如果SqlDataSource的更新操作与一个存储过程关联，而该存储过程使用的参数名称与默认的命名习惯不同，那么你就可以在该存储过程被调用之前，在SqlDataSource的Updating事件修改参数名称。下面的例子演示了这种技术。

Protected Sub SqlDataSource1_Updating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.SqlDataSourceCommandEventArgs)
　e.Command.Parameters("@id").Value = e.Command.Parameters("@ContactID").Value
　e.Command.Parameters("@name").Value = e.Command.Parameters("@ContactName").Value
　e.Command.Parameters.Remove(e.Command.Parameters("@ContactID"))
　e.Command.Parameters.Remove(e.Command.Parameters("@ContactName"))
End Sub

＜asp:SqlDataSource ConnectionString="＜%$ ConnectionStrings:Contacts %＞" ID="SqlDataSource1" runat="server" SelectCommand="SELECT [ContactID], [ContactName] FROM [Contacts]" UpdateCommand="UpdateContactName" UpdateCommandType="StoredProcedure" OnUpdating="SqlDataSource1_Updating"＞
＜UpdateParameters＞
　＜asp:Parameter Name="id" Type="Int32" /＞
　＜asp:Parameter Name="name" Type="String" /＞
＜/UpdateParameters＞
＜/asp:SqlDataSource＞
　　ObjectDataSource不依赖特定的参数次序，而是简单地查找与参数名称相匹配的方法。请注意，ObjectDataSource不使用参数的类型或大小来分析方法重载，它仅仅匹配参数名称，因此，如果你的业务对象中的两个方法拥有相同的名称和参数名称，但是参数类型不同，ObjectDataSource是无法把它们区分开的。你可以在事件中改变ObjectDataSource参数的名称和值，这点与上面的SqlDataSource示例类似。但是，如果你使用DataObjectTypeName给Update、Insert和Delete操作指定一个特殊的数据对象类型，就不可以修改参数名称了--只能修改值。如果你需要修改参数名称，就不要使用DataObjectTypeName，只能用代码在数据源事件中手动地构造适当的数据对象。

　　上面我们用到的所有数据源参数都是Input参数，用于把值传递到数据源操作中。参数可以是双向的，例如InputOutput、Output和ReturnValue参数。你可以使用参数对象的Direction属性来指定参数的方向。如果需要在数据源操作完成之后检索这些参数的值，就需要处理适当的操作后（post-operation）事件（例如Selected、Updated、Inserted或Deleted事件），从传递到这些事件的事件参数中获取参数值。SqlDataSourceStatusEventArgs拥有Command属性，你可以使用它来获取返回值和输出参数，如下面的例子所示。请注意，对于双向参数来说，把SqlDataSource中的Parameter对象的Size属性设置为适当的值是非常重要的。

＜asp:SqlDataSource ID="SqlDataSource1" ……＞
＜SelectParameters＞
　＜asp:Parameter Direction="Output" Name="TimeStamp" Type="DateTime" /＞
　＜asp:Parameter Direction="ReturnValue" Name="ReturnValue" Type="Int32" /＞
＜/SelectParameters＞
＜/asp:SqlDataSource＞
　　为了实现这个目标，ObjectDataSourceStatusEventArgs类型支持OutputParameters集合和ReturnValue属性，如下面一个例子所示。请注意，在这种情况下，Update操作的返回值是用于检测操作所影响的行数的。

Protected Sub ObjectDataSource1_Selected(ByVal sender As Object, ByVal e As ObjectDataSourceStatusEventArgs)
　Response.Write("Record Count: " & Server.HtmlEncode(e.OutputParameters("totalCount")))
End Sub

Protected Sub ObjectDataSource1_Updated(ByVal sender As Object, ByVal e As ObjectDataSourceStatusEventArgs)
　Response.Write("Rows Affected: " & Server.HtmlEncode(e.ReturnValue) & "＜br/＞")
End Sub

＜asp:ObjectDataSource ID="ObjectDataSource1" ……＞
　＜UpdateParameters＞
　　＜asp:Parameter Name="ContactName" Type="String" /＞
　＜/UpdateParameters＞
　＜SelectParameters＞
　　＜asp:Parameter Direction="Output" Name="totalCount" Type="Int32" /＞
　＜/SelectParameters＞
＜/asp:ObjectDataSource＞
　　输出参数的另一种通常的用途是检索插入数据库的行的主键值，而该主键列是一个标识列（在这种情况下，在插入操作的参数中没有指定键值，该键值是在插入操作发生时，数据库服务器自动生成的）。下面的例子演示了这种技术。

Protected Sub SqlDataSource1_Inserted(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.SqlDataSourceStatusEventArgs)
　Response.Write("Record Inserted: " & Server.HtmlEncode(e.Command.Parameters("@ContactID").Value) & "＜br/＞")
End Sub

＜asp:SqlDataSource ID="SqlDataSource1" ……＞
　……
　＜InsertParameters＞
　　＜asp:Parameter Name="contactName" Type="String" /＞
　　＜asp:Parameter Direction="Output" Name="contactID" Type="Int32" /＞
　＜/InsertParameters＞
＜/asp:SqlDataSource＞ ，数据绑定控件把传递给数据源的值存放在相互独立的Keys、Values（新值）和 OldValues字典中。在默认情况下，SqlDataSource和ObjectDataSource会忽略OldValues字段，只使用Keys和Values。这种行为是由数据源的ConflictDetection属性检测的，在默认情况下这个属性的值被设置为OverwriteChanges。OverwriteChanges模式意味着"为了更新或删除记录，仅仅匹配主键值"。这种操作意味着，记录的更新或删除是不考虑该记录的下层值是否改变过了。在通常情况下，理想的状态是，只有当数据行的值与最初选择的值完全匹配的时候，才让Update或Delete操作成功。在这种理想情况下，如果另外一个用户在你选择某一行和更新该行的之间也更新了这一行，你的更新操作就会失败。通过把ConflictDetection属性设置为CompareAllValues，数据源也支持这种操作。在这种模式下，数据源会把OldValues应用到命令或方法上，它会使用这些值来确保在更新或删除记录之前，更新或删除操作必须与记录的所有值都匹配。你还必须把OldValuesParameterFormatString属性设置为一个有效的.NET框架组件格式化字符串（例如"original_{0}"），来指明OldValues和Keys字典中的参数如何重新命名以便与NewValues参数区分开来。

　　下面的代码示例显示了SqlDataSource控件在OverwriteChanges和CompareAllValues模式下使用的典型的SQL命令。ID字段被假定为主键字段。请注意，后面一个命令在WHERE子句中比较数据行的所有原始值，而不是仅仅比较主键。在这种情况下，数据源的OldValuesParameterFormatString需要被设置为"original_{0}"。
　前面我们提到，数据绑定控件把传递给数据源的值存放在相互独立的Keys、Values（新值）和 OldValues字典中。在默认情况下，SqlDataSource和ObjectDataSource会忽略OldValues字段，只使用Keys和Values。这种行为是由数据源的ConflictDetection属性检测的，在默认情况下这个属性的值被设置为OverwriteChanges。OverwriteChanges模式意味着"为了更新或删除记录，仅仅匹配主键值"。这种操作意味着，记录的更新或删除是不考虑该记录的下层值是否改变过了。在通常情况下，理想的状态是，只有当数据行的值与最初选择的值完全匹配的时候，才让Update或Delete操作成功。在这种理想情况下，如果另外一个用户在你选择某一行和更新该行的之间也更新了这一行，你的更新操作就会失败。通过把ConflictDetection属性设置为CompareAllValues，数据源也支持这种操作。在这种模式下，数据源会把OldValues应用到命令或方法上，它会使用这些值来确保在更新或删除记录之前，更新或删除操作必须与记录的所有值都匹配。你还必须把OldValuesParameterFormatString属性设置为一个有效的.NET框架组件格式化字符串（例如"original_{0}"），来指明OldValues和Keys字典中的参数如何重新命名以便与NewValues参数区分开来。

　　下面的代码示例显示了SqlDataSource控件在OverwriteChanges和CompareAllValues模式下使用的典型的SQL命令。ID字段被假定为主键字段。请注意，后面一个命令在WHERE子句中比较数据行的所有原始值，而不是仅仅比较主键。在这种情况下，数据源的OldValuesParameterFormatString需要被设置为"original_{0}"。


SELECT [ID], [Name], [Address] from [Contacts] 
-- OverwriteChanges
UPDATE [Contacts] SET [Name] = @Name, [Address] = @Address WHERE [ID] = @ID
DELETE FROM [Contacts] WHERE [ID] = @ID

-- CompareAllValues
UPDATE [Contacts] SET [Name] = @Name, [Address] = @Address WHERE [ID] = @original_ID 
AND [Name] = @original_Name AND [Address] = @original_Address
DELETE FROM [Contacts] WHERE [ID] = @original_ID AND [Name] = @original_Name 
AND [Address] = @original_Address

　请注意，Insert操作不需要OldValues，ConflictDetection只对Update和Delete操作有意义。

　　下面的例子演示了冲突发生时的行为。为了运行这个例子，你必须在两个独立的浏览器窗口中打开例子的两个实例（两次点击"Run Sample"）。接着在两个窗体的同一行上都点击"Edit"按钮，使该行进入编辑模式。在第一个窗口中改变一个值并点击"Update"，请注意这个更新是成功的。在第二个窗口中，在该行中输入一个新值并点击"Update"，这个更新操作没有成功，因为下层数据行的值已经被第一个更新操作改变过了。这个示例检测了Updated或Deleted事件参数的AffectedRows属性，它为0确认了冲突发生了。

＜script runat="server"＞
Protected Sub SqlDataSource1_Updated(sender As Object, e As SqlDataSourceStatusEventArgs)
　If e.AffectedRows = 0 Then
　　Response.Write("Row changed, update aborted＜br /＞")
　End If
End Sub

Protected Sub SqlDataSource1_Deleted(sender As Object, e As SqlDataSourceStatusEventArgs)
　If e.AffectedRows = 0 Then
　　Response.Write("Row changed, delete aborted＜br /＞")
　End If
End Sub
＜/script＞

　　当Update或Delete使用模板化UI的时候，使用了Bind语法的双向（two-way）数据绑定字段的旧值都会被保留。对于Delete来说，这意味着在ItemTemplate中你必须给数据绑定的值使用Bind语法，其目的是为了保留删除操作所需要的旧值。下面的例子演示了这种技术。

＜asp:GridView ……＞
　＜Columns＞
　　＜asp:CommandField ShowDeleteButton="True" ShowEditButton="True" /＞
　　＜asp:TemplateField HeaderText="ContactID" InsertVisible="False" SortExpression="ContactID"＞
　　　＜ItemTemplate＞
　　　　＜asp:Label ID="Label1" runat="server" Text='＜%# Bind("ContactID") %＞'＞＜/asp:Label＞
　　　＜/ItemTemplate＞
　　　＜EditItemTemplate＞
　　　　＜asp:Label ID="Label3" runat="server" Text='＜%# Eval("ContactID") %＞'＞＜/asp:Label＞
　　　＜/EditItemTemplate＞ 
　　＜/asp:TemplateField＞
　　＜asp:TemplateField HeaderText="ContactName" SortExpression="ContactName"＞
　　　＜ItemTemplate＞
　　　　＜asp:Label ID="Label2" runat="server" Text='＜%# Bind("ContactName") %＞'＞＜/asp:Label＞
　　　＜/ItemTemplate＞
　　　＜EditItemTemplate＞
　　　　＜asp:TextBox ID="TextBox1" runat="server" Text='＜%# Bind("ContactName") %＞'＞＜/asp:TextBox＞
　　　＜/EditItemTemplate＞
　　＜/asp:TemplateField＞
　＜/Columns＞
＜/asp:GridView＞

你可以温和地处理冲突检测错误，可以通过提示用户下层数据被改变了，向用户显示改变过的值， 让用户选择提交或放弃自己的操作。下面的例子演示处理冲突检测的一种可行方法。请注意，DetailsView的RowUpdated事件参数传递了可用于检测用户输入的值的字典。你还可以设置这个事件参数的KeepInEditMode属性，使用户在决定如何处理冲突期间，DetailsView处于编辑模式。这个例子所试验方法与上面一个例子类似，同时打开两个窗口来创建冲突更新。

Protected Sub DetailsView1_ItemUpdated(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.DetailsViewUpdatedEventArgs)
　If e.AffectedRows = 0 Then
　　' 使DetailsView处于编辑模式并与数据库同步
　　e.KeepInEditMode = True
　　DetailsView1.DataBind()
　
　　' 用用户输入的值重新填充DetailsView
　　Dim t As TextBox
　　t = DetailsView1.Rows(1).Cells(1).Controls(0)
　　t.Text = e.NewValues("OrderDate")
　　t = DetailsView1.Rows(2).Cells(1).Controls(0)
　　t.Text = e.NewValues("ShipCountry")

　　ErrorPanel.Visible = True
　Else
　　ErrorPanel.Visible = False
　End If
End Sub

Protected Sub DetailsView1_ModeChanging(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.DetailsViewModeEventArgs)
　If e.CancelingEdit = True AndAlso ErrorPanel.Visible = True Then
　　ErrorPanel.Visible = False
　End If
End Sub
　　使用ObjectDataSource的时候，情况也类似。请注意，由于数据源的ConflictDetection属性被设置为CompareAllValues，数据源将查找一个可接受Contact对象的每个字段的原始值的UpdateContact重载。

　　你还可以同时使用DataObjectTypeName属性和CompareAllValues。在这种情况下，ObjectDataSource查找仅接受两个参数（都是Contact）的UpdateContact重载。第一个参数是存放新值的Contact对象，第二个参数是存放旧值的Contact对象