ASP.NET2.0快速入门系列----模板中的数据绑定
模板化数据绑定控件提供在页中呈现数据的最大灵活性。您可以回想一下 ASP.NET 1.x 版中的几个模板化控件,如 DataList 和 Repeater 控件。ASP.NET 2.0 继续支持这些控件,但在此版本中,在模板中对控件进行数据绑定的方式已得到简化和改进。本部分讨论在数据绑定控件模板中进行数据绑定的各种方式。
数据绑定表达式
ASP.NET 2.0 改进了模板中的数据绑定,将数据绑定语法由完整的 v1.x 语法 DataBinder.Eval(Container.DataItem, fieldname) 简化为 Eval(fieldname)。与 DataBinder.Eval 一样,Eval 方法也接受一个可选的 formatString 参数。缩写的 Eval 语法与 DataBinder.Eval 的不同之处,在于 Eval 根据最近的容器对象(在上面的示例中为 DataListItem)的 DataItem 属性自动解析字段,而 DataBinder.Eval 接受该容器的一个参数。因此,Eval 仅在数据绑定控件的模板中使用,而不能在“页”级别使用。当然,ASP.NET 2.0 页继续支持 DataBinder.Eval,因此它可用于简化的 Eval 语法不受支持的场合。
<asp:DataList DataSourceID="ObjectDataSource1" runat="server"> <ItemTemplate> <asp:Image ImageUrl='<%# Eval("FileName", "images/thumbs/{0}") %>' runat="server"/> <asp:Label Text='<%# Eval("Caption") %>' runat="server"/> </ItemTemplate></asp:DataList>
下面的示例演示新的简化 Eval 数据绑定语法在 DataList ItemTemplate 中绑定 Image、Label 和 HyperLink 控件。
C# DataBinding in a DataList Template
数据绑定还可以包含为控件主题定义的一部分,这样,只需更改所应用的主题即可显著改变模板化控件的布局和外观。但在 Theme 模板中只能使用 Eval(或后面将讨论的 Bind)。不能随意绑定到用户代码。下一示例演示应用于上一示例为照片页创建完全不同外观的主题。有关主题的更多信息,请参考本教程的“应用样式、主题和外观”部分。
C# DataBinding in a DataList Template (Themed)
FormView 控件
DataList 控件循环访问数据源的每个数据项,为每一项输出一次 ItemTemplate。这对于呈现项列表十分有用,但通常需要根据窗体中的单个数据项进行数据绑定。因此,ASP.NET 2.0 引入了 FormView 控件,该控件在任意形式的模板中一次呈现单个数据项。DetailsView 和 FormView 之间的主要差异在于 DetailsView 具有内置的表格呈现方式,而 FormView 需要用户定义的模板用于呈现。FormView 和 DetailsView 对象模型在其他方面非常类似。下面的示例演示一个绑定到 ObjectDataSource 的 FormView 控件。与前面的 DataList 示例一样,FormView 的 ItemTemplate 属性包含数据绑定 Image、Label 和 HyperLink。
C# DataBinding in a FormView Template
和 DetailsView 相似,FormView 跟踪当前呈现的项,并可选择在数据源返回列表时支持对多个数据项进行分页。下面的示例演示一个启用了分页功能的 FormView。
C# DataBinding in a FormView Template (Paged)
双向数据绑定
与 DetailsView 控件一样,FormView 通过其关联的数据源控件支持自动 Update、Insert 和 Delete 操作。若要定义编辑或插入操作的输入 UI,可在定义 ItemTemplate 的同时定义 EditItemTemplate 或 InsertItemTemplate。在本模板中,您将对输入控件(如 TextBox、CheckBox 或 DropDownList)进行数据绑定,以绑定到数据源的字段。但是,这些模板中的数据绑定使用“双向”数据绑定语法,从而允许 FormView 从模板中提取输入控件的值,以便传递到数据源。这些数据绑定使用新的 Bind(fieldname) 语法而不是 Eval。
重要事项: 使用 Bind 语法进行数据绑定的控件必须设置有 ID 属性。
<asp:FormView DataSourceID="ObjectDataSource1" DataKeyNames="PhotoID" runat="server"> <EditItemTemplate> <asp:TextBox ID="CaptionTextBox" Text='<%# Bind("Caption") %>' runat="server"/> <asp:Button Text="Update" CommandName="Update" runat="server"/> <asp:Button Text="Cancel" CommandName="Cancel" runat="server"/> </EditItemTemplate> <ItemTemplate> <asp:Label Text='<%# Eval("Caption") %>' runat="server" /> <asp:Button Text="Edit" CommandName="Edit" runat="server"/> </ItemTemplate></asp:FormView>
在对 GridView 或 DetailsView 执行更新或插入操作时,如果该控件的列或字段定义了 BoundField,GridView 或 DetailsView 负责创建 Edit 或 Insert 模式中的输入 UI,以便它能自动提取这些输入值以传递回数据源。由于模板包含任意的用户定义的 UI 控件,因此,需要使用双向数据绑定语法,这样 FormView 等模板化控件才能知道应从模板中提取哪些控件值以用于更新、插入或删除操作。在 EditItemTemplate 中仍然可以使用 Eval 语法进行不传递回数据源的数据绑定。另请注意,FormView 与 DetailsView 和 GridView 一样,支持使用 DataKeyNames 属性保留主键字段(即使这些字段并未呈现)的原始值以传递回更新/插入操作。
FormView 支持使用 DefaultMode 属性指定要显示的默认模板,但在默认情况下,FormView 以 ReadOnly 模式启动并呈现 ItemTemplate。若要启用用于从 ReadOnly 模式转换为 Edit 或 Insert 模式的 UI,可以向模板添加一个 Button 控件,并将其 CommandName 属性设置为 Edit 或 New。可以在 EditItemTemplate 内添加 CommandName 设置为 Update 或 Cancel 的按钮,以用于提交或中止更新操作。类似地,也可以添加 CommandName 设置为 Insert 或 Cancel 的按钮,以用于提交或中止插入操作。
下面的示例演示一个定义了 ItemTemplate 和 EditItemTemplate 的 FormView。ItemTemplate 包含使用 Eval(单向)绑定的控件,而 EditItemTemplate 包含一个使用 Bind 语句双向绑定的 TextBox 控件。主键字段 (PhotoID) 是使用 DataKeyNames 属性在视图状态中进行往返的。FormView 包含用于在其模板之间进行切换的命令按钮。
C# Two-Way Databinding in a FormView Edit Template
通过使用添加到 Columns 或 Fields 集合的 TemplateField,GridView 和 DetailsView 还支持模板化 UI。TemplateField 支持使用 ItemTemplate、EditItemTemplate 和 InsertItemTemplate(仅 DetailsView)指定这些控件的不同呈现模式中的字段 UI。与上面的 FormView 示例一样,EditItemTemplate 或 InsertItemTemplate 中的双向绑定允许 GridView 或 DetailsView 从这些模板中的控件提取值。TemplateField 的常见用途是向 EditItemTemplate 添加验证程序控件,用于 GridView 或 DetailsView 操作的声明性验证。下面的示例演示这种方法的一个示例。有关 ASP.NET 中可用的验证控件的更多信息,请参考本教程的“验证窗体输入控件”部分。
C# Validation in a GridView Edit Template
TemplateField 的另一个用途是自定义输入控件,这种控件用于输入 GridView 或 DetailsView 列/字段值。例如,可以将 DropDownList 控件放在 TemplateField 的 EditItemTemplate 中,以允许从预定义的值列表进行选择。下面的示例演示这种方法。注意,本例中的 DropDownList 与它自己的数据源控件进行了数据绑定,以便动态地获取该列表的值。