Table of Contents

At a glance
Installation and deployment
DNN
Licensing
Already using the control
Functional overview
ASP.NET 2.0 Features
Getting Started
Grid columns
Grid rows
Defining Structure
Visible/Enabled conventions
Populating the control with data
AJAX
Sorting
Paging
Scrolling
Grouping
Filtering
Selecting grid items
Insert/Update/Delete records
Hierarchical grid types and Load modes
Design-time support
Controlling visual appearance
Localization/Accessibility
RadGrid export
The control lifecycle
Performance tips and tricks
Getting familiar with server-side API
Getting familiar with client-side API
Telerik RadGrid inheritance
How-to
Troubleshooting
Integration with other controls
Client-side API Reference
API Reference
- Telerik.RadGridUtils Namespace
- Telerik.WebControls Namespace
  - GridBaseDataList Class
  - GridBoolColumnEditor Class
  - GridBoundColumn Class
  - GridButtonColumn Class
  - GridCheckBoxColumn Class
  - GridCheckBoxColumnEditor Class
  - GridClientDeleteColumn Class
  - GridClientEvents Class
  - GridClientMessages Class
  - GridClientSelectColumn Class
  - GridClientSettings Class
  - GridColumn Class
  - GridColumnCollection Class
  - GridColumnCreatedEventArgs Class
  - GridColumnCreatingEventArgs Class
  - GridColumnEditorBase Class
  - GridColumnEditorException Class
  - GridColumnsReorderEventArgs Class
  - GridCommandEventArgs Class
  - GridCommandItem Class
  - GridCommandItemSettings Class
  - GridCreateColumnEditorEventArgs Class
  - GridDataChangeEventArgs Class
  - GridDataInsertItem Class
  - GridDataItem Class
  - GridDataItemCollection Class
  - GridDataKeyArray Class
  - GridDeletedEventArgs Class
  - GridDetailTableDataBindEventArgs Class
  - GridDropDownColumn Class
  - GridDropDownColumnEditor Class
  - GridDropDownListColumnEditor Class
  - GridEditableColumn Class
  - GridEditableItem Class
  - GridEditCommandColumn Class
  - GridEditFormInsertItem Class
  - GridEditFormItem Class
  - GridEditFormItem.EditFormTableCell Class
  - GridEditFormSettings Class
  - GridEditManager Class
  - GridException Class
  - GridExpandColumn Class
  - GridExportSettings Class
  - GridFilterFunction Class
  - GridFilterFunction.FunctionEntry Class
  - GridFilterFunction.StringFunctionEntry Class
  - GridFilteringException Class
  - GridFilteringItem Class
  - GridFilteringParamsException Class
  - GridFilterMenu Class
  - GridFooterItem Class
  - GridGroupByException Class
  - GridGroupByExpression Class
  - GridGroupByExpressionCollection Class
  - GridGroupByExpressionCollection.GridGroupByExpressionEnumerator Class
  - GridGroupByField Class
  - GridGroupHeaderItem Class
  - GridGroupingContext Class
  - GridGroupingSettings Class
  - GridGroupPanel Class
  - GridGroupPanelImageButton Class
  - GridGroupPanelStyle Class
  - GridGroupsChangingEventArgs Class
  - GridGroupSplitterColumn Class
  - GridHeaderItem Class
  - GridHierarchySettings Class
  - GridHyperLinkColumn Class
  - GridImage Class
  - GridImageButton Class
  - GridIndexCollection Class
  - GridInitializeEditFormContainer Class
  - GridInitializePagerItem Class
  - GridInsertedEventArgs Class
  - GridInsertionObject Class
  - GridItem Class
  - GridItemBuilder.GroupingHelperDataRow Class
  - GridItemBuilder.GroupingHelperDataTable Class
  - GridItemCollection Class
  - GridItemCreated Class
  - GridItemDataBound Class
  - GridItemEventArgs Class
  - GridItemEventInfo Class
  - GridMenuItem Class
  - GridMenuItemClickEventArgs Class
  - GridMenuItemCollection Class
  - GridMultiRowItem Class
  - GridNeedDataSourceEventArgs Class
  - GridNestedViewItem Class
  - GridNoRecordsItem Class
  - GridNotSupportedException Class
  - GridObjectWithState Class
  - GridPageChangedEventArgs Class
  - GridPagerItem Class
  - GridPagerStyle Class
  - GridPageSizeChangedEventArgs Class
  - GridPagingManager Class
  - GridPanelItemsStyle Class
  - GridPdfSettings Class
  - GridPostBackReferences Class
  - GridPropertyEvaluator Class
  - GridRelationFields Class
  - GridResizing Class
  - GridRowIndicatorColumn Class
  - GridScrolling Class
  - GridSelecting Class
  - GridSelfHierarchySettings Class
  - GridSortCommandEventArgs Class
  - GridSortExpression Class
  - GridSortExpressionCollection Class
  - GridSortingSettings Class
  - GridSplitGroup Class
  - GridStatusBarItem Class
  - GridStatusBarItemDecorator Class
  - GridStatusBarItemSettings Class
  - GridStringArrayConverter Class
  - GridTableCell Class
  - GridTableHeaderCell Class
  - GridTableItemStyle Class
  - GridTableRow Class
  - GridTableView Class
  - GridTableViewCollection Class
  - GridTableViewCollection.GridDataTableEnumerator Class
  - GridTableViewRelation Class
  - GridTableViewRelation.GridRelationFieldsEnumerator Class
  - GridTemplateColumn Class
  - GridTemplateColumnEditor Class
  - GridTextBoxColumnEditor Class
  - GridTextButton Class
  - GridTextColumnEditor Class
  - GridTFoot Class
  - GridTHead Class
  - GridUpdatedEventArgs Class
  - GridValidationSettings Class
  - GroupItemCell Class
  - RadGrid Class
    - Overview
    - Members
    - RadGrid Constructor
    - Methods
    - Properties
    - Fields
    - Events
  - IGridColumnEditor Interface
  - IGridCommandEvent Interface
  - IGridEditableColumn Interface
  - IGridInsertItem Interface
  - GridAggregateFunction Enumeration
  - GridButtonColumnType Enumeration
  - GridChildLoadMode Enumeration
  - GridClientSettings.GridColumnsReorderMethod Enumeration
  - GridCommandItemDisplay Enumeration
  - GridDataSourcePersistenceMode Enumeration
  - GridEditFormType Enumeration
  - GridEditMode Enumeration
  - GridExpandColumnType Enumeration
  - GridFilterListOptions Enumeration
  - GridForceExtractValues Enumeration
  - GridGroupLoadMode Enumeration
  - GridGroupsChangingAction Enumeration
  - GridGroupSplitMode Enumeration
  - GridHeaderButtonType Enumeration
  - GridItemType Enumeration
  - GridKnownFunction Enumeration
  - GridPagerMode Enumeration
  - GridPagerPosition Enumeration
  - GridPaperSize Enumeration
  - GridRebindReason Enumeration
  - GridResetPageIndexAction Enumeration
  - GridSortOrder Enumeration
  - GridTableFrame Enumeration
  - GridTableLayout Enumeration
  - GridTableTextDirection Enumeration
Need for help

RadGrid	Send comments on this topic.
GroupsChanging Event
See Also Example

Telerik.WebControls Namespace > RadGrid Class : GroupsChanging Event

Visual Basic (Declaration)
Visual Basic (Usage)
C#

Fires when a grouping action has been performed. For example when a column header was dragged in the GroupPanel.

Event Data

The event handler receives an argument of type GridGroupsChangingEventArgs containing data related to this event. The following GridGroupsChangingEventArgs properties provide information specific to this event.

Property	Description
Action	Gets a reference to GridGroupsChangingAction enumeration, which holds information about what action did fire the RadGrid.GroupsChanging event.
Canceled	Gets or sets a value indicating whether RadGrid.GroupsChanging event will be canceled.
Expression	Gets or sets the GridGroupByExpression that will be used for grouping Telerik RadGrid.
SortedField	Gets a reference to the currently used GridGroupByField.
SwapExpression
TableView	Gets a reference to the GridTableView object where the grouping is performed.

Namespace: Telerik.WebControls
Assembly: RadGrid (in RadGrid.dll)

Syntax

Visual Basic (Declaration)
Public Event GroupsChanging() As GridGroupsChangingEventHandler

Visual Basic (Usage)	Copy Code
`Dim instance As RadGrid Dim handler As GridGroupsChangingEventHandler AddHandler instance.GroupsChanging, handler`

C#
public event GridGroupsChangingEventHandler GroupsChanging()

Event Data

Property	Description
Action	Gets a reference to GridGroupsChangingAction enumeration, which holds information about what action did fire the RadGrid.GroupsChanging event.
Canceled	Gets or sets a value indicating whether RadGrid.GroupsChanging event will be canceled.
Expression	Gets or sets the GridGroupByExpression that will be used for grouping Telerik RadGrid.
SortedField	Gets a reference to the currently used GridGroupByField.
SwapExpression
TableView	Gets a reference to the GridTableView object where the grouping is performed.

Example

C# Copy Code

protected void RadGrid1_GroupsChanging(object source, Telerik.WebControls.GridGroupsChangingEventArgs e)

{
 //Expression is added (by drag/grop on group panel)



 if (e.Action == GridGroupsChangingAction.Group)

{

 if (e.Expression.GroupByFields[0].FieldName != "CustomerID")

 {

  GridGroupByField countryGroupField = new GridGroupByField();

  countryGroupField.FieldName = "Country";

  GridGroupByField cityGroupField = new GridGroupByField();

  cityGroupField.FieldName = "City";



  e.Expression.SelectFields.Clear();

  e.Expression.SelectFields.Add(countryGroupField);

  e.Expression.SelectFields.Add(cityGroupField);



  e.Expression.GroupByFields.Clear();

  e.Expression.GroupByFields.Add(countryGroupField);

  e.Expression.GroupByFields.Add(cityGroupField);

 }



}

}

Visual Basic Copy Code

Protected Sub RadGrid1_GroupsChanging(ByVal source As Object, ByVal e As Telerik.WebControls.GridGroupsChangingEventArgs)

 'Expression is added (by drag/grop on group panel)

  If (e.Action = GridGroupsChangingAction.Group) Then

  If (e.Expression.GroupByFields(0).FieldName <> "CustomerID") Then

   Dim countryGroupField As GridGroupByField = New GridGroupByField

   countryGroupField.FieldName = "Country"

   Dim cityGroupField As GridGroupByField = New GridGroupByField

   cityGroupField.FieldName = "City"

   e.Expression.SelectFields.Clear

   e.Expression.SelectFields.Add(countryGroupField)

   e.Expression.SelectFields.Add(cityGroupField)

   e.Expression.GroupByFields.Clear

   e.Expression.GroupByFields.Add(countryGroupField)

   e.Expression.GroupByFields.Add(cityGroupField)

  End If

 End If

End Sub

C# Copy Code

protected void RadGrid1_GroupsChanging(object source, Telerik.WebControls.GridGroupsChangingEventArgs e)

{
 //Expression is added (by drag/grop on group panel)



 if (e.Action == GridGroupsChangingAction.Group)

{

 if (e.Expression.GroupByFields[0].FieldName != "CustomerID")

 {

  GridGroupByField countryGroupField = new GridGroupByField();

  countryGroupField.FieldName = "Country";

  GridGroupByField cityGroupField = new GridGroupByField();

  cityGroupField.FieldName = "City";



  e.Expression.SelectFields.Clear();

  e.Expression.SelectFields.Add(countryGroupField);

  e.Expression.SelectFields.Add(cityGroupField);



  e.Expression.GroupByFields.Clear();

  e.Expression.GroupByFields.Add(countryGroupField);

  e.Expression.GroupByFields.Add(cityGroupField);

 }



}

}

Visual Basic Copy Code

Protected Sub RadGrid1_GroupsChanging(ByVal source As Object, ByVal e As Telerik.WebControls.GridGroupsChangingEventArgs)

 'Expression is added (by drag/grop on group panel)

  If (e.Action = GridGroupsChangingAction.Group) Then

  If (e.Expression.GroupByFields(0).FieldName <> "CustomerID") Then

   Dim countryGroupField As GridGroupByField = New GridGroupByField

   countryGroupField.FieldName = "Country"

   Dim cityGroupField As GridGroupByField = New GridGroupByField

   cityGroupField.FieldName = "City"

   e.Expression.SelectFields.Clear

   e.Expression.SelectFields.Add(countryGroupField)

   e.Expression.SelectFields.Add(cityGroupField)

   e.Expression.GroupByFields.Clear

   e.Expression.GroupByFields.Add(countryGroupField)

   e.Expression.GroupByFields.Add(cityGroupField)

  End If

 End If

End Sub

Remarks

You can use this event to set your own GridGroupByExpression when the user tries to group the grid.

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

RadGrid for ASP.NET

Event Data

Syntax

Event Data

Example

Remarks

Requirements

See Also

Reference