Bagikan melalui


TemplateField Kelas

Definisi

Mewakili bidang yang menampilkan konten kustom dalam kontrol terikat data.

public ref class TemplateField : System::Web::UI::WebControls::DataControlField
public class TemplateField : System.Web.UI.WebControls.DataControlField
type TemplateField = class
    inherit DataControlField
Public Class TemplateField
Inherits DataControlField
Warisan
TemplateField

Contoh

Contoh kode berikut menunjukkan cara membuat objek kustom TemplateField yang menampilkan dua bidang dalam sel yang sama. Bidang nama depan dan nama belakang digabungkan ke dalam objek yang sama TemplateField .


<%@ 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 Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>TemplateField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- Create a custom TemplateField column that uses      -->
      <!-- two Label controls to display an author's first and -->
      <!-- last name in the same column.                       -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:templatefield headertext="Author Name">
            <itemtemplate>
              <asp:label id="FirstNameLabel"
                Text= '<%# Eval("au_fname") %>'
                runat="server"/> 
              <asp:label id="LastNameLabel"
                Text= '<%# Eval("au_lname") %>'
                runat="server"/>
            </itemtemplate>
          </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], [address], [city], [state], [zip], [contract] 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 Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>TemplateField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- Create a custom TemplateField column that uses      -->
      <!-- two Label controls to display an author's first and -->
      <!-- last name in the same column.                       -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:templatefield headertext="Author Name">
            <itemtemplate>
              <asp:label id="FirstNameLabel"
                text= '<%# Eval("au_fname") %>'
                runat="server"/> 
              <asp:label id="LastNameLabel"
                text= '<%# Eval("au_lname") %>'
                runat="server"/>
            </itemtemplate>
          </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], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Keterangan

Kelas TemplateField digunakan oleh kontrol terikat data (seperti GridView dan DetailsView) untuk menampilkan konten kustom untuk setiap rekaman yang ditampilkan. Saat Anda perlu menampilkan konten dalam kontrol terikat data yang tidak disediakan oleh salah satu bidang kontrol data yang telah ditentukan sebelumnya (seperti BoundField), gunakan TemplateField kelas untuk membuat antarmuka pengguna (UI) kustom Anda. Objek TemplateField ditampilkan secara berbeda tergantung pada kontrol terikat data tempat objek digunakan. Misalnya, GridView kontrol menampilkan TemplateField objek sebagai kolom, dan DetailsView kontrol menampilkannya sebagai baris.

Anda bisa menentukan templat kustom untuk berbagai bagian TemplateField objek menggunakan templat yang tercantum dalam tabel berikut ini.

Templat Deskripsi
AlternatingItemTemplate Menentukan isi yang akan ditampilkan untuk item alternatif dalam suatu TemplateField objek.
EditItemTemplate Menentukan isi yang akan ditampilkan untuk item dalam mode edit dalam objek TemplateField .
FooterTemplate Menentukan isi yang akan ditampilkan untuk bagian TemplateField footer objek.
HeaderTemplate Menentukan isi yang akan ditampilkan untuk bagian header objek TemplateField .
InsertItemTemplate Menentukan isi yang akan ditampilkan untuk item dalam mode sisipkan dalam objek TemplateField . Templat ini hanya didukung oleh DetailsView kontrol.
ItemTemplate Menentukan isi yang akan ditampilkan untuk item dalam objek TemplateField .

Anda dapat menyembunyikan TemplateField objek dalam kontrol terikat data dengan mengatur properti ke Visiblefalse.

Sebagai alternatif untuk menentukan kustom HeaderTemplate atau FooterTemplate templat, Anda dapat mengkustomisasi TemplateField bagian header dan footer objek dengan mengatur properti TemplateField objek lainnya. Untuk menampilkan caption di bagian header atau footer, atur HeaderText properti atau FooterText . Alih-alih menampilkan teks di bagian header, Anda bisa menampilkan gambar dengan mengatur HeaderImageUrl properti . Bagian header dapat disembunyikan dalam TemplateField objek dengan mengatur properti ke falseShowHeader .

Catatan

Beberapa kontrol terikat data (seperti GridView kontrol) hanya dapat menampilkan atau menyembunyikan seluruh bagian header kontrol. Kontrol terikat data ini tidak mendukung ShowHeader properti untuk bidang terikat individu. Untuk memperlihatkan atau menyembunyikan seluruh bagian header kontrol terikat data, gunakan properti kontrol ShowHeader (jika tersedia).

Anda juga dapat menyesuaikan tampilan TemplateField objek (warna font, warna latar belakang, dan sebagainya) dengan mengatur properti gaya untuk berbagai bagian bidang. Tabel berikut ini mencantumkan properti gaya yang berbeda.

Properti gaya Deskripsi
ControlStyle Pengaturan gaya untuk kontrol server Web anak dari TemplateField objek.
FooterStyle Pengaturan gaya untuk bagian TemplateField footer objek.
HeaderStyle Pengaturan gaya untuk bagian TemplateField header objek.
ItemStyle Pengaturan gaya untuk item data dalam TemplateField objek.

Konstruktor

TemplateField()

Menginisialisasi instans baru kelas TemplateField.

Properti

AccessibleHeaderText

Mendapatkan atau mengatur teks yang dirender sebagai AbbreviatedText nilai properti dalam beberapa kontrol.

(Diperoleh dari DataControlField)
AlternatingItemTemplate

Mendapatkan atau mengatur templat untuk menampilkan item alternatif dalam TemplateField objek.

Control

Mendapatkan referensi ke kontrol data yang DataControlField terkait dengan objek.

(Diperoleh dari DataControlField)
ControlStyle

Mendapatkan gaya kontrol server Web apa pun yang terkandung oleh DataControlField objek .

(Diperoleh dari DataControlField)
ConvertEmptyStringToNull

Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai yang TemplateField terikat objek harus dikonversi ke null jika itu adalah Empty.

DesignMode

Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain.

(Diperoleh dari DataControlField)
EditItemTemplate

Mendapatkan atau mengatur templat untuk menampilkan item dalam mode edit dalam TemplateField objek.

FooterStyle

Mendapatkan atau mengatur gaya footer bidang kontrol data.

(Diperoleh dari DataControlField)
FooterTemplate

Mendapatkan atau mengatur templat untuk menampilkan bagian TemplateField footer objek.

FooterText

Mendapatkan atau mengatur teks yang ditampilkan dalam item footer bidang kontrol data.

(Diperoleh dari DataControlField)
HeaderImageUrl

Mendapatkan atau mengatur URL gambar yang ditampilkan di item header bidang kontrol data.

(Diperoleh dari DataControlField)
HeaderStyle

Mendapatkan atau mengatur gaya header bidang kontrol data.

(Diperoleh dari DataControlField)
HeaderTemplate

Mendapatkan atau mengatur templat untuk menampilkan bagian TemplateField header objek.

HeaderText

Mendapatkan atau mengatur teks yang ditampilkan di item header bidang kontrol data.

(Diperoleh dari DataControlField)
InsertItemTemplate

Mendapatkan atau mengatur templat untuk menampilkan item dalam mode sisipkan dalam TemplateField objek.

InsertVisible

Mendapatkan nilai yang menunjukkan apakah DataControlField objek terlihat ketika kontrol terikat data induknya berada dalam mode sisipkan.

(Diperoleh dari DataControlField)
IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya.

(Diperoleh dari DataControlField)
ItemStyle

Mendapatkan gaya konten berbasis teks apa pun yang ditampilkan oleh bidang kontrol data.

(Diperoleh dari DataControlField)
ItemTemplate

Mendapatkan atau mengatur templat untuk menampilkan item dalam kontrol terikat data.

ShowHeader

Mendapatkan atau mengatur nilai yang menunjukkan apakah item header bidang kontrol data dirender.

(Diperoleh dari DataControlField)
SortExpression

Mendapatkan atau mengatur ekspresi pengurutan yang digunakan oleh kontrol sumber data untuk mengurutkan data.

(Diperoleh dari DataControlField)
ValidateRequestMode

Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien.

ValidateRequestMode

Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien.

(Diperoleh dari DataControlField)
ViewState

Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataControlField tampilan objek di beberapa permintaan untuk halaman yang sama.

(Diperoleh dari DataControlField)
Visible

Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang kontrol data dirender.

(Diperoleh dari DataControlField)

Metode

CloneField()

Membuat salinan duplikat dari objek -turunan saat ini DataControlField.

(Diperoleh dari DataControlField)
CopyProperties(DataControlField)

Menyalin properti objek -turunan saat ini TemplateFieldke objek yang ditentukan DataControlField .

CreateField()

Membuat objek baru TemplateField .

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Mengekstrak nilai bidang kontrol data seperti yang ditentukan oleh satu atau beberapa pernyataan pengikatan dua arah (DataBind) dari sel tabel saat ini dan menambahkan nilai ke koleksi yang ditentukan IOrderedDictionary .

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
Initialize(Boolean, Control)

Melakukan inisialisasi instans dasar untuk bidang kontrol data.

(Diperoleh dari DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Menambahkan teks atau kontrol ke koleksi kontrol sel.

LoadViewState(Object)

Memulihkan status tampilan yang disimpan sebelumnya dari tampilan sumber data.

(Diperoleh dari DataControlField)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
OnFieldChanged()

Memunculkan kejadian FieldChanged.

(Diperoleh dari DataControlField)
SaveViewState()

Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server.

(Diperoleh dari DataControlField)
ToString()

Mengembalikan string yang mewakili objek ini DataControlField .

(Diperoleh dari DataControlField)
TrackViewState()

DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama.

(Diperoleh dari DataControlField)
ValidateSupportsCallback()

Menentukan apakah kontrol yang terkandung dalam TemplateField panggilan balik halaman dukungan objek.

Implementasi Antarmuka Eksplisit

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Mendapatkan atau menyetel skema yang terkait dengan objek ini DataControlField .

(Diperoleh dari DataControlField)
IStateManager.IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya.

(Diperoleh dari DataControlField)
IStateManager.LoadViewState(Object)

Memulihkan status tampilan bidang kontrol data yang sebelumnya disimpan.

(Diperoleh dari DataControlField)
IStateManager.SaveViewState()

Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server.

(Diperoleh dari DataControlField)
IStateManager.TrackViewState()

DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama.

(Diperoleh dari DataControlField)

Berlaku untuk

Lihat juga