BoundColumn 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.

Jenis kolom untuk DataGrid kontrol yang terikat ke bidang di sumber data.

public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn

public class BoundColumn : System.Web.UI.WebControls.DataGridColumn

type BoundColumn = class
    inherit DataGridColumn

Public Class BoundColumn
Inherits DataGridColumn

Warisan: Object

DataGridColumn
BoundColumn

Contoh

Contoh berikut menunjukkan cara menggunakan BoundColumn jenis kolom dalam DataGrid kontrol untuk menampilkan bidang di sumber data.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="VB" runat="server">
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
   </script>
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

Keterangan

BoundColumn Gunakan tipe kolom dalam DataGrid kontrol untuk menampilkan konten bidang di sumber data. Nilai dicantumkan dalam satu kolom. Bidang ditautkan ke BoundColumn, sehingga pembaruan apa pun di sumber data akan mencerminkan sel kontrol yang DataGrid sesuai.

Note

Tipe kolom ini adalah default untuk DataGrid kontrol.

Untuk mengontrol tampilan kolom ini, gunakan properti DataGrid gaya kontrol.

Caution

Teks tidak dikodekan HTML sebelum ditampilkan di BoundColumn. Ini memungkinkan untuk menyematkan skrip dalam tag HTML dalam teks. Jika nilai untuk kolom ini berasal dari input pengguna, pastikan untuk memvalidasi nilai untuk mengurangi kerentanan keamanan.

Konstruktor

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

Bidang

Nama	Deskripsi
thisExpr	Mewakili string "!". Bidang ini hanya dapat dibaca.

Properti

Nama	Deskripsi
DataField	Mendapatkan atau mengatur nama bidang dari sumber data ke ikatan ke BoundColumn.
DataFormatString	Mendapatkan atau mengatur string yang menentukan format tampilan untuk item di kolom.
DesignMode	Mendapatkan nilai yang menunjukkan apakah kolom berada dalam mode desain. (Diperoleh dari DataGridColumn)
FooterStyle	Mendapatkan properti gaya untuk bagian footer kolom. (Diperoleh dari DataGridColumn)
FooterText	Mendapatkan atau mengatur teks yang ditampilkan di bagian footer kolom. (Diperoleh dari DataGridColumn)
HeaderImageUrl	Mendapatkan atau mengatur lokasi gambar untuk ditampilkan di bagian header kolom. (Diperoleh dari DataGridColumn)
HeaderStyle	Mendapatkan properti gaya untuk bagian header kolom. (Diperoleh dari DataGridColumn)
HeaderText	Mendapatkan atau mengatur teks yang ditampilkan di bagian header kolom. (Diperoleh dari DataGridColumn)
IsTrackingViewState	Mendapatkan nilai yang menentukan apakah DataGridColumn objek ditandai untuk menyimpan statusnya. (Diperoleh dari DataGridColumn)
ItemStyle	Mendapatkan properti gaya untuk sel item kolom. (Diperoleh dari DataGridColumn)
Owner	DataGrid Mendapatkan kontrol bahwa kolom adalah anggota. (Diperoleh dari DataGridColumn)
ReadOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah item dalam dapat diedit BoundColumn .
SortExpression	Mendapatkan atau mengatur nama bidang atau ekspresi untuk diteruskan ke OnSortCommand(DataGridSortCommandEventArgs) metode saat kolom dipilih untuk pengurutan. (Diperoleh dari DataGridColumn)
ViewState	StateBag Mendapatkan objek yang memungkinkan kolom yang berasal dari DataGridColumn kelas untuk menyimpan propertinya. (Diperoleh dari DataGridColumn)
Visible	Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom terlihat dalam DataGrid kontrol. (Diperoleh dari DataGridColumn)

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FormatDataValue(Object)	Mengonversi nilai yang ditentukan ke format yang ditunjukkan DataFormatString oleh properti .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
Initialize()	Mereset ke status BoundColumn awalnya.
InitializeCell(TableCell, Int32, ListItemType)	Mereset sel yang ditentukan dalam ke status BoundColumn awalnya.
LoadViewState(Object)	Memuat status DataGridColumn objek. (Diperoleh dari DataGridColumn)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnColumnChanged()	Memanggil metode OnColumnsChanged(). (Diperoleh dari DataGridColumn)
SaveViewState()	Menyimpan status DataGridColumn objek saat ini. (Diperoleh dari DataGridColumn)
ToString()	Mengembalikan representasi string kolom. (Diperoleh dari DataGridColumn)
TrackViewState()	Menyebabkan pelacakan perubahan status tampilan pada kontrol server sehingga dapat disimpan di objek kontrol StateBag server. (Diperoleh dari DataGridColumn)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah kolom melacak perubahan status tampilan. (Diperoleh dari DataGridColumn)
IStateManager.LoadViewState(Object)	Memuat status yang disimpan sebelumnya. (Diperoleh dari DataGridColumn)
IStateManager.SaveViewState()	Mengembalikan objek yang berisi perubahan status. (Diperoleh dari DataGridColumn)
IStateManager.TrackViewState()	Mulai melacak perubahan status. (Diperoleh dari DataGridColumn)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?