BoundField Kelas

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 ditampilkan sebagai teks dalam kontrol terikat data.

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

Warisan: Object

DataControlField
BoundField

Turunan: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Contoh

Contoh kode berikut menunjukkan cara menggunakan BoundField objek untuk menampilkan nilai bidang dalam GridView kontrol.


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

Keterangan

Kelas BoundField digunakan oleh kontrol terikat data (seperti GridView dan DetailsView) untuk menampilkan nilai bidang sebagai teks. Objek BoundField ditampilkan secara berbeda tergantung pada kontrol terikat data tempat objek digunakan. Misalnya, GridView kontrol menampilkan BoundField objek sebagai kolom, sementara DetailsView kontrol menampilkannya sebagai baris.

Untuk menentukan bidang yang akan ditampilkan dalam BoundField objek, atur DataField properti ke nama bidang. Nilai bidang dapat dikodekan HTML sebelum ditampilkan dengan mengatur properti ke HtmlEncodetrue. Anda bisa menerapkan string pemformatan kustom ke nilai bidang dengan mengatur DataFormatString properti . HtmlEncode Ketika properti adalah true, nilai string yang dikodekan dari bidang digunakan dalam string format kustom. Secara default, string pemformatan diterapkan ke nilai bidang hanya ketika kontrol terikat data berada dalam mode baca-saja. Untuk menerapkan string pemformatan ke nilai yang ditampilkan saat kontrol terikat data dalam mode edit, atur ApplyFormatInEditMode properti ke true. Jika nilai bidang null, Anda bisa menampilkan keterangan kustom dengan mengatur NullDisplayText properti . Objek BoundField juga dapat secara otomatis mengonversi nilai bidang string kosong ("") menjadi nilai null dengan mengatur ConvertEmptyStringToNull properti ke true.

Anda dapat menyembunyikan BoundField objek dalam kontrol terikat data dengan mengatur Visible properti ke false. Untuk mencegah nilai bidang dimodifikasi dalam mode edit, atur properti ke ReadOnlytrue. Dalam kontrol terikat data yang mendukung penyisipan rekaman (seperti DetailsView kontrol), Anda bisa menyembunyikan BoundField objek dengan mengatur InsertVisible properti ke false. Ini biasanya dilakukan ketika Anda ingin menyembunyikan bidang kunci yang dihasilkan secara otomatis dalam mode sisipkan.

Anda dapat mengkustomisasi BoundField bagian header dan footer objek. Untuk menampilkan keterangan 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 BoundField objek dengan mengatur ShowHeader properti ke false.

Nota

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 individual. Untuk memperlihatkan atau menyembunyikan seluruh bagian header kontrol terikat data (jika tersedia), gunakan properti kontrol ShowHeader .

Anda juga dapat menyesuaikan tampilan BoundField 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 objek BoundField .
FooterStyle	Pengaturan gaya untuk bagian BoundField footer objek.
HeaderStyle	Pengaturan gaya untuk bagian BoundField header objek.
ItemStyle	Pengaturan gaya untuk item data dalam BoundField objek.

Konstruktor

Nama	Deskripsi
BoundField()	Menginisialisasi instans baru dari kelas BoundField.

Bidang

Nama	Deskripsi
ThisExpression	API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. Mewakili ekspresi "ini".

Nama

Deskripsi

ThisExpression

API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.

Mewakili ekspresi "ini".

Properti

Nama	Deskripsi
AccessibleHeaderText	Mendapatkan atau mengatur teks yang dirender sebagai `AbbreviatedText` nilai properti dalam beberapa kontrol. (Diperoleh dari DataControlField)
ApplyFormatInEditMode	Mendapatkan atau mengatur nilai yang menunjukkan apakah string pemformatan yang ditentukan oleh DataFormatString properti diterapkan ke nilai bidang saat kontrol terikat data yang berisi BoundField objek berada dalam mode edit.
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 string kosong ("") secara otomatis dikonversi ke nilai null saat bidang data diperbarui di sumber data.
DataField	Mendapatkan atau mengatur nama bidang data yang akan diikat ke BoundField objek.
DataFormatString	Mendapatkan atau mengatur string yang menentukan format tampilan untuk nilai bidang.
DesignMode	Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain. (Diperoleh dari DataControlField)
FooterStyle	Mendapatkan atau mengatur gaya footer bidang kontrol data. (Diperoleh dari DataControlField)
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)
HeaderText	Mendapatkan atau mengatur teks yang ditampilkan di header kontrol data.
HtmlEncode	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai bidang dikodekan HTML sebelum ditampilkan dalam BoundField objek.
HtmlEncodeFormatString	Mendapatkan atau mengatur nilai yang menunjukkan apakah teks yang dibuat dengan menerapkan DataFormatString properti ke BoundField nilai harus dikodekan HTML saat ditampilkan.
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)
NullDisplayText	Mendapatkan atau mengatur keterangan yang ditampilkan untuk bidang saat nilai bidang null.
ReadOnly	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai bidang dapat dimodifikasi dalam mode edit.
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)
SupportsHtmlEncode	Mendapatkan nilai yang menunjukkan apakah pengodean HTML didukung oleh BoundField objek.
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien atau tidak.
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

Nama	Deskripsi
CloneField()	Membuat salinan duplikat dari objek -turunan saat ini DataControlField. (Diperoleh dari DataControlField)
CopyProperties(DataControlField)	Menyalin properti objek saat ini BoundField ke objek yang ditentukan DataControlField .
CreateField()	Membuat objek kosong BoundField .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Mengisi objek yang ditentukan IDictionary dengan nilai dari objek yang ditentukan TableCell .
FormatDataValue(Object, Boolean)	Memformat nilai bidang yang ditentukan untuk sel dalam BoundField objek.
GetDesignTimeValue()	Mengambil nilai yang digunakan untuk nilai bidang saat merender BoundField objek dalam perancang.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(Control)	Mengambil nilai bidang yang terikat ke BoundField objek.
Initialize(Boolean, Control)	Menginisialisasi objek BoundField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Menginisialisasi objek yang ditentukan TableCell ke status baris yang ditentukan.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Menginisialisasi objek yang ditentukan TableCell ke status baris yang ditentukan.
LoadViewState(Object)	Memulihkan informasi status tampilan yang disimpan sebelumnya untuk bidang ini.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnDataBindField(Object, EventArgs)	Mengikat nilai bidang ke BoundField objek.
OnFieldChanged()	Menaikkan `FieldChanged` acara. (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 disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)
ValidateSupportsCallback()	Menentukan apakah kontrol yang terkandung dalam BoundField panggilan balik dukungan objek.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Mendapatkan atau mengatur 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 yang disimpan sebelumnya di bidang kontrol data. (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 disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?