TemplateField Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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.

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: Object

DataControlField
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

Share via