使用ComponentArt Grid的服务器端模板

ComponentArt Grid用法三  

2009-09-24 09:34:54|  分类：默认分类 |  标签：|字号大中小 订阅

使用ComponentArt Grid的服务器端模板

通过它的不同的用户个性化定制特征，ComponentArt Grid包括服务器控件对内部内容使用服务器模板的正常能力，这篇文章概述了表格使用服务器端模板的典型用法，同时也指出了开发者可以获得的这些功能支持的事件和方法

在选择使用服务器段模板之前，必须保证读过一遍Web.UI控件模板概述。可能客户端模板更适合你的程序

概述

ComponentArt Grid中的服务器端模板专门用于模板化数据元素。他们允许任何服务器端元素绑定到表格的数据。最主要的，它使表格元素能够包含服务器端控件的能力，能够产生服务器端事件，保持状态和执行其他服务器端逻辑

定义服务器端模板

在服务器端模板能够用于表格之前，我们必须在它的ServerTemplates块中定义

<ServerTemplates>

    ...

    <ComponentArt:GridServerTemplate ID="LabelTemplate" />

     <Template>

        <asp:Label runat="server" ID="myLabel" BorderWidth="2" Text="<%# Container.DataItem["FullName"] %>" />

      </Template>

    </ComponentArt:GridServerTemplate>

</ServerTemplates>

上例会在调用此模板的元素中呈现一个有两像素边框、包含fullname字段的标签

要连接定义的模板到表格列，只要简单的设定GridColumn的DataCellServerTemplateId到你要使用的服务器模板的ID：

<ComponentArt:GridColumn ... DataCellServerTemplateId="LabelTemplate" />

注意：数据绑定表达式的语法与你可能用过的语法有一些不同。不需要使用DataBinder.Eval来得到表达式。Container.DataItem总是指向模板绑定的GridItem (数据行)，你可以简单的使用GridItem的字符串索引来引用行内部的字段

使用ItemDataBound事件

ComponentArt Grid具有对被绑定在一个GridItem上的服务器模板起作用的能力.这个事件是 ItemDataBound事件,它的参数包括模板示例的内容和所包含在的GridItem，这给了开发者一个机会来在页面被呈现前操纵内部

下面是一个典型的用在Grid中的ItemDataBound实例

1.为列设置服务器端模板

<ComponentArt:GridColumn ... DataCellServerTemplateId="myTemplate" />

定义你要用的模板

<ServerTemplates>

    ...

    <ComponentArt:GridServerTemplate ID="myTemplate" />

      <Template>

        Here is a button:<br>

        <asp:Button ID="myButton" runat="server"

          Text="<%# Container.DataItem["Name"] %>" />

      </Template>

    </ComponentArt:GridServerTemplate>

</ServerTemplates>

后置代码中的添加委托 :

private void InitializeComponent()

{

    ...

    Grid1.ItemDataBound += new Grid.ItemDataBoundEventHandler(Grid1_ItemDataBound);

}

定义处理程序:

private void Grid1_ItemDataBound(object sender, GridItemDataBoundEventArgs args)

{

    // We can modify the content...

    args.Content.Controls.Add(new LiteralControl("Manipulated!"));

    // reference individual control instances...

    Button myButton = (Button)args.Content.FindControl("myButton");

    // or perform other logic based on the instantiated content.

    Response.Write("Instantiated " + myButton.UniqueID +

      " for item " + args.Item["Name"];

}

使用ItemCommand事件

ComponentArt Grid能够响应植入在内部的服务器模板产生的事件,这个事件就是 ItemCommand,它的参数包括引发事件的控件和模板所属的行(GridItem).

下面是一个典型的用在Grid中的ItemCommand实例

1.为列设置放置可以触发事件的控件的服务器端模板

<ComponentArt:GridColumn ... DataCellServerTemplateId="linkButtonTemplate" />

定义你要用的模板:

<ServerTemplates>

    ...

    <ComponentArt:GridServerTemplate ID="linkButtonTemplate" />

      <Template>

        <asp:LinkButton ID="lb" runat="server"

          Text="ItemCommand" CommandName="MyCommand" />

      </Template>

    </ComponentArt:GridServerTemplate>

</ServerTemplates>

添加事件委托到后置代码

private void InitializeComponent()

{

   ...

    Grid1.ItemCommand += new Grid.ItemCommandEventHandler(Grid1_ItemCommand);

}

定义事件处理程序:

public void Grid1_ItemCommand(object sender, GridItemCommandEventArgs args)

{

    Response.Write("Command " + ((LinkButton)args.Control).CommandName +

      " issued on item " + args.Item["ID"]);

}

获得模板实例内部控件的引用

为获得模板实例内部控件的引用,表格控件提供了一个对FindControl方法的重写. Grid.FindControl能够取得4个参数:层级编号(level index),列编号,行编号,和空间ID.这个调用能够通过给定的层级,行,列,元素ID找到控件

例如,下面的调用能够找到第一层第三列第七行的模板内的控件"myButton"

Button myButton = (Button)Grid.FindControl(0, 3, 7, "myButton");

为了更好的使用FindControl重写,我们可以使用GridColumnCollection和 GridItemCollection的IndexOf方法.这样,我们可以通过列的DataField和与行匹配的值找回行号和列号

int columnIndex = Grid.Levels[0].Columns.IndexOf("Summary");

int itemIndex = Grid.Items.IndexOf("UniqueID", 3984);

Button myButton = (Button)Grid.FindControl(0, columnIndex, itemIndex, "myButton");