GridViewTemplates.GroupRowContent Property

Gets or sets a template for displaying the content of group rows.

Assembly: DevExpress.Web.v19.2.dll

Declaration

C#
VB.NET

[DefaultValue(null)]
public virtual ITemplate GroupRowContent { get; set; }

<DefaultValue(Nothing)>
Public Overridable Property GroupRowContent As ITemplate

Property Value

Type	Default	Description
ITemplate	null	An object that implements the ITemplate interface.

Remarks

Note

Once a template defined via the GroupRowContent property is created within a grid control, it is instantiated within a container object of the GridViewGroupRowTemplateContainer type. This container object exposes a set of specific properties to which the template’s child controls can be bound.

Example

This example demonstrates how to expand/collapse grid groups on selecting/unselecting ASPxCheckBox.First, place ASPxCheckBox and ASPxLabel into the Grid.Templates.GroupRowContent template.

Second, set the ASPxCheckBox.Checked property and the client-side CheckedChanged event in the ASPxCheckBox.Init event handler.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-use-the-aspxcheckbox-for-expand-and-collapse-aspxgridview-groups-e2325

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>

<%@ Register Assembly="DevExpress.Web.ASPxGridView.v10.1, Version=10.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a"
    Namespace="DevExpress.Web.ASPxGridView" TagPrefix="dx" %>
<%@ Register Assembly="DevExpress.Web.ASPxEditors.v10.1, Version=10.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a"
    Namespace="DevExpress.Web.ASPxEditors" TagPrefix="dx" %>
<!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">
<head runat="server">
    <title>How to use the ASPxCheckBox for expand and collapse ASPxGridView groups</title>

    <script type="text/javascript">
        function ExpandCollapse(sender, index) {
            if (sender.GetChecked())
                grid.ExpandRow(index);
            else
                grid.CollapseRow(index);
        }
    </script>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <dx:ASPxGridView ID="ASPxGridView1" runat="server" ClientInstanceName="grid" AutoGenerateColumns="False" DataSourceID="AccessDataSource1"
                KeyFieldName="ProductID">
                <Columns>
                    <dx:GridViewDataTextColumn FieldName="ProductID" ReadOnly="True" VisibleIndex="0">
                        <EditFormSettings Visible="False" />
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="ProductName" VisibleIndex="1">
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="CategoryID" VisibleIndex="2" GroupIndex="0" SortIndex="0" SortOrder="Ascending">
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="UnitPrice" VisibleIndex="3">
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="UnitsInStock" VisibleIndex="4">
                    </dx:GridViewDataTextColumn>
                </Columns>
                <Templates>
                    <GroupRowContent>
                        <dx:ASPxCheckBox ID="ASPxCheckBox1" runat="server" OnInit="ASPxCheckBox1_Init">
                        </dx:ASPxCheckBox>
                        <%# Container.GroupText + Container.KeyValue%>
                    </GroupRowContent>
                </Templates>
                <Settings ShowGroupButtons="False" ShowGroupPanel="True" />
            </dx:ASPxGridView>
            <asp:AccessDataSource ID="AccessDataSource1" runat="server" DataFile="~/App_Data/nwind.mdb"
                SelectCommand="SELECT [ProductID], [ProductName], [CategoryID], [UnitPrice], [UnitsInStock] FROM [Products]">
            </asp:AccessDataSource>
            &nbsp;&nbsp;
        </div>
    </form>
</body>
</html>

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using DevExpress.Web.ASPxEditors;
using DevExpress.Web.ASPxGridView;

public partial class _Default : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {

    }
    protected void ASPxCheckBox1_Init(object sender, EventArgs e)
    {
        ASPxCheckBox cb = sender as ASPxCheckBox;
        GridViewGroupRowTemplateContainer container = cb.NamingContainer as GridViewGroupRowTemplateContainer;
        if (ASPxGridView1.IsRowExpanded(container.VisibleIndex))
            cb.Checked = true;
        cb.ClientSideEvents.CheckedChanged = string.Format("function (s, e) {{ ExpandCollapse(s, {0}); }}", container.VisibleIndex);
    }
}

<%@ Page Language="vb" AutoEventWireup="true" CodeFile="Default.aspx.vb" Inherits="_Default" %>

<%@ Register Assembly="DevExpress.Web.ASPxGridView.v10.1, Version=10.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a"
    Namespace="DevExpress.Web.ASPxGridView" TagPrefix="dx" %>
<%@ Register Assembly="DevExpress.Web.ASPxEditors.v10.1, Version=10.1.4.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a"
    Namespace="DevExpress.Web.ASPxEditors" TagPrefix="dx" %>
<!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">
<head runat="server">
    <title>How to use the ASPxCheckBox for expand and collapse ASPxGridView groups</title>

    <script type="text/javascript">
        function ExpandCollapse(sender, index) {
            if (sender.GetChecked())
                grid.ExpandRow(index);
            else
                grid.CollapseRow(index);
        }
    </script>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <dx:ASPxGridView ID="ASPxGridView1" runat="server" ClientInstanceName="grid" AutoGenerateColumns="False" DataSourceID="AccessDataSource1"
                KeyFieldName="ProductID">
                <Columns>
                    <dx:GridViewDataTextColumn FieldName="ProductID" ReadOnly="True" VisibleIndex="0">
                        <EditFormSettings Visible="False" />
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="ProductName" VisibleIndex="1">
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="CategoryID" VisibleIndex="2" GroupIndex="0" SortIndex="0" SortOrder="Ascending">
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="UnitPrice" VisibleIndex="3">
                    </dx:GridViewDataTextColumn>
                    <dx:GridViewDataTextColumn FieldName="UnitsInStock" VisibleIndex="4">
                    </dx:GridViewDataTextColumn>
                </Columns>
                <Templates>
                    <GroupRowContent>
                        <dx:ASPxCheckBox ID="ASPxCheckBox1" runat="server" OnInit="ASPxCheckBox1_Init">
                        </dx:ASPxCheckBox>
                        <%#Container.GroupText + Container.KeyValue%>
                    </GroupRowContent>
                </Templates>
                <Settings ShowGroupButtons="False" ShowGroupPanel="True" />
            </dx:ASPxGridView>
            <asp:AccessDataSource ID="AccessDataSource1" runat="server" DataFile="~/App_Data/nwind.mdb"
                SelectCommand="SELECT [ProductID], [ProductName], [CategoryID], [UnitPrice], [UnitsInStock] FROM [Products]">
            </asp:AccessDataSource>
            &nbsp;&nbsp;
        </div>
    </form>
</body>
</html>

Imports Microsoft.VisualBasic
Imports System
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls
Imports DevExpress.Web.ASPxEditors
Imports DevExpress.Web.ASPxGridView

Partial Public Class _Default
    Inherits System.Web.UI.Page
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    End Sub
    Protected Sub ASPxCheckBox1_Init(ByVal sender As Object, ByVal e As EventArgs)
        Dim cb As ASPxCheckBox = TryCast(sender, ASPxCheckBox)
        Dim container As GridViewGroupRowTemplateContainer = TryCast(cb.NamingContainer, GridViewGroupRowTemplateContainer)
        If ASPxGridView1.IsRowExpanded(container.VisibleIndex) Then
            cb.Checked = True
        End If
        cb.ClientSideEvents.CheckedChanged = String.Format("function (s, e) {{ ExpandCollapse(s, {0}); }}", container.VisibleIndex)
    End Sub
End Class

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

GridViewTemplates.GroupRowContent Property

Declaration

Property Value

Remarks

Example