Tweet

.NET TIPS ［ASP.NET］DataGridコントロールでテンプレート列のセルの値を取得するには？ デジタルアドバンテージ 2003/11/21

　DataGridコントロールのセルに表示されているテキストの取得方法は、定義している列の種類によって異なることがある。まず次のサンプル・プログラムを見ていただきたい。

　このプログラムでは、連結列とテンプレート列を使用してデータソースの同じフィールド「Year」を表示している。実行結果は次の画面のようになる。

サンプル・プログラムの実行画面

　ここまでは特に問題ない。次にデータ連結されたグリッドのセルに表示されているテキストの取得について考えてみよう。例えば、次の2行をサンプル・プログラム中の「MyGrid.DataBind();」の後に追加したとき、それぞれどのような値が表示されるだろうか？

Response.Write(MyGrid.Items[0].Cells[0].Text);
Response.Write(MyGrid.Items[0].Cells[1].Text);


　最初の行では、連結列により作成されたセルのテキストを表示しようとしており、これは正しく「2003」を出力する。問題は2行目で、この行は何も出力しない。これは、テンプレート列の場合には、セル（TableCellオブジェクト）のTextプロパティからそのテキストを取得できないということを示している。

テンプレート列のDataBoundLiteralControlオブジェクト

　セルのTextプロパティからテキストを取得できない理由は、次のように@PageディレクティブにTrace="true"属性を追加してからプログラムを実行し、ページを構成するコントロールのツリーを見れば分かる。

<%@ Page Language="C#" Trace="true" %>

サンプル・プログラムのコントロール・ツリー

@PageディレクティブにTrace="true"属性を追加すると表示される。

連結列により作成されたTableCellオブジェクト 　 テンプレート列によりTableCellオブジェクトの子コントロールとして作成されたDataBoundLiteralControlオブジェクト

　ツリーから分かるように、テンプレート列によるセルにはDataBoundLiteralControlクラス（System.Web.UI名前空間）のオブジェクトが含まれている。このオブジェクトは、DataGridコントロールでデータ連結式（<%# …… %>）を記述したときに作成される文字列表示のためのコントロールである。

　つまり、連結列ではTableCellオブジェクトのTextプロパティによりテキストが設定されているのに対して、テンプレート列ではTableCellオブジェクトの子コントロールとしてDataBoundLiteralControlオブジェクトが作成され、そのTextプロパティによってテキストが表示されるということだ。

　よって、上述した2番目のResponse.Writeメソッドは、正しくは次のように記述しなくてはならない。

DataBoundLiteralControl literal
  = (DataBoundLiteralControl)MyGrid.Items[0].Cells[1].Controls[0];
Response.Write(literal.Text);


　これは正しく「2003」を表示する。

Labelコントロールを使用したテンプレート列

　テンプレート列でDataBoundLiteralControlオブジェクトが作成されるのは、データ連結式を<ItemTemplate>要素に直接記述した場合である。

　テンプレート列で項目を表示するには、次のようなLabelコントロールを含んだテンプレート列を記述してもよい。

  <asp:TemplateColumn HeaderText="テンプレート列">
    <ItemTemplate>
      <asp:Label id="GridLabel"
          Text='<%# DataBinder.Eval(Container.DataItem, "Year") %>'
          runat="server" />
    </ItemTemplate>
  </asp:TemplateColumn>

　このようにテンプレート列にコントロールを埋め込む場合には、そのid属性によりコントロールに名前を付けられるので、次のようにしてFindControlメソッドによりコントロールにアクセスできる。

Label label = (Label)MyGrid.Items[0].FindControl("GridLabel");
Response.Write(label.Text);


　なお、テキスト表示だけならLabelコントロールの代わりにLiteralコントロールも使用可能である。

この記事と関連性の高い別の.NET TIPS ［ASP.NET］DataGridコントロールの各セルにアクセスするには？ ［ASP.NET］DataGridコントロールの同一列内のセルを結合するには？ ［ASP.NET］DataGridコントロールの行に通し番号を付けるには？ ［ASP.NET］DataGridコントロールのヘッダーを複数行にするには？ ［ASP.NET］DataGridコントロールのヘッダーを結合するには？ このリストは、（株）デジタルアドバンテージが開発した 自動関連記事探索システム Jigsaw（ジグソー） により自動抽出したものです。 generated by

「.NET TIPS」

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

RSSフィード