BoundField 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 metin olarak görüntülenen bir alanı temsil eder.

public ref class BoundField : System::Web::UI::WebControls::DataControlField

public class BoundField : System.Web.UI.WebControls.DataControlField

type BoundField = class
    inherit DataControlField

Public Class BoundField
Inherits DataControlField

Devralma: Object

DataControlField
BoundField

Türetilmiş: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Örnekler

Aşağıdaki kod örneği, denetimdeki bir BoundField alanın GridView değerlerini görüntülemek için bir nesnenin nasıl kullanılacağını gösterir.


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

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Açıklamalar

sınıfı BoundField , bir alanın değerini metin olarak görüntülemek için veriye bağlı denetimler (ve gibi GridView DetailsView) tarafından kullanılır. Nesne BoundField , kullanıldığı veriye bağlı denetime bağlı olarak farklı şekilde görüntülenir. Örneğin, GridView denetim bir BoundField nesneyi sütun olarak görüntülerken DetailsView , denetim bunu satır olarak görüntüler.

Nesnede BoundField görüntülenecek alanı belirtmek için, özelliğini alanın adına ayarlayın DataField . alanının değeri, özelliği trueolarak ayarlanarak HtmlEncode görüntülenmeden önce HTML ile kodlanabilir. özelliğini ayarlayarak DataFormatString alanın değerine özel bir biçimlendirme dizesi uygulayabilirsiniz. HtmlEncode özelliği olduğundatrue, alanın kodlanmış dize değeri özel biçim dizesinde kullanılır. Varsayılan olarak, biçimlendirme dizesi alan değerlerine yalnızca veriye bağlı denetim salt okunur modda olduğunda uygulanır. Veriye bağlı denetim düzenleme modundayken görüntülenen değerlere biçimlendirme dizesini uygulamak için özelliğini olarak trueayarlayınApplyFormatInEditMode. Alanın değeri null ise, özelliğini ayarlayarak NullDisplayText özel bir resim yazısı görüntüleyebilirsiniz. Nesnesi ayrıca BoundField özelliğini olarak ayarlayarak ConvertEmptyStringToNull boş dize ("") alan değerlerini otomatik olarak null değerlere truedönüştürebilir.

özelliğini falseolarak ayarlayarak Visible veriye bağlı denetimdeki bir BoundField nesneyi gizleyebilirsiniz. Bir alanın değerinin düzenleme modunda değiştirilmesini önlemek için özelliğini olarak trueayarlayınReadOnly. Kayıt eklemeyi destekleyen veriye bağlı denetimlerde (denetim gibiDetailsView), özelliğini falseolarak ayarlayarak InsertVisible bir BoundField nesneyi gizleyebilirsiniz. Bu genellikle ekleme modunda otomatik olarak oluşturulan bir anahtar alanını gizlemek istediğinizde gerçekleştirilir.

Bir nesnenin üst bilgi ve alt bilgi bölümlerini BoundField özelleştirebilirsiniz. Üst bilgi veya alt bilgi bölümlerinde resim yazısı görüntülemek için sırasıyla veya FooterText özelliklerini 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 BoundField 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 (varsa), denetimin ShowHeader özelliğini kullanın.

Ayrıca, alanın farklı bölümleri için stil özelliklerini ayarlayarak nesnenin BoundField 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 BoundField için stil ayarları.
FooterStyle	Nesnenin alt bilgi bölümünün BoundField stil ayarları.
HeaderStyle	Nesnenin üst bilgi bölümünün BoundField stil ayarları.
ItemStyle	Nesnedeki veri öğelerinin BoundField stil ayarları.

Oluşturucular

BoundField()

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

Alanlar

ThisExpression

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

"This" ifadesini temsil eder.

Özellikler

AccessibleHeaderText	Bazı denetimlerde özellik değeri olarak `AbbreviatedText` işlenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
ApplyFormatInEditMode	Özelliği tarafından DataFormatString belirtilen biçimlendirme dizesinin, nesneyi içeren BoundField veriye bağlı denetim düzenleme modundayken alan değerlerine uygulanıp uygulanmadığını belirten bir değer 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	Veri alanı veri kaynağında güncelleştirildiğinde boş dize değerlerinin ("") otomatik olarak null değerlere dönüştürüldüğünü belirten bir değer alır veya ayarlar.
DataField	Nesneye bağlanacak BoundField veri alanının adını alır veya ayarlar.
DataFormatString	Alanın değeri için görüntüleme biçimini belirten dizeyi 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)
FooterStyle	Veri denetim alanının alt bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
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)
HeaderText	Veri denetiminin üst bilgisinde görüntülenen metni alır veya ayarlar.
HtmlEncode	Alan değerlerinin bir nesnede görüntülenmeden önce HTML ile kodlanıp kodlanmadığını belirten bir BoundField değer alır veya ayarlar.
HtmlEncodeFormatString	Özelliği BoundField değere uygulanarak DataFormatString oluşturulan metnin görüntülendiğinde HTML olarak kodlanması gerekip gerekmediğini belirten bir değeri 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)
NullDisplayText	Alanın değeri null olduğunda alan için görüntülenen resim yazısını alır veya ayarlar.
ReadOnly	Alanın değerinin düzenleme modunda değiştirilip değiştirilemeyeceğini belirten bir değer 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)
SupportsHtmlEncode	HTML kodlamanın bir nesne tarafından desteklenip desteklenmediğini belirten bir BoundField değer alır.
ValidateRequestMode	Denetimin istemci girişini doğrulayıp doğrulamadığını belirleyen 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 kaydetmenizi ve geri yüklemenizi sağlayan 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 BoundField nesnenin özelliklerini belirtilen DataControlField nesneye kopyalar.
CreateField()	Boş BoundField 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)	Belirtilen nesneyi belirtilen IDictionary nesnedeki TableCell değerlerle doldurur.
FormatDataValue(Object, Boolean)	Nesnedeki bir hücre için belirtilen alan değerini biçimlendirin BoundField .
GetDesignTimeValue()	Tasarımcıda nesneyi işlerken BoundField alanın değeri için kullanılan değeri alır.
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)
GetValue(Control)	Nesneye bağlı BoundField alanın değerini alır.
Initialize(Boolean, Control)	BoundField Nesnesini başlatır.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Belirtilen nesneyi belirtilen TableCell satır durumuna başlatır.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Belirtilen nesneyi belirtilen TableCell satır durumuna başlatır.
LoadViewState(Object)	Bu alan için önceden depolanan görünüm durumu bilgilerini geri yükler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDataBindField(Object, EventArgs)	Bir alanın değerini nesnesine BoundField bağlar.
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 BoundField nesnedeki denetimlerin geri çağırmaları 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

Aracılığıyla paylaş