TemplateField.AlternatingItemTemplate Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Vorlage zum Anzeigen der abwechselnden Elemente in einem TemplateField-Objekt ab oder legt diese fest.
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 ITemplateEigenschaftswert
Ein in ITemplate implementiertes Objekt, das die Vorlage zum Anzeigen der abwechselnden Elemente in TemplateField enthält. Der Standardwert ist null und gibt an, dass diese Eigenschaft nicht festgelegt ist.
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der AlternatingItemTemplate -Eigenschaft eine benutzerdefinierte Vorlage für die wechselnden Elemente in einer TemplateField Feldspalte eines GridView Steuerelements erstellen. Die Vorlage ist eine Variante der Vorlage, die durch die ItemTemplate -Eigenschaft angegeben wird, wobei ein Bild auf der gegenüberliegenden Seite der Zelle angezeigt wird.
<%@ 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>
Hinweise
Verwenden Sie die AlternatingItemTemplate -Eigenschaft, um den benutzerdefinierten Inhalt anzugeben, der für die wechselnden Elemente in einem TemplateField -Objekt angezeigt wird. Definieren Sie den Inhalt, indem Sie eine Vorlage erstellen, die angibt, wie die wechselnden Elemente gerendert werden.
Hinweis
Die AlternatingItemTemplate -Eigenschaft wird häufig in Kombination mit der ItemTemplate -Eigenschaft verwendet, um eine andere Darstellung für jedes andere Element im datengebundenen Steuerelement zu erstellen.
Um eine Vorlage anzugeben, platzieren Sie öffnende und schließende <AlternatingItemTemplate> Tags zuerst zwischen den öffnenden und schließenden Tags des <TemplateField> Elements. Fügen Sie als Nächstes den benutzerdefinierten Inhalt zwischen den öffnenden und schließenden <AlternatingItemTemplate> Tags hinzu. Der Inhalt kann so einfach wie nur-Text oder eine komplexere (Einbetten von anderen Steuerelementen in der Vorlage, z. B.) sein.
Um programmgesteuert auf ein in einer Vorlage definiertes Steuerelement zuzugreifen, bestimmen Sie zunächst, welches TableCell Objekt im datengebundenen Steuerelement das Steuerelement enthält. Verwenden Sie als Nächstes die Controls Auflistung des TableCell -Objekts, um auf das Steuerelement zuzugreifen. Können Sie auch die FindControl Methode der TableCell Objekt, das dem Steuerelement zu suchen, wenn das Steuerelement besitzt eine ID angegebene Eigenschaft.
