＠IT：.NET TIPS ［ASP.NET］DataGridコントロールの各セルにアクセスするには？

.NET TIPS

［ASP.NET］DataGridコントロールの各セルにアクセスするには？

デジタルアドバンテージ
2003/09/26

　DataGridコントロールは、表示したい列をaspxファイルで定義しておき、データ連結を行ってデータソースの要素を表形式で表示するというのが基本的な使用方法である。しかしデータ連結を行った後でも、グリッド内の各セルにアクセスし、セル内のテキストを変更したり、セルのプロパティを設定したりすることが可能だ。

DataGridコントロールを構成するオブジェクト

　グリッド内のセルにアクセスするには、データ連結後のDataGridコントロールを構成するオブジェクトについて把握しておく必要がある。

　まず、DataGridコントロールの各行はDataGridItemクラス（System.Web.UI.WebControls名前空間）のオブジェクトで表される。これはDataGridコントロール（DataGridクラス）のItemsプロパティからアクセス可能だ。Itemsプロパティは複数のDataGridItemオブジェクトを保持できるコレクション・クラスである。

　さらに、各行におけるセルは、DataGridItemオブジェクトのCellsプロパティからアクセスできる。Cellsプロパティは複数のセル（TableCellクラス（System.Web.UI.WebControls名前空間）のオブジェクト）を保持できるコレクション・クラスである。

　以上より、いまDataGridコントロールに付けたidを「MyGrid」とすると、グリッド上の各行（ヘッダー行は除く）には順に、

MyGrid.Items[0] MyGrid.Items[1] MyGrid.Items[2] ……

と記述して、また最初の行の各セルには、左から、

MyGrid.Items[0].Cells[0]、MyGrid.Items[0].Cells[1]、……

と記述してアクセスすることができる。これらをまとめて図示すると次のようになる。

DataGridコントロールを構成するオブジェクト

各行はDataGridItemオブジェクトにより表され、行内の各セルはTableCellオブジェクトにより表される。行数と列数はMyGrid.Items.CountとMyGrid.Columns.Countにより取得できる。

　図では、行数と列数を取得するためのMyGrid.Items.CountとMyGrid.Columns.Countも合わせて図示している。ColumnsプロパティはDataGridコントロールを構成する列のコレクションである。

　ちなみに、コレクション内の要素数を示すCountプロパティはICollectionインターフェイス（System.Collections名前空間）のメンバであり、コレクションとして機能するクラスの多くはこのインターフェイスを実装している。

　なお、DataGridクラスのItemsプロパティにはヘッダー行やフッター行が含まれない点に少し注意が必要だ。

各セルにアクセスするサンプル・プログラム

　DataGridコントロールの各セルにアクセスする例として、次のようなサンプル・プログラムを作成してみた。このプログラムは「TIPS：［ASP.NET］DataGridコントロールで特定のカラムのみを表示するには？」にある最初のサンプル・プログラム（bounddg1.aspx）をベースにしている。

グラデーションでグリッドを表示するサンプル・プログラム（graddg.aspx）の実行結果

graddg.aspxの実行（www.iwebmethod.netのページ）

　プログラムのソース・コードは次のようになっている。太字で示した部分は、ベースとなっているプログラムに追加したコードで、今回のポイントとなる部分だ。

<%@ Page Language="C#" EnableViewState="false" %>

<%@ Import Namespace="System.Data" %>

<%@ Import Namespace="System.Drawing" %>



<html>

<head>

  <script runat="server">

    void Page_Load(object sender, EventArgs e) {

      DataSet ds = new DataSet();

      ds.ReadXml("http://www.atmarkit.co.jp/rss/fdotnet/rss2dc.xml");



      MyGrid.DataSource = ds.Tables["item"];

      MyGrid.DataBind();



      int inc = 255 / (MyGrid.Items.Count - 1);



      for (int y = 0; y < MyGrid.Items.Count; y++) {

        Color argb = Color.FromArgb(255, inc * y, 0);

        MyGrid.Items[y].BackColor = argb;



        MyGrid.Items[y].Cells[0].Text = argb.ToString();

      }

    }



  </script>

</head>



<body>

  <form runat="server">

    <asp:DataGrid id="MyGrid"

        AutoGenerateColumns="false"

        runat="server" >



      <Columns>

        <asp:BoundColumn HeaderText="背景色" />

        <asp:BoundColumn

            DataField="title" HeaderText="タイトル" />

        <asp:BoundColumn

            DataField="description" HeaderText="概要" />

      </Columns>



    </asp:DataGrid>

  </form>

</body>

</html>

グラデーションでグリッドを表示するC#のサンプル・プログラム（graddg.aspx）

graddg.aspxのダウンロード

　各セルにアクセスするコーディングとしては、各行に対してデータ連結直後に発生するItemDataBoundイベントを使用する方法もあるが、データソースの各要素データに直接アクセスする必要がなければ、DataBindメソッド呼び出し後で十分だろう。

　このプログラムでは、DataBindメソッド呼び出し後に、各行の背景色を赤から黄色へのグラデーションで描画し、さらにはその背景色の色情報を第1列に書き込んでいる。この2点について次に解説する。

行の背景色を設定するには

　DataGridコントロールの各行を表すDataGridItemオブジェクトには、その背景色をBackColorプロパティにより設定できる。

　このBackColorプロパティはColor構造体（System.Drawing名前空間）のオブジェクトであるため、Color構造体のstaticなメソッドであるFromArgbメソッドを使用して、赤、緑、青の3つの値（0～255）により背景色を指定可能である。これによりグラデーションのための個々の色を作り出すのは容易だ。上記のサンプル・プログラムでは、赤（255、0、0）から黄色（255、255、0）までの範囲で、緑色を示す2番目の値を少しずつ変化させながら背景色を設定している。

セルのテキストを設定するには

　DataGridコントロールの各セルに表示されるテキストは、TableCellオブジェクトのTextプロパティで読み書き可能だ。例えばグリッド内の左上隅のセルのテキストは次のような記述でアクセスできる。

MyGrid.Items[0].Cells[0].Text

　データ連結後はデータソースの各要素がテキスト化され、このTextプロパティにセットされている。各セルに直接アクセスすることにより、このテキストを取得したり、書き換えたりすることも可能だ。

　さて上記のサンプル・プログラムでは、背景色の色情報を表示するための列が必要なため、あらかじめ次のようにしてヘッダー行に表示される文字列だけを指定した連結列を準備している。上書きしてしまうのでどのような列でもよいのだが、<asp:BoundColumn>要素を使用するのが一番シンプルな記述だろう。

<Columns> <asp:BoundColumn HeaderText="背景色" /> …… </Columns>

　この要素にはDataField属性によりデータソースのフィールドを指定していないため、データ連結を行っても列には何も表示されない。

　セルの背景色を設定した後、サンプル・プログラムでは次のようにして、空の列に背景色の色情報をテキストとして書き込んでいる。

MyGrid.Items[y].Cells[0].Text = argb.ToString();

　Color構造体のToStringメソッドは、オブジェクトに設定されている色を、

Color [A=XXX, R=XXX, G=XXX, B=XXX]

の形式でテキスト化することができる。

カテゴリ：Webフォーム　処理対象：DataGridコントロール
使用ライブラリ：DataGridコントロール
使用ライブラリ：DataGridItemクラス（System.Web.UI.WebControls名前空間）
使用ライブラリ：TableCellクラス（System.Web.UI.WebControls名前空間）
使用ライブラリ：ICollectionインターフェイス（System.Collections名前空間）
使用ライブラリ：Color構造体（System.Drawing名前空間）
使用ライブラリ：<asp:BoundColumn>要素
関連TIPS：［ASP.NET］DataGridコントロールでデータセットを表示するには？

この記事と関連性の高い別の.NET TIPS

		［ASP.NET］DataGridコントロールのヘッダーを結合するには？
		［ASP.NET］DataGridコントロールでテンプレート列のセルの値を取得するには？
		［ASP.NET］DataGridコントロールのヘッダーを複数行にするには？
		［ASP.NET］DataGridコントロールの同一列内のセルを結合するには？
		DataGridコントロールで入力中のセルをハイライト表示するには？
		［ASP.NET］DataGridコントロールですべての行にアクセスするには？
		［ASP.NET］DataGridコントロールのヘッダーにソートされた方向を表示するには？

このリストは、（株）デジタルアドバンテージが開発した
自動関連記事探索システム Jigsaw（ジグソー）により自動抽出したものです。

generated by

「.NET TIPS」

TechTargetジャパン

Insider.NET フォーラム新着記事

新人プログラマーのためのInsider.NETの歩き方 2012 （2012/5/22）
　晴れて.NETプログラマーとなる新人が効率的に開発技術を習得するには？大量にある記事群の中から新人が読むべきお勧めを厳選して紹介
jQuery MobileでJavaScriptプログラミング （2012/5/17）
　jQuery Mobileは手軽なだけでなく、JavaScriptのAPIも充実しており、独自機能の実装もできる。今回は「グローバル設定」と「イベント」を解説
Windows上で開発するための開発環境構築入門 （2012/5/16）
　Windowsを使ってチームで開発している？なのにサーバOSを設定・運用した経験がない？そうなら、今すぐ学ぼう
「コントラクト」でアプリのサンドボックスを乗り越える！ （2012/5/11）
　Metroスタイル・アプリはサンドボックスの中で動作する。それを乗り越えてほかのアプリと連携する仕組み「コントラクト」を解説

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）

RSSフィード

＠IT 新着記事

キャリアアップ

- PR -

＠IT Sepcial

＠IT Special ヘ

イベントカレンダー

PickUpイベント

- PR -

アクセスランキング

ニュース一覧へ

- PR -

お勧め求人情報

転職／派遣情報を探す

エンジニアの求人情報、ただいま増加中
【転職サーチ】SIer／Web企業／新規事業
スマホ開発で、あなたのキャリアを生かす

派遣エンジニアにお役立ちの仕事情報
「派遣・フリーで働くメリット」とは？
活躍する派遣エンジニアの本音

エンジニアのキャリア実現を応援します

ITトレメ「ビジネス基礎」シリーズ開始
「マナー＆コミュニケーション編」「法律・知財・債権管理編」

＊先週の人気講座ランキング＊
～ Android編～

ホワイトペーパー（TechTargetジャパン）