TemplateField.AlternatingItemTemplate Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает шаблон для отображения в объекте TemplateField элемента, претерпевающего изменения.
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.IDataItemContainer), 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.IDataItemContainer), System.ComponentModel.BindingDirection.TwoWay)>]
member this.AlternatingItemTemplate : System.Web.UI.ITemplate with get, setPublic Overridable Property AlternatingItemTemplate As ITemplateЗначение свойства
Реализованный объект ITemplate, содержащий шаблон для отображения изменяющихся элементов TemplateField. Значение по умолчанию — "null", указывающее, что это свойство не задано.
- Атрибуты
Примеры
В следующем примере кода показано, как использовать AlternatingItemTemplate свойство для создания пользовательского шаблона для чередующихся элементов в столбце TemplateFieldGridView поля элемента управления . Шаблон — это разновидность шаблона, заданного свойством ItemTemplate , где изображение отображается на противоположной стороне ячейки.
<%@ 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 runat="server">
<title>TemplateField AlternatingItemTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TemplateField AlternatingItemTemplate Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Create a TemplateField field column that has both -->
<!-- an item template and an alternating item template. -->
<!-- The item template displays an author's image on the -->
<!-- left side of the column, while the alternating item -->
<!-- template displays an author's image on the right side. -->
<!-- For this example, the zip field is used for the -->
<!-- values of the image URL. For your application, you -->
<!-- should use a field that contains valid URLs to -->
<!-- images. -->
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="False"
runat="server">
<columns>
<asp:templatefield headertext="Author">
<itemtemplate>
<asp:image id="LeftAuthorImage"
imageurl='<%# Eval("zip") %>'
alternatetext="Author Photo"
runat="server"/>
<asp:label id="LeftFirstNameLabel"
text= '<%# Eval("au_fname") %>'
runat="server"/>
<asp:label id="LeftLastNameLabel"
text= '<%# Eval("au_lname") %>'
runat="server"/>
</itemtemplate>
<alternatingitemtemplate>
<asp:label id="RightFirstNameLabel"
text= '<%# Eval("au_fname") %>'
runat="server"/>
<asp:label id="RightLastNameLabel"
text= '<%# Eval("au_lname") %>'
runat="server"/>
<asp:image id="RightAuthorImage"
imageurl='<%# Eval("zip") %>'
alternatetext="Author Photo"
runat="server"/>
</alternatingitemtemplate>
</asp:templatefield>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [zip] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</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 runat="server">
<title>TemplateField AlternatingItemTemplate Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TemplateField AlternatingItemTemplate Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Create a TemplateField field column that has both -->
<!-- an item template and an alternating item template. -->
<!-- The item template displays an author's image on the -->
<!-- left side of the column, while the alternating item -->
<!-- template displays an author's image on the right side. -->
<!-- For this example, the zip field is used for the -->
<!-- values of the image URL. For your application, you -->
<!-- should use a field that contains valid URLs to -->
<!-- images. -->
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="False"
runat="server">
<columns>
<asp:templatefield headertext="Author">
<itemtemplate>
<asp:image id="LeftAuthorImage"
imageurl='<%# Eval("zip") %>'
alternatetext="Author Photo"
runat="server"/>
<asp:label id="LeftFirstNameLabel"
text= '<%# Eval("au_fname") %>'
runat="server"/>
<asp:label id="LeftLastNameLabel"
text= '<%# Eval("au_lname") %>'
runat="server"/>
</itemtemplate>
<alternatingitemtemplate>
<asp:label id="RightFirstNameLabel"
text= '<%# Eval("au_fname") %>'
runat="server"/>
<asp:label id="RightLastNameLabel"
text= '<%# Eval("au_lname") %>'
runat="server"/>
<asp:image id="RightAuthorImage"
imageurl='<%# Eval("zip") %>'
alternatetext="Author Photo"
runat="server"/>
</alternatingitemtemplate>
</asp:templatefield>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [zip] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Комментарии
Используйте свойство , AlternatingItemTemplate чтобы указать пользовательское содержимое, отображаемое для чередующихся элементов в объекте TemplateField . Определите содержимое, создав шаблон, указывающий способ отрисовки чередующихся элементов.
Примечание
Свойство AlternatingItemTemplate обычно используется в сочетании со свойством ItemTemplate , чтобы создать другой внешний вид для каждого другого элемента в элементе управления с привязкой к данным.
Чтобы указать шаблон, сначала поместите открывающие и закрывающие <AlternatingItemTemplate> теги между открывающим и закрывающим тегами <TemplateField> элемента. Затем добавьте пользовательское содержимое между открывающим и закрывающим <AlternatingItemTemplate> тегами. Содержимое может быть простым, как обычный текст или более сложным (например, внедрение других элементов управления в шаблон).
Чтобы программно получить доступ к элементу управления, определенному в шаблоне, сначала определите, какой TableCell объект в элементе управления с привязкой к данным содержит элемент управления. Затем используйте коллекцию Controls объекта для TableCell доступа к элементу управления . Для поиска элемента управления можно также использовать FindControl метод TableCell объекта , если в элементе ID управления указано свойство .
