TemplateField Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

DataControlField
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 GridView DetailsView) 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