数据源控件如何为数据绑定字段创建参数
当数据绑定控件（如
传递给数据源控件的字典
数据绑定控件从数据源控件请求操作时，会传递一个或多个包含参数名称和值的
使用以下 IDictionary 集合传递名称/值对：
-
Values 集合 为插入操作传递。包含新记录的名称/值对。Values 集合的字段名称和值来自于
-
Keys 集合 为更新和删除操作传递。包含正被更新或删除的记录的主键或键。如果可在数据源对键字段进行修改，则 Keys 集合还会包含键字段的原始值。如果使用数据源控件中的数据对数据绑定控件进行填充，则在视图状态中维护该数据。在请求更新或删除操作时，Keys 集合由之前中视图状态中存储的值填充。如果数据绑定控件的
-
NewValues 集合 为更新操作传递。包含具有更新项新值的名称/值对，其中包括可更新的键字段的新值。NewValues 集合的字段名称和值来自于 EditItemTemplate 中的子控件，或 DetailsView 控件（其
-
OldValues 集合 为更新或删除操作传递。包含要用于开放式并发检查的数据记录的原始值。（有关开放式并发检查的信息，请参见所用数据源控件的 ConflictDetection 属性。）OldValues 集合中不包含由 DataKeyNames 属性标识的键字段的值。键字段名称和值仅包含在 Keys 集合中。如果使用数据源控件中的数据对数据绑定控件进行填充，则在视图状态中维护该数据。在请求更新或删除操作时，将使用之前在视图状态中存储的值填充 OldValues 集合。如果数据绑定控件的 EnableViewState 属性设置为 false，则不会为更新或删除操作填充 OldValues 集合。
可以使用数据绑定控件事件为所请求的操作传递的参数访问所有这些集合。例如，在 GridView 控件的
参数名称
数据源控件会自动为 IDictionary 集合中传递的值创建参数。对于插入操作，数据源控件会使用 Values 集合内的名称/值对中的值填充其 InsertParameters 集合。对于更新操作，数据源控件会使用 Keys、NewValues 和 OldValues 集合内的名称/值对中的值填充其 UpdateParameters 集合。对于删除操作，数据源控件会使用 Keys 和 OldValues 集合内的名称/值对中的值填充其 DeleteParameters 集合。
默认情况下，不填充 OldValues 集合。仅在数据源控件的 ConflictDetection 属性设置为
对于更新或删除操作，默认情况下，只创建当前绑定值的参数。如果需要访问当前和原始绑定值（如必须支持开放式并发检查的情形），可以让数据源控件同时为当前值和原始值创建参数。为此，必须为将包含原始值的参数建立命名约定。这些原始值的参数的格式由 OldValuesParameterFormatString 属性确定。将 OldValuesParameterFormatString 属性设置为一个字符串。该字符串包含的“{0}”是该字段名称的占位符。例如，如果您正在使用
LastModifiedDate 的字段执行更新操作。该字段的当前值传递到 Values 字典中，而该字段的原始值传递到 OldValues 字典中。此时，将会创建名为 @LastModifiedDate 参数，用来传递当前值，同时会创建名为 @old_LastModifiedDate 参数，用来传递原始值。此后，可以将这两个参数都包括在 SQL 语句中，以便区别该字段的当前值和原始值，如以下示例所示：
| 复制代码 | |
|---|---|
UPDATE Table1 SET LastModifiedDate = @LastModifiedDate
WHERE Key = @Key AND LastModifiedDate = @old_LastModifiedDate |
|
不必直接访问名称/值 IDictionary 集合。可以简单地在 SQL 语句中包含自动生成的参数名称（如果数据源支持命名参数），或是使用
也可以选择定义数据源控件的 UpdateParameters、InsertParameters 或 DeleteParameters 集合中的
下面的代码示例演示一个绑定到 SqlDataSource 控件的 DetailsView 控件。SqlDataSource 控件的
| C# | 复制代码 |
|---|---|
<%@ Page language="C#" %>
<script RunAt="server">
void EmployeesDropDownList_OnSelectedIndexChanged(Object sender, EventArgs e)
{
EmployeeDetailsView.DataBind();
}
void EmployeeDetailsView_ItemUpdated(Object sender, DetailsViewUpdatedEventArgs e)
{
EmployeesDropDownList.DataBind();
EmployeesDropDownList.SelectedValue = e.Keys["EmployeeID"].ToString();
EmployeeDetailsView.DataBind();
}
void EmployeeDetailsView_ItemDeleted(Object sender, DetailsViewDeletedEventArgs e)
{
EmployeesDropDownList.DataBind();
}
void EmployeeDetailsSqlDataSource_OnInserted(Object sender, SqlDataSourceStatusEventArgs e)
{
System.Data.Common.DbCommand command = e.Command;
EmployeesDropDownList.DataBind();
EmployeesDropDownList.SelectedValue =
command.Parameters["@EmpID"].Value.ToString();
EmployeeDetailsView.DataBind();
}
</script>
<html>
<body>
<form RunAt="server">
<h3>Northwind Employees</h3>
<table cellspacing="10">
<tr>
<td valign="top">
<asp:DropDownList ID="EmployeesDropDownList"
DataSourceID="EmployeesSqlDataSource"
DataValueField="EmployeeID"
DataTextField="FullName"
AutoPostBack="True"
Size="10"
OnSelectedIndexChanged="EmployeesDropDownList_OnSelectedIndexChanged"
RunAt="Server" />
</td>
<td valign="top">
<asp:DetailsView ID="EmployeeDetailsView"
DataSourceID="EmployeeDetailsSqlDataSource"
AutoGenerateRows="false"
AutoGenerateInsertbutton="true"
AutoGenerateEditbutton="true"
AutoGenerateDeletebutton="true"
DataKeyNames="EmployeeID"
Gridlines="Both"
OnItemUpdated="EmployeeDetailsView_ItemUpdated"
OnItemDeleted="EmployeeDetailsView_ItemDeleted"
RunAt="server">
<HeaderStyle backcolor="Navy"
forecolor="White"/>
<RowStyle backcolor="White"/>
<AlternatingRowStyle backcolor="LightGray"/>
<EditRowStyle backcolor="LightCyan"/>
<Fields>
<asp:BoundField DataField="EmployeeID" HeaderText="Employee ID" InsertVisible="False" ReadOnly="true"/>
<asp:BoundField DataField="FirstName" HeaderText="First Name"/>
<asp:BoundField DataField="LastName" HeaderText="Last Name"/>
<asp:BoundField DataField="Address" HeaderText="Address"/>
<asp:BoundField DataField="City" HeaderText="City"/>
<asp:BoundField DataField="Region" HeaderText="Region"/>
<asp:BoundField DataField="PostalCode" HeaderText="Postal Code"/>
</Fields>
</asp:DetailsView>
</td>
</tr>
</table>
<asp:SqlDataSource ID="EmployeesSqlDataSource"
SelectCommand="SELECT EmployeeID, LastName + ', ' + FirstName AS FullName FROM Employees"
Connectionstring="<%$ ConnectionStrings:NorthwindConnection %>"
RunAt="server">
</asp:SqlDataSource>
<asp:SqlDataSource ID="EmployeeDetailsSqlDataSource"
SelectCommand="SELECT EmployeeID, LastName, FirstName, Address, City, Region, PostalCode
FROM Employees WHERE EmployeeID = @EmpID"
InsertCommand="INSERT INTO Employees(LastName, FirstName, Address, City, Region, PostalCode)
VALUES (@LastName, @FirstName, @Address, @City, @Region, @PostalCode);
SELECT @EmpID = SCOPE_IDENTITY()"
UpdateCommand="UPDATE Employees SET LastName=@LastName, FirstName=@FirstName, Address=@Address,
City=@City, Region=@Region, PostalCode=@PostalCode
WHERE EmployeeID=@EmployeeID"
DeleteCommand="DELETE Employees WHERE EmployeeID=@EmployeeID"
ConnectionString="<%$ ConnectionStrings:NorthwindConnection %>"
OnInserted="EmployeeDetailsSqlDataSource_OnInserted"
RunAt="server">
<SelectParameters>
<asp:ControlParameter ControlID="EmployeesDropDownList" PropertyName="SelectedValue"
Name="EmpID" Type="Int32" DefaultValue="0" />
</SelectParameters>
<InsertParameters>
<asp:Parameter Name="LastName" Type="String" />
<asp:Parameter Name="FirstName" Type="String" />
<asp:Parameter Name="Address" Type="String" />
<asp:Parameter Name="City" Type="String" />
<asp:Parameter Name="Region" Type="String" />
<asp:Parameter Name="PostalCode" Type="String" />
<asp:Parameter Name="EmpID" Direction="Output" Type="Int32" DefaultValue="0" />
</InsertParameters>
<UpdateParameters>
<asp:Parameter Name="LastName" Type="String" />
<asp:Parameter Name="FirstName" Type="String" />
<asp:Parameter Name="Address" Type="String" />
<asp:Parameter Name="City" Type="String" />
<asp:Parameter Name="Region" Type="String" />
<asp:Parameter Name="PostalCode" Type="String" />
<asp:Parameter Name="EmployeeID" Type="Int32" DefaultValue="0" />
</UpdateParameters>
<DeleteParameters>
<asp:Parameter Name="EmployeeID" Type="Int32" DefaultValue="0" />
</DeleteParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
|
|