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>

注釈

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

Note

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

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

Caution

テキストは、 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()	ビューステートの変更をサーバーコントロールに追跡して、サーバーコントロールの StateBag オブジェクトに格納できるようにします。 (継承元 DataGridColumn)

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

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

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?