BoundColumn 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

繫結至資料來源欄位之 DataGrid 控制項的資料行類型。

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

繼承: Object

DataGridColumn
BoundColumn

範例

下列範例示範如何使用 BoundColumn 控制項中的資料 DataGrid 行類型，在資料來源中顯示欄位。

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

備註

BoundColumn使用控制項中的資料 DataGrid 行類型來顯示資料來源中欄位的內容。這些值會列在單一資料行中。欄位會連結至 BoundColumn ，因此資料來源中的任何更新都會反映在控制項的 DataGrid 對應儲存格中。

注意

這個資料行類型是控制項的 DataGrid 預設值。

若要控制此資料行的外觀，請使用控制項的 DataGrid 樣式屬性。

警告

在顯示 BoundColumn 文字之前，文字不會經過 HTML 編碼。這可讓您在文字的 HTML 標籤內嵌腳本。如果此資料行的值來自使用者輸入，請務必驗證值以減少安全性弱點。

建構函式

BoundColumn()

初始化 BoundColumn 類別的新執行個體。

欄位

thisExpr

表示字串 "!"。此欄位為唯讀。

屬性

DataField	取得或設定資料來源中的欄位名稱，以繫結至 BoundColumn。
DataFormatString	取得或設定字串，指定資料行中項目的顯示格式。
DesignMode	取得值，指出資料行是否處在設計模式中。 (繼承來源 DataGridColumn)
FooterStyle	取得資料行行尾區段的樣式屬性。 (繼承來源 DataGridColumn)
FooterText	取得或設定顯示於資料行行尾區段的文字。 (繼承來源 DataGridColumn)
HeaderImageUrl	取得或設定要顯示於資料行行首區段的影像位置。 (繼承來源 DataGridColumn)
HeaderStyle	取得資料行行首區段的樣式屬性。 (繼承來源 DataGridColumn)
HeaderText	取得或設定顯示於資料行行首區段的文字。 (繼承來源 DataGridColumn)
IsTrackingViewState	取得值，判斷是否標記 DataGridColumn 物件以儲存其狀態。 (繼承來源 DataGridColumn)
ItemStyle	取得資料行項目儲存格的樣式屬性。 (繼承來源 DataGridColumn)
Owner	取得有資料行做為其中成員的 DataGrid 控制項。 (繼承來源 DataGridColumn)
ReadOnly	取得或設定值，指出是否可以編輯 BoundColumn 中的項目。
SortExpression	在選取資料行來排序時，取得或設定欄位或運算式的名稱以傳遞至 OnSortCommand(DataGridSortCommandEventArgs) 方法。 (繼承來源 DataGridColumn)
ViewState	取得 StateBag 物件，該物件允許衍生自 DataGridColumn 類別的資料行儲存其屬性。 (繼承來源 DataGridColumn)
Visible	取得或設定值，指出資料行是否可見於 DataGrid 控制項中。 (繼承來源 DataGridColumn)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FormatDataValue(Object)	轉換指定值為 DataFormatString 屬性所指示的格式。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Initialize()	重設 BoundColumn 為它的初始狀態。
InitializeCell(TableCell, Int32, ListItemType)	重設 BoundColumn 中的指定儲存格為它的初始狀態。
LoadViewState(Object)	載入 DataGridColumn 物件的狀態。 (繼承來源 DataGridColumn)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnColumnChanged()	呼叫 OnColumnsChanged() 方法。 (繼承來源 DataGridColumn)
SaveViewState()	儲存 DataGridColumn 物件的目前狀態。 (繼承來源 DataGridColumn)
ToString()	傳回資料行的字串表示。 (繼承來源 DataGridColumn)
TrackViewState()	導致對伺服器控制項的檢視狀態變更的追蹤 (Tracking)，以便它們能夠儲存於伺服器控制項的 StateBag 物件。 (繼承來源 DataGridColumn)

明確介面實作

IStateManager.IsTrackingViewState	取得值，指出資料行是否正在追蹤 (Tracking) 檢視狀態變更。 (繼承來源 DataGridColumn)
IStateManager.LoadViewState(Object)	載入先前儲存的狀態。 (繼承來源 DataGridColumn)
IStateManager.SaveViewState()	傳回包含狀態變更的物件。 (繼承來源 DataGridColumn)
IStateManager.TrackViewState()	啟動追蹤狀態的變更。 (繼承來源 DataGridColumn)

適用於

共用方式為

BoundColumn 類別

定義

範例

備註

建構函式

欄位

屬性

方法

明確介面實作

適用於

另請參閱

其他資源