Aracılığıyla paylaş


TemplateField Sınıf

Tanım

Veriye bağlı denetimde özel içerik görüntüleyen bir alanı temsil eder.

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
Devralma
TemplateField

Örnekler

Aşağıdaki kod örneği, aynı hücrede iki alan görüntüleyen özel TemplateField bir nesnenin nasıl oluşturulacağını gösterir. Ad ve soyadı alanları aynı TemplateField nesnede birleştirilir.


<%@ 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>

Açıklamalar

sınıfı TemplateField , görüntülenen her kayıt için özel içerik görüntülemek üzere veriye bağlı denetimler (ve gibi GridViewDetailsView) tarafından kullanılır. önceden tanımlanmış veri denetimi alanlarından biri (gibi BoundField) tarafından sağlanmayan bir veriye bağlı denetimde içerik görüntülemeniz gerektiğinde, sınıfını TemplateField kullanarak özel kullanıcı arabiriminizi (UI) oluşturun. Nesne TemplateField , kullanıldığı veriye bağlı denetime bağlı olarak farklı şekilde görüntülenir. Örneğin, GridView denetim bir TemplateField nesneyi sütun olarak, DetailsView denetim de bunu bir satır olarak görüntüler.

Aşağıdaki tabloda listelenen şablonları kullanarak nesnenin TemplateField farklı bölümleri için özel bir şablon tanımlayabilirsiniz.

Şablon Description
AlternatingItemTemplate Nesnedeki TemplateField değişen öğeler için görüntülenecek içeriği belirtir.
EditItemTemplate Nesnedeki düzenleme modundaki TemplateField bir öğe için görüntülenecek içeriği belirtir.
FooterTemplate Nesnenin TemplateField alt bilgi bölümü için görüntülenecek içeriği belirtir.
HeaderTemplate Bir TemplateField nesnenin üst bilgi bölümü için görüntülenecek içeriği belirtir.
InsertItemTemplate Nesnedeki ekleme modunda TemplateField bir öğe için görüntülenecek içeriği belirtir. Bu şablon yalnızca denetim tarafından DetailsView desteklenir.
ItemTemplate Nesnedeki TemplateField öğeler için görüntülenecek içeriği belirtir.

özelliğini falseolarak ayarlayarak Visible veriye bağlı denetimdeki bir TemplateField nesneyi gizleyebilirsiniz.

Özel HeaderTemplate veya FooterTemplate şablon tanımlamaya alternatif olarak, nesnenin diğer özelliklerini TemplateField ayarlayarak nesnenin TemplateField üst bilgi ve alt bilgi bölümlerini özelleştirebilirsiniz. Üst bilgi veya alt bilgi bölümlerinde bir başlık görüntülemek için sırasıyla veya FooterText özelliğini ayarlayınHeaderText. Üst bilgi bölümünde metin görüntülemek yerine, özelliğini ayarlayarak HeaderImageUrl bir görüntü görüntüleyebilirsiniz. üst bilgi bölümü, özelliği falseolarak ayarlanarak nesnede TemplateField gizlenebilirShowHeader.

Not

Bazı veriye bağlı denetimler (denetim gibi) denetimin GridView yalnızca üst bilgi bölümünün tamamını gösterebilir veya gizleyebilir. Bu veriye bağlı denetimler, tek bir ilişkili alanın özelliğini desteklemez ShowHeader . Veriye bağlı denetimin üst bilgi bölümünün tamamını göstermek veya gizlemek için denetimin ShowHeader özelliğini kullanın (varsa).

Ayrıca, alanın farklı bölümleri için stil özelliklerini ayarlayarak nesnenin TemplateField görünümünü (yazı tipi rengi, arka plan rengi vb.) özelleştirebilirsiniz. Aşağıdaki tabloda farklı stil özellikleri listeılmıştır.

Style özelliği Description
ControlStyle Nesnenin alt Web sunucusu denetimleri TemplateField için stil ayarları.
FooterStyle Nesnenin alt bilgi bölümünün TemplateField stil ayarları.
HeaderStyle Nesnenin üst bilgi bölümünün TemplateField stil ayarları.
ItemStyle Nesnedeki veri öğelerinin TemplateField stil ayarları.

Oluşturucular

TemplateField()

TemplateField sınıfının yeni bir örneğini başlatır.

Özellikler

AccessibleHeaderText

Bazı denetimlerde özellik değeri olarak AbbreviatedText işlenen metni alır veya ayarlar.

(Devralındığı yer: DataControlField)
AlternatingItemTemplate

Nesnedeki değişen öğeleri TemplateField görüntülemek için şablonu alır veya ayarlar.

Control

Nesnenin ilişkili olduğu veri denetimine DataControlField başvuru alır.

(Devralındığı yer: DataControlField)
ControlStyle

Nesnenin içerdiği DataControlField web sunucusu denetimlerinin stilini alır.

(Devralındığı yer: DataControlField)
ConvertEmptyStringToNull

nesnenin bağlı olduğu değerin TemplateField ise Emptydeğerine dönüştürülmesi null gerekip gerekmediğini belirten bir değer alır veya ayarlar.

DesignMode

Bir veri denetim alanının şu anda bir tasarım zamanı ortamında görüntülenip görüntülenmediğini belirten bir değer alır.

(Devralındığı yer: DataControlField)
EditItemTemplate

Bir öğeyi bir nesnede düzenleme modunda TemplateField görüntülemek için şablonu alır veya ayarlar.

FooterStyle

Veri denetim alanının alt bilgisinin stilini alır veya ayarlar.

(Devralındığı yer: DataControlField)
FooterTemplate

Nesnenin alt bilgi bölümünü TemplateField görüntülemek için şablonu alır veya ayarlar.

FooterText

Veri denetim alanının alt bilgi öğesinde görüntülenen metni alır veya ayarlar.

(Devralındığı yer: DataControlField)
HeaderImageUrl

Bir veri denetimi alanının üst bilgi öğesinde görüntülenen görüntünün URL'sini alır veya ayarlar.

(Devralındığı yer: DataControlField)
HeaderStyle

Veri denetim alanının üst bilgisinin stilini alır veya ayarlar.

(Devralındığı yer: DataControlField)
HeaderTemplate

Bir TemplateField nesnenin üst bilgi bölümünü görüntülemek için şablonu alır veya ayarlar.

HeaderText

Veri denetim alanının üst bilgi öğesinde görüntülenen metni alır veya ayarlar.

(Devralındığı yer: DataControlField)
InsertItemTemplate

Bir öğeyi nesnede ekleme modunda TemplateField görüntülemek için şablonu alır veya ayarlar.

InsertVisible

Üst veri bağlı denetimi ekleme modundayken nesnenin DataControlField görünür olup olmadığını belirten bir değer alır.

(Devralındığı yer: DataControlField)
IsTrackingViewState

Nesnenin DataControlField görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: DataControlField)
ItemStyle

Veri denetim alanı tarafından görüntülenen metin tabanlı içeriğin stilini alır.

(Devralındığı yer: DataControlField)
ItemTemplate

Bir öğeyi veriye bağlı denetimde görüntülemek için şablonu alır veya ayarlar.

ShowHeader

Veri denetim alanının üst bilgi öğesinin işlenip işlenmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: DataControlField)
SortExpression

Verileri sıralamak için veri kaynağı denetimi tarafından kullanılan bir sıralama ifadesi alır veya ayarlar.

(Devralındığı yer: DataControlField)
ValidateRequestMode

Denetimin istemci girişini doğrulayıp doğrulamadığını belirten bir değer alır veya ayarlar.

ValidateRequestMode

Denetimin istemci girişini doğrulayıp doğrulamadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: DataControlField)
ViewState

Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum DataControlField bilgileri sözlüğü alır.

(Devralındığı yer: DataControlField)
Visible

Veri denetim alanının işlenip işlenmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: DataControlField)

Yöntemler

CloneField()

Geçerli DataControlFieldtüretilmiş nesnenin yinelenen bir kopyasını oluşturur.

(Devralındığı yer: DataControlField)
CopyProperties(DataControlField)

Geçerli TemplateFieldtüretilmiş nesnenin özelliklerini belirtilen DataControlField nesneye kopyalar.

CreateField()

Yeni TemplateField bir nesne oluşturur.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Geçerli tablo hücresinden bir veya daha fazla iki yönlü bağlama deyimi (DataBind) tarafından belirtilen veri denetimi alanlarının değerini ayıklar ve değerleri belirtilen IOrderedDictionary koleksiyona ekler.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
Initialize(Boolean, Control)

Veri denetimi alanı için temel örnek başlatma gerçekleştirir.

(Devralındığı yer: DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Hücrenin denetim koleksiyonuna metin veya denetimler ekler.

LoadViewState(Object)

Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler.

(Devralındığı yer: DataControlField)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnFieldChanged()

Olayı tetikler FieldChanged .

(Devralındığı yer: DataControlField)
SaveViewState()

Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder.

(Devralındığı yer: DataControlField)
ToString()

Bu DataControlField nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: DataControlField)
TrackViewState()

Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

(Devralındığı yer: DataControlField)
ValidateSupportsCallback()

Bir TemplateField nesnenin içerdiği denetimlerin sayfa geri çağrılarını destekleyip desteklemediğini belirler.

Belirtik Arabirim Kullanımları

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Bu DataControlField nesneyle ilişkili şemayı alır veya ayarlar.

(Devralındığı yer: DataControlField)
IStateManager.IsTrackingViewState

Nesnenin DataControlField görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: DataControlField)
IStateManager.LoadViewState(Object)

Veri denetimi alanının daha önce kaydedilmiş görünüm durumunu geri yükler.

(Devralındığı yer: DataControlField)
IStateManager.SaveViewState()

Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder.

(Devralındığı yer: DataControlField)
IStateManager.TrackViewState()

Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

(Devralındığı yer: DataControlField)

Şunlara uygulanır

Ayrıca bkz.