ASPxGridView.FindDetailRowTemplateControl(Int32, String) Method

Searches for the server control contained within the specified detail row‘s template.

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#
VB.NET

public Control FindDetailRowTemplateControl(
    int visibleIndex,
    string id
)

Public Function FindDetailRowTemplateControl(
    visibleIndex As Integer,
    id As String
) As Control

Parameters

Name	Type	Description
visibleIndex	Int32	An integer value that identifies the detail row.
id	String	A String value that identifies the control within the specified detail row.

Returns

Type	Description
Control	A Control object that represents the control contained within the specified detail row’s template.

Remarks

The page’s hierarchy does not contain controls inside a detail row if a master row is not expanded. In this case, the FindDetailRowTemplateControl method returns null.

To access controls within the Detail Row template for a collapsed master row, expand this master row before you call the FindDetailRowTemplateControl method.

C#
VB.NET


if (!ASPxGridViewMaster.DetailRows.IsVisible(ASPxGridViewMaster.FocusedRowIndex)) {                
    ASPxGridViewMaster.DetailRows.ExpandRow(ASPxGridViewMaster.FocusedRowIndex)
}


If Not ASPxGridViewMaster.DetailRows.IsVisible(ASPxGridViewMaster.FocusedRowIndex) Then
    ASPxGridViewMaster.DetailRows.ExpandRow(ASPxGridViewMaster.FocusedRowIndex)
End If

Example

This example shows how to select rows in a detail grid when the master row selection is changed.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-select-detail-rows-on-master-row-selection-e355

<%-- BeginRegion Page setup --%>
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="Grid_MasterDetail_SelectDetailRows_Default" %>
<%@ Register Assembly="DevExpress.Web.ASPxGridView.v8.1" Namespace="DevExpress.Web.ASPxGridView" TagPrefix="dxwgv" %>
<%@ Register Assembly="DevExpress.Web.ASPxEditors.v8.1" Namespace="DevExpress.Web.ASPxEditors" TagPrefix="dxe" %>
<%-- EndRegion --%>
<!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 select detail rows on master row selection</title>
</head>
<body>
    <form id="form1" runat="server">
        <script type="text/javascript">
            function master_RowSelecting(index, state) {
                master.PerformCallback("select|" + index + "|" + (state ? "T" : ""));
            }
        </script>
        <dxwgv:ASPxGridView ID="master" runat="server" AutoGenerateColumns="False" DataSourceID="masterData" KeyFieldName="CategoryID"
            ClientInstanceName="master" OnCustomCallback="master_CustomCallback">
            <SettingsDetail ShowDetailRow="True" />
            <Columns>
                <%-- BeginRegion Custom selection check --%>
                <dxwgv:GridViewDataColumn VisibleIndex="0">
                    <DataItemTemplate>
                        <input type="checkbox"
                            onclick="master_RowSelecting(<%# Container.VisibleIndex %>, checked)" 
                            <%# master.Selection.IsRowSelected(Container.VisibleIndex) ? "checked=\"checked\"" : "" %> />
                    </DataItemTemplate>
                </dxwgv:GridViewDataColumn>
                <%-- EndRegion --%>
                <dxwgv:GridViewDataTextColumn FieldName="CategoryID" ReadOnly="True" VisibleIndex="1">
                    <EditFormSettings Visible="False" />
                </dxwgv:GridViewDataTextColumn>
                <dxwgv:GridViewDataTextColumn FieldName="CategoryName" VisibleIndex="2">
                </dxwgv:GridViewDataTextColumn>
            </Columns>
            <%-- BeginRegion Templates --%>
            <Templates>
                <DetailRow>
                    <dxwgv:ASPxGridView ID="detail" runat="server" AutoGenerateColumns="False"
                        DataSourceID="detailData" KeyFieldName="ProductID" OnBeforePerformDataSelect="detail_BeforePerformDataSelect">
                        <Columns>
                            <dxwgv:GridViewCommandColumn ShowSelectCheckbox="true" VisibleIndex="0" />
                            <dxwgv:GridViewDataTextColumn FieldName="ProductID" ReadOnly="True" VisibleIndex="1">
                                <EditFormSettings Visible="False" />
                            </dxwgv:GridViewDataTextColumn>
                            <dxwgv:GridViewDataTextColumn FieldName="ProductName" VisibleIndex="2">
                            </dxwgv:GridViewDataTextColumn>
                            <dxwgv:GridViewDataTextColumn FieldName="UnitPrice" VisibleIndex="3">
                            </dxwgv:GridViewDataTextColumn>
                        </Columns>
                    </dxwgv:ASPxGridView>
                </DetailRow>
            </Templates>
            <%-- EndRegion --%>
        </dxwgv:ASPxGridView>

        <%-- BeginRegion DataSources --%>
        <asp:AccessDataSource ID="masterData" runat="server" DataFile="~/App_Data/nwind.mdb"
            SelectCommand="SELECT [CategoryID], [CategoryName] FROM [Categories]"></asp:AccessDataSource>            
        <asp:AccessDataSource ID="detailData" runat="server" DataFile="~/App_Data/nwind.mdb"
            SelectCommand="SELECT [ProductID], [ProductName], [UnitPrice] FROM [Products] WHERE CategoryID = ?">
            <SelectParameters>                
                <asp:Parameter Name="CategoryID" />                
            </SelectParameters>
        </asp:AccessDataSource>
        <%-- EndRegion --%>            
    </form>
</body>
</html>

using System;
using System.Data;
using System.Configuration;
using System.Collections;
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.ASPxGridView;

public partial class Grid_MasterDetail_SelectDetailRows_Default : System.Web.UI.Page {
    protected override void OnLoad(EventArgs e) {
        base.OnLoad(e);
        if(!IsPostBack) {
            master.DataBind();
            master.DetailRows.ExpandRow(0);
        }
    }

    protected void detail_BeforePerformDataSelect(object sender, EventArgs e) {
        detailData.SelectParameters["CategoryID"].DefaultValue = (sender as ASPxGridView).GetMasterRowKeyValue().ToString();
    }
    protected void master_CustomCallback(object sender, ASPxGridViewCustomCallbackEventArgs e) {        
        string[] data = e.Parameters.Split('|');
        if(data.Length == 3 && data[0] == "select")
            ProcessSelection(int.Parse(data[1]), data[2] == "T");        
    }

    void ProcessSelection(int index, bool state) {
        master.DataBind();
        master.Selection.SetSelection(index, state);
        ASPxGridView detail = master.FindDetailRowTemplateControl(index, "detail") as ASPxGridView;
        if(detail != null) {
            if(state)
                detail.Selection.SelectAll();
            else
                detail.Selection.UnselectAll();
        }
    }
}

<%-- BeginRegion Page setup --%>
<%@ Page Language="vb" AutoEventWireup="true" CodeFile="Default.aspx.vb" Inherits="Grid_MasterDetail_SelectDetailRows_Default" %>
<%@ Register Assembly="DevExpress.Web.ASPxGridView.v8.1" Namespace="DevExpress.Web.ASPxGridView" TagPrefix="dxwgv" %>
<%@ Register Assembly="DevExpress.Web.ASPxEditors.v8.1" Namespace="DevExpress.Web.ASPxEditors" TagPrefix="dxe" %>
<%-- EndRegion --%>
<!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 select detail rows on master row selection</title>
</head>
<body>
    <form id="form1" runat="server">
        <script type="text/javascript">
            function master_RowSelecting(index, state) {
                master.PerformCallback("select|" + index + "|" + (state ? "T" : ""));
            }
        </script>
        <dxwgv:ASPxGridView ID="master" runat="server" AutoGenerateColumns="False" DataSourceID="masterData" KeyFieldName="CategoryID"
            ClientInstanceName="master" OnCustomCallback="master_CustomCallback">
            <SettingsDetail ShowDetailRow="True" />
            <Columns>
                <%-- BeginRegion Custom selection check --%>
                <dxwgv:GridViewDataColumn VisibleIndex="0">
                    <DataItemTemplate>
                        <input type="checkbox"
                            onclick="master_RowSelecting(<%#Container.VisibleIndex%>, checked)" 
                            <%#IIf(master.Selection.IsRowSelected(Container.VisibleIndex), "checked=""checked""", "")%> />
                    </DataItemTemplate>
                </dxwgv:GridViewDataColumn>
                <%-- EndRegion --%>
                <dxwgv:GridViewDataTextColumn FieldName="CategoryID" ReadOnly="True" VisibleIndex="1">
                    <EditFormSettings Visible="False" />
                </dxwgv:GridViewDataTextColumn>
                <dxwgv:GridViewDataTextColumn FieldName="CategoryName" VisibleIndex="2">
                </dxwgv:GridViewDataTextColumn>
            </Columns>
            <%-- BeginRegion Templates --%>
            <Templates>
                <DetailRow>
                    <dxwgv:ASPxGridView ID="detail" runat="server" AutoGenerateColumns="False"
                        DataSourceID="detailData" KeyFieldName="ProductID" OnBeforePerformDataSelect="detail_BeforePerformDataSelect">
                        <Columns>
                            <dxwgv:GridViewCommandColumn ShowSelectCheckbox="true" VisibleIndex="0" />
                            <dxwgv:GridViewDataTextColumn FieldName="ProductID" ReadOnly="True" VisibleIndex="1">
                                <EditFormSettings Visible="False" />
                            </dxwgv:GridViewDataTextColumn>
                            <dxwgv:GridViewDataTextColumn FieldName="ProductName" VisibleIndex="2">
                            </dxwgv:GridViewDataTextColumn>
                            <dxwgv:GridViewDataTextColumn FieldName="UnitPrice" VisibleIndex="3">
                            </dxwgv:GridViewDataTextColumn>
                        </Columns>
                    </dxwgv:ASPxGridView>
                </DetailRow>
            </Templates>
            <%-- EndRegion --%>
        </dxwgv:ASPxGridView>

        <%-- BeginRegion DataSources --%>
        <asp:AccessDataSource ID="masterData" runat="server" DataFile="~/App_Data/nwind.mdb"
            SelectCommand="SELECT [CategoryID], [CategoryName] FROM [Categories]"></asp:AccessDataSource>            
        <asp:AccessDataSource ID="detailData" runat="server" DataFile="~/App_Data/nwind.mdb"
            SelectCommand="SELECT [ProductID], [ProductName], [UnitPrice] FROM [Products] WHERE CategoryID = ?">
            <SelectParameters>                
                <asp:Parameter Name="CategoryID" />                
            </SelectParameters>
        </asp:AccessDataSource>
        <%-- EndRegion --%>            
    </form>
</body>
</html>

Imports Microsoft.VisualBasic
Imports System
Imports System.Data
Imports System.Configuration
Imports System.Collections
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.ASPxGridView

Partial Public Class Grid_MasterDetail_SelectDetailRows_Default
    Inherits System.Web.UI.Page
    Protected Overrides Sub OnLoad(ByVal e As EventArgs)
        MyBase.OnLoad(e)
        If (Not IsPostBack) Then
            master.DataBind()
            master.DetailRows.ExpandRow(0)
        End If
    End Sub

    Protected Sub detail_BeforePerformDataSelect(ByVal sender As Object, ByVal e As EventArgs)
        detailData.SelectParameters("CategoryID").DefaultValue = (TryCast(sender, ASPxGridView)).GetMasterRowKeyValue().ToString()
    End Sub
    Protected Sub master_CustomCallback(ByVal sender As Object, ByVal e As ASPxGridViewCustomCallbackEventArgs)
        Dim data() As String = e.Parameters.Split("|"c)
        If data.Length = 3 AndAlso data(0) = "select" Then
            ProcessSelection(Integer.Parse(data(1)), data(2) = "T")
        End If
    End Sub

    Private Sub ProcessSelection(ByVal index As Integer, ByVal state As Boolean)
        master.DataBind()
        master.Selection.SetSelection(index, state)
        Dim detail As ASPxGridView = TryCast(master.FindDetailRowTemplateControl(index, "detail"), ASPxGridView)
        If detail IsNot Nothing Then
            If state Then
                detail.Selection.SelectAll()
            Else
                detail.Selection.UnselectAll()
            End If
        End If
    End Sub
End Class

The following code snippets (auto-collected from DevExpress Examples) contain references to the FindDetailRowTemplateControl(Int32, String) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

VB.NET
C#

master-detail-relationship-with-ilist-datasource-e1196/VB/WebSite/Default.aspx.vb#L28


Dim cntrl As ASPxPageControl = TryCast((CType(sender, ASPxGridView)).FindDetailRowTemplateControl(e.VisibleIndex, "ASPxPageControl1"), ASPxPageControl)

aspxgridview-how-to-manage-stored-files-of-different-types-e4645/VB/DevExpress.Upload/Default.aspx.vb#L105

Dim data_Renamed = FindData(id_Renamed)
Dim editor = grid.FindDetailRowTemplateControl(id_Renamed, "Editor")
UpdateFile(editor, data_Renamed.Name)

aspxgridview-how-to-manage-stored-files-of-different-types-e4645/CS/DevExpress.Upload/Default.aspx.cs#L92

var data = FindData(id);
var editor = grid.FindDetailRowTemplateControl(id, "Editor");
UpdateFile(editor, data.Name);

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

ASPxGridView.FindDetailRowTemplateControl(Int32, String) Method

Declaration

Parameters

Returns

Remarks

Example

ASPxGridView.FindDetailRowTemplateControl(Int32, String) Method

Declaration

Parameters

Returns

Remarks

Example

Related GitHub Examples