ListView.AlternatingItemTemplate 属性
定义
public:
virtual property System::Web::UI::ITemplate ^ AlternatingItemTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ListViewDataItem), System.ComponentModel.BindingDirection.TwoWay)]
public virtual System.Web.UI.ITemplate AlternatingItemTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.ListViewDataItem), System.ComponentModel.BindingDirection.TwoWay)>]
member this.AlternatingItemTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property AlternatingItemTemplate As ITemplate
属性值
一个对象,包含 ListView 控件中交替数据项的自定义内容。An object that contains the custom content for the alternating data item in a ListView control. 默认值为 null,指示未设置此属性。The default is null, which indicates that this property is not set.
- 属性
示例
下面的示例演示如何使用 AlternatingItemTemplate 模板定义控件中交替数据项的样式 ListView 。The following example shows how to use the AlternatingItemTemplate template to define the style for alternating data items in a ListView control.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView AlternatingItemTemplate Example</title>
<style type="text/css">
body
{
font-size: 10pt;
font-family: Trebuchet MS, Arial, Tahoma;
text-align:center;
}
.item { background-color: #E0FFFF }
.alternatingItem { background-color: #B0E0E6 }
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView AlternatingItemTemplate Example</h3>
<asp:ListView ID="VendorsListView"
DataSourceID="VendorsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" id="tblVendors" runat="server">
<tr runat="server">
<th runat="server">ID</th>
<th runat="server">Account Number</th>
<th runat="server">Name</th>
<th runat="server">Preferred Vendor</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager ID="VendorsDataPager" runat="server" PageSize="15">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr class="item" runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' />
</td>
<td align="center">
<asp:CheckBox ID="PreferredCheckBox" runat="server" Enabled="False"
Checked='<%# Eval("PreferredVendorStatus") %>' />
</td>
</tr>
</ItemTemplate>
<AlternatingItemTemplate>
<tr class="alternatingItem" runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' />
</td>
<td align="center">
<asp:CheckBox ID="PreferredCheckBox" runat="server" Enabled="False"
Checked='<%# Eval("PreferredVendorStatus") %>' />
</td>
</tr>
</AlternatingItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="VendorsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT VendorID, AccountNumber, Name, PreferredVendorStatus
FROM Purchasing.Vendor WHERE (ActiveFlag = 1)" >
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ListView AlternatingItemTemplate Example</title>
<style type="text/css">
body
{
font-size: 10pt;
font-family: Trebuchet MS, Arial, Tahoma;
text-align:center;
}
.item { background-color: #E0FFFF }
.alternatingItem { background-color: #B0E0E6 }
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>ListView AlternatingItemTemplate Example</h3>
<asp:ListView ID="VendorsListView"
DataSourceID="VendorsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" id="tblVendors" runat="server">
<tr runat="server">
<th runat="server">ID</th>
<th runat="server">Account Number</th>
<th runat="server">Name</th>
<th runat="server">Preferred Vendor</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager ID="VendorsDataPager" runat="server" PageSize="15">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr class="item" runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' />
</td>
<td align="center">
<asp:CheckBox ID="PreferredCheckBox" runat="server" Enabled="False"
Checked='<%# Eval("PreferredVendorStatus") %>' />
</td>
</tr>
</ItemTemplate>
<AlternatingItemTemplate>
<tr class="alternatingItem" runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' />
</td>
<td align="center">
<asp:CheckBox ID="PreferredCheckBox" runat="server" Enabled="False"
Checked='<%# Eval("PreferredVendorStatus") %>' />
</td>
</tr>
</AlternatingItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="VendorsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT VendorID, AccountNumber, Name, PreferredVendorStatus
FROM Purchasing.Vendor WHERE (ActiveFlag = 1)" >
</asp:SqlDataSource>
</form>
</body>
</html>
注解
使用 AlternatingItemTemplate 属性可为交替数据项定义 (UI) 的自定义用户界面。Use the AlternatingItemTemplate property to define a custom user interface (UI) for the alternating data item. AlternatingItemTemplate模板通常包含与模板相同的控件和内容 ItemTemplate ,但具有不同的外观来区分项。The AlternatingItemTemplate template usually contains the same controls and content as the ItemTemplate template, but with a different appearance to distinguish items.
若要以声明的方式指定自定义模板,请在 AlternatingItemTemplate 控件内添加一个元素 ListView 。To specify the custom template declaratively, add an AlternatingItemTemplate element inside the ListView control. 然后在开始标记和结束标记之间添加控件和内容 <AlternatingItemTemplate> 。Then add controls and content between the opening and closing <AlternatingItemTemplate> tags. 若要显示数据源中的字段值,请使用数据绑定表达式。To display the field values from the data source, use a data-binding expression. 有关详细信息,请参阅 数据绑定表达式概述。For more information, see Data-Binding Expressions Overview.
若要创建自动选择、删除和编辑操作的按钮,请向模板添加一个按钮控件。To create buttons that automatically select, delete, and edit operations, add a button control to the template. 将其 CommandName 属性设置为下表中列出的值之一。Set its CommandName property to one of the values listed in the following table.
| 按钮类型Button type | CommandName 值CommandName value |
|---|---|
| 删除Delete | “Delete”"Delete" |
| 编辑Edit | 编辑"Edit" |
| 选择Select | “选择”"Select" |