BoundColumn クラス
データ ソースのフィールドに連結された DataGrid コントロールの列型です。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
アセンブリ: System.Web (system.web.dll 内)
構文解説DataGrid コントロールの BoundColumn 列型を使用して、データ ソースのフィールドの内容を表示します。値は 1 列で表示されます。このフィールドは BoundColumn にリンクされているため、データ ソースを更新すると DataGrid コントロールの対応するセルも更新されます。
.gif) 注意 |
|---|
| テキストは、BoundColumn に表示されるまで HTML エンコードされません。これによって、テキストの HTML タグ内のスクリプトを埋め込むことが可能になります。この列の値がユーザー入力による値の場合は、セキュリティ上の危険性を低減するために、必ず値を検証するようにしてください。 |
使用例DataGrid コントロールで BoundColumn の列の種類を使用して、データ ソースのフィールドを表示する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <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> <body> <form 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="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <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> <body> <form 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="JScript" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script language="JScript" runat="server"> function CreateDataSource() : ICollection { var dt : DataTable = new DataTable(); var dr : 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))); for (var i : int = 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); } var dv : DataView = new DataView(dt); return dv; } function Page_Load(sender : Object, e : EventArgs) { if (!IsPostBack) { // Load this data only once. ItemsGrid.DataSource= CreateDataSource(); ItemsGrid.DataBind(); } } </script> <body> <form 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>
.NET Framework のセキュリティ継承階層
System.Object
System.Web.UI.WebControls.DataGridColumn
System.Web.UI.WebControls.BoundColumn
System.Web.UI.WebControls.DataGridColumn
System.Web.UI.WebControls.BoundColumn
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照BoundColumn コンストラクタ
BoundColumn クラスの新しいインスタンスを初期化します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文解説使用例BoundColumn クラスの新しいインスタンスを作成し初期化して、Columns コレクションに追加する方法を次の例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> Function CreateDataSource() As ICollection ' Create sample data for the DataGrid control. Dim dt As DataTable = New DataTable() Dim dr As DataRow ' Define the columns of the table. dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32))) dt.Columns.Add(New DataColumn("StringValue", GetType(string))) dt.Columns.Add(New DataColumn("CurrencyValue", GetType(double))) ' Populate the table with sample values. 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 DataView = New DataView(dt) Return dv End Function Sub Page_Load(sender As Object, e As EventArgs) ' Create a DataGrid control. Dim ItemsGrid As DataGrid = New DataGrid() ' Set the properties of the DataGrid. ItemsGrid.ID = "ItemsGrid" ItemsGrid.BorderColor = System.Drawing.Color.Black ItemsGrid.CellPadding = 3 ItemsGrid.AutoGenerateColumns = False ' Set the styles for the DataGrid. ItemsGrid.HeaderStyle.BackColor = System.Drawing.Color.FromArgb(&H0000aaaa) ' Create the columns for the DataGrid control. The DataGrid ' columns are dynamically generated. Therefore, the columns ' must be re-created each time the page is refreshed. ' Create and add the columns to the collection. ItemsGrid.Columns.Add(CreateBoundColumn("IntegerValue", "Item")) ItemsGrid.Columns.Add( _ CreateBoundColumn("StringValue", "Description")) ItemsGrid.Columns.Add( _ CreateBoundColumn("CurrencyValue", "Price", "{0:c}", _ HorizontalAlign.Right)) ItemsGrid.Columns.Add( _ CreateLinkColumn("http:'www.microsoft.com", "_self", _ "Microsoft", "Related link")) ' Specify the data source and bind it to the control. ItemsGrid.DataSource = CreateDataSource() ItemsGrid.DataBind() ' Add the DataGrid control to the Controls collection of ' the PlaceHolder control. Place.Controls.Add(ItemsGrid) End Sub Function CreateBoundColumn(DataFieldValue As String, HeaderTextValue As String) As BoundColumn ' This version of CreateBoundColumn method sets only the ' DataField and HeaderText properties. ' Create a BoundColumn. Dim column As BoundColumn = New BoundColumn() ' Set the properties of the BoundColumn. column.DataField = DataFieldValue column.HeaderText = HeaderTextValue Return column End Function Function CreateBoundColumn(DataFieldValue As String, _ HeaderTextValue As String, FormatValue As String, _ AlignValue As HorizontalAlign) As BoundColumn ' This version of CreateBoundColumn method sets the DataField , ' HeaderText, and DataFormatString properties. It also sets the ' HorizontalAlign property of the ItemStyle property of the column. ' Create a BoundColumn using the overloaded CreateBoundColumn method. Dim column As BoundColumn = CreateBoundColumn(DataFieldValue, HeaderTextValue) ' Set the properties of the BoundColumn. column.DataFormatString = FormatValue column.ItemStyle.HorizontalAlign = AlignValue Return column End Function Function CreateLinkColumn(NavUrlValue As String, TargetValue As String, _ TextValue As String, HeaderTextValue As String) As HyperLinkColumn ' Create a BoundColumn. Dim column As HyperLinkColumn = New HyperLinkColumn() ' Set the properties of the ButtonColumn. column.NavigateUrl = NavUrlValue column.Target = TargetValue column.Text = TextValue column.HeaderText = HeaderTextValue Return column End Function </script> <body> <form runat=server> <h3>DataGrid Constructor Example</h3> <b>Product List</b> <asp:PlaceHolder id="Place" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> ICollection CreateDataSource() { // Create sample data for the DataGrid control. DataTable dt = new DataTable(); DataRow dr; // Define the columns of the table. dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(string))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double))); // Populate the table with sample values. 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) { // Create a DataGrid control. DataGrid ItemsGrid = new DataGrid(); // Set the properties of the DataGrid. ItemsGrid.ID = "ItemsGrid"; ItemsGrid.BorderColor = System.Drawing.Color.Black; ItemsGrid.CellPadding = 3; ItemsGrid.AutoGenerateColumns = false; // Set the styles for the DataGrid. ItemsGrid.HeaderStyle.BackColor = System.Drawing.Color.FromArgb(0x0000aaaa); // Create the columns for the DataGrid control. The DataGrid // columns are dynamically generated. Therefore, the columns // must be re-created each time the page is refreshed. // Create and add the columns to the collection. ItemsGrid.Columns.Add(CreateBoundColumn("IntegerValue", "Item")); ItemsGrid.Columns.Add( CreateBoundColumn("StringValue", "Description")); ItemsGrid.Columns.Add( CreateBoundColumn("CurrencyValue", "Price", "{0:c}", HorizontalAlign.Right)); ItemsGrid.Columns.Add( CreateLinkColumn("http://www.microsoft.com", "_self", "Microsoft", "Related link")); // Specify the data source and bind it to the control. ItemsGrid.DataSource = CreateDataSource(); ItemsGrid.DataBind(); // Add the DataGrid control to the Controls collection of // the PlaceHolder control. Place.Controls.Add(ItemsGrid); } BoundColumn CreateBoundColumn(String DataFieldValue, String HeaderTextValue) { // This version of the CreateBoundColumn method sets only the // DataField and HeaderText properties. // Create a BoundColumn. BoundColumn column = new BoundColumn(); // Set the properties of the BoundColumn. column.DataField = DataFieldValue; column.HeaderText = HeaderTextValue; return column; } BoundColumn CreateBoundColumn(String DataFieldValue, String HeaderTextValue, String FormatValue, HorizontalAlign AlignValue) { // This version of CreateBoundColumn method sets the DataField , // HeaderText, and DataFormatString properties. It also sets the // HorizontalAlign property of the ItemStyle property of the column. // Create a BoundColumn using the overloaded CreateBoundColumn method. BoundColumn column = CreateBoundColumn(DataFieldValue, HeaderTextValue); // Set the properties of the BoundColumn. column.DataFormatString = FormatValue; column.ItemStyle.HorizontalAlign = AlignValue; return column; } HyperLinkColumn CreateLinkColumn(String NavUrlValue, String TargetValue, String TextValue, String HeaderTextValue) { // Create a BoundColumn. HyperLinkColumn column = new HyperLinkColumn(); // Set the properties of the ButtonColumn. column.NavigateUrl = NavUrlValue; column.Target = TargetValue; column.Text = TextValue; column.HeaderText = HeaderTextValue; return column; } </script> <body> <form runat=server> <h3>DataGrid Constructor Example</h3> <b>Product List</b> <asp:PlaceHolder id="Place" runat="server"/> </form> </body> </html>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照BoundColumn フィールド
BoundColumn プロパティ
パブリック プロパティ
(
プロテクト プロパティ
も参照)
| 名前 | 説明 | |
|---|---|---|
.gif) | DataField | BoundColumn に連結するデータ ソースのフィールド名を取得または設定します。 |
| | DataFormatString | 列内の項目の表示形式を指定する文字列を取得または設定します。 |
| | FooterStyle | 列のフッター セクションのスタイル プロパティを取得します。 ( DataGridColumn から継承されます。) |
| | FooterText | 列のフッター セクションに表示されるテキストを取得または設定します。 ( DataGridColumn から継承されます。) |
| | HeaderImageUrl | 列のヘッダー セクションに表示するイメージの位置を取得または設定します。 ( DataGridColumn から継承されます。) |
| | HeaderStyle | 列のヘッダー セクションのスタイル プロパティを取得します。 ( DataGridColumn から継承されます。) |
| | HeaderText | 列のヘッダー セクションに表示されるテキストを取得または設定します。 ( DataGridColumn から継承されます。) |
| | ItemStyle | 列の項目セルのスタイル プロパティを取得します。 ( DataGridColumn から継承されます。) |
| | ReadOnly | BoundColumn 内の項目を編集できるかどうかを示す値を取得または設定します。 |
| | SortExpression | 並べ替えのために列が選択された場合に、OnSortCommand メソッドに渡されるフィールドの名前または式を、取得または設定します。 ( DataGridColumn から継承されます。) |
| | Visible | DataGrid コントロールに列を表示するかどうかを示す値を取得または設定します。 ( DataGridColumn から継承されます。) |
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | DesignMode | 列がデザイン モードかどうかを示す値を取得します。 ( DataGridColumn から継承されます。) |
| | IsTrackingViewState | DataGridColumn オブジェクトが状態を保存するようにマークされているかどうかを判断する値を取得します。 ( DataGridColumn から継承されます。) |
| | Owner | 列がメンバとして含まれている DataGrid コントロールを取得します。 ( DataGridColumn から継承されます。) |
| | ViewState | DataGridColumn クラスから派生した列がそのプロパティを格納できるようにする System.Web.UI.StateBag オブジェクトを取得します。 ( DataGridColumn から継承されます。) |
参照BoundColumn メソッド
パブリック メソッド
(
プロテクト メソッド
も参照)
| 名前 | 説明 | |
|---|---|---|
.gif) | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| | Initialize | オーバーライドされます。 BoundColumn を初期状態にリセットします。 |
| | InitializeCell | オーバーライドされます。 BoundColumn 内の指定されたセルを初期状態にリセットします。 |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | 列の文字列形式を返します。 ( DataGridColumn から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | FormatDataValue | 指定された値を DataFormatString プロパティで示されている書式に変換します。 |
| | LoadViewState | DataGridColumn オブジェクトの状態を読み込みます。 ( DataGridColumn から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
| | OnColumnChanged | DataGridDesigner.OnColumnsChanged メソッドを呼び出します。 ( DataGridColumn から継承されます。) |
| | SaveViewState | DataGridColumn オブジェクトの現在の状態を保存します。 ( DataGridColumn から継承されます。) |
| | TrackViewState | サーバー コントロールにビューステートの変更を追跡させ、サーバー コントロールの System.Web.UI.StateBag オブジェクトに変更を格納できるようにします。 ( DataGridColumn から継承されます。) |
参照BoundColumn メンバ
データ ソースのフィールドに連結された DataGrid コントロールの列型です。
BoundColumn データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック フィールドパブリック プロパティ
(
プロテクト プロパティ
も参照)
| 名前 | 説明 | |
|---|---|---|
| | DataField | BoundColumn に連結するデータ ソースのフィールド名を取得または設定します。 |
| | DataFormatString | 列内の項目の表示形式を指定する文字列を取得または設定します。 |
| | FooterStyle | 列のフッター セクションのスタイル プロパティを取得します。(DataGridColumn から継承されます。) |
| | FooterText | 列のフッター セクションに表示されるテキストを取得または設定します。(DataGridColumn から継承されます。) |
| | HeaderImageUrl | 列のヘッダー セクションに表示するイメージの位置を取得または設定します。(DataGridColumn から継承されます。) |
| | HeaderStyle | 列のヘッダー セクションのスタイル プロパティを取得します。(DataGridColumn から継承されます。) |
| | HeaderText | 列のヘッダー セクションに表示されるテキストを取得または設定します。(DataGridColumn から継承されます。) |
| | ItemStyle | 列の項目セルのスタイル プロパティを取得します。(DataGridColumn から継承されます。) |
| | ReadOnly | BoundColumn 内の項目を編集できるかどうかを示す値を取得または設定します。 |
| | SortExpression | 並べ替えのために列が選択された場合に、OnSortCommand メソッドに渡されるフィールドの名前または式を、取得または設定します。(DataGridColumn から継承されます。) |
| | Visible | DataGrid コントロールに列を表示するかどうかを示す値を取得または設定します。(DataGridColumn から継承されます。) |
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
| | DesignMode | 列がデザイン モードかどうかを示す値を取得します。(DataGridColumn から継承されます。) |
| | IsTrackingViewState | DataGridColumn オブジェクトが状態を保存するようにマークされているかどうかを判断する値を取得します。(DataGridColumn から継承されます。) |
| | Owner | 列がメンバとして含まれている DataGrid コントロールを取得します。(DataGridColumn から継承されます。) |
| | ViewState | DataGridColumn クラスから派生した列がそのプロパティを格納できるようにする System.Web.UI.StateBag オブジェクトを取得します。(DataGridColumn から継承されます。) |
パブリック メソッド
(
プロテクト メソッド
も参照)
| 名前 | 説明 | |
|---|---|---|
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | Initialize | オーバーライドされます。 BoundColumn を初期状態にリセットします。 |
| | InitializeCell | オーバーライドされます。 BoundColumn 内の指定されたセルを初期状態にリセットします。 |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | ToString | 列の文字列形式を返します。 (DataGridColumn から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | FormatDataValue | 指定された値を DataFormatString プロパティで示されている書式に変換します。 |
| | LoadViewState | DataGridColumn オブジェクトの状態を読み込みます。 (DataGridColumn から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
| | OnColumnChanged | DataGridDesigner.OnColumnsChanged メソッドを呼び出します。 (DataGridColumn から継承されます。) |
| | SaveViewState | DataGridColumn オブジェクトの現在の状態を保存します。 (DataGridColumn から継承されます。) |
| | TrackViewState | サーバー コントロールにビューステートの変更を追跡させ、サーバー コントロールの System.Web.UI.StateBag オブジェクトに変更を格納できるようにします。 (DataGridColumn から継承されます。) |
参照- BoundColumnのページへのリンク
