TemplateField.AlternatingItemTemplate Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur templat untuk menampilkan item alternatif dalam TemplateField objek.
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 ITemplateNilai Properti
Objek ITemplateyang diimplementasikan yang berisi templat untuk menampilkan item alternatif dalam TemplateField. Defaultnya adalah null, yang menunjukkan bahwa properti ini tidak diatur.
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menggunakan AlternatingItemTemplate properti untuk membuat templat kustom untuk item alternatif di TemplateField kolom GridView bidang kontrol. Templat adalah variasi templat yang ditentukan oleh ItemTemplate properti , di mana gambar ditampilkan di sisi sel yang berlawanan.
<%@ 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>
Keterangan
AlternatingItemTemplate Gunakan properti untuk menentukan konten kustom yang ditampilkan untuk item alternatif dalam TemplateField objek. Tentukan konten dengan membuat templat yang menentukan bagaimana item alternatif dirender.
Nota
Properti AlternatingItemTemplate biasanya digunakan dalam kombinasi dengan ItemTemplate properti untuk membuat tampilan yang berbeda untuk setiap item lain dalam kontrol terikat data.
Untuk menentukan templat, tempat pertama membuka dan menutup <AlternatingItemTemplate> tag antara tag <TemplateField> pembuka dan penutup elemen. Selanjutnya, tambahkan konten kustom antara tag pembuka dan penutup <AlternatingItemTemplate> . Kontennya bisa sesederhana teks biasa atau lebih kompleks (menyematkan kontrol lain dalam templat, misalnya).
Untuk mengakses kontrol yang ditentukan dalam templat secara terprogram, pertama-tama tentukan objek mana dalam kontrol terikat TableCell data yang berisi kontrol. Selanjutnya, gunakan Controls kumpulan TableCell objek untuk mengakses kontrol. Anda juga dapat menggunakan FindControl metode TableCell objek untuk menemukan kontrol, jika kontrol memiliki properti yang ID ditentukan.
