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

例

次の例では、コントロールのDataGrid列型をBoundColumn使用して、データソース内のフィールドを表示する方法を示します。

<%@ 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 表示するには、コントロールの列の種類を使用します。値は 1 つの列に一覧表示されます。フィールドはリンク BoundColumnされているため、データソース内のすべての更新は、コントロールの対応するセルに DataGrid 反映されます。

注意

この列の種類は、コントロールの DataGrid 既定値です。

この列の外観を制御するには、コントロールのスタイルプロパティを DataGrid 使用します。

注意事項

テキストが HTML でエンコードされていない場合は、テキストが BoundColumn. これにより、テキスト内の 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()	サーバーコントロールにビューステートの変更を追跡させ、サーバーコントロールの StateBag オブジェクトに変更を格納できるようにします。 (継承元 DataGridColumn)

明示的なインターフェイスの実装

IStateManager.IsTrackingViewState	列がビューステートの変化を追跡しているかどうかを示す値を取得します。 (継承元 DataGridColumn)
IStateManager.LoadViewState(Object)	以前に保存した状態を読み込みます。 (継承元 DataGridColumn)
IStateManager.SaveViewState()	状態の変化を示すオブジェクトを返します。 (継承元 DataGridColumn)
IStateManager.TrackViewState()	状態変化の追跡を開始します。 (継承元 DataGridColumn)

適用対象