Back to Devexpress

DxGrid Members

blazor-devexpress-dot-blazor-dot-dxgrid-dot-underscore-members.md

latest39.6 KB
Original Source

DxGrid Members

A component that displays data in a tabular format and allows users to edit, sort, group, filter, and otherwise shape data.

Constructors

NameDescription
DxGrid()Initializes a new instance of the DxGrid class.

Properties

NameDescription
AllowColumnReorderSpecifies whether users can reorder columns.
AllowDragRowsSpecifies whether users can start the row drag operation.
AllowedDropTargetSpecifies allowed drag-and-drop targets.
AllowGroupSpecifies whether users can group grid data.
AllowSelectRowByClickSpecifies whether users can select and deselect rows by mouse clicks, tap gestures, and keyboard shortcuts.
AllowSortSpecifies whether users can sort grid data.
AttributesSpecifies a collection of standard HTML attributes applied to the Grid.
AutoCollapseDetailRowSpecifies whether an expanded detail row should be automatically collapsed when a user expands another detail row.
AutoExpandAllGroupRowsSpecifies whether to expand all group rows automatically when the grid loads data or users interact with the grid.
ColumnCaptionAlignmentSpecifies the alignment of all column captions.
ColumnFooterTemplateSpecifies a common template used to display all footer cells in the Grid.
ColumnGroupFooterTemplateSpecifies a common template for all group footer cells in the Grid.
ColumnHeaderCaptionTemplateSpecifies a common template used to display captions of all column headers in the Grid.
ColumnResizeModeSpecifies whether and how users can resize Grid columns.
ColumnsAllows you to add Grid columns.
ContextMenusSpecifies available context menus.
CssClassAssigns a CSS class to the Grid.
CustomValidatorsAllows you to declare custom validator components.
DataSpecifies an object that supplies Grid data.
DataColumnCellDisplayTemplateSpecifies a common template used to display all data column cells in the Grid.
DataColumnCellEditTemplateAllows you to replace automatically generated editors with custom content in all edit cells displayed for data columns.
DataColumnFilterMenuTemplateSpecifies a common template used to display all column filter menus in the Grid.
DataColumnFilterRowCellTemplateAllows you to replace automatically generated editors with custom content in all filter row cells displayed for data columns.
DataColumnGroupRowTemplateSpecifies a common template used to display all group rows in the Grid.
DetailExpandButtonDisplayModeSpecifies when to display master-detail expand buttons.
DetailRowDisplayModeSpecifies when to display detail rows in the Grid.
DetailRowTemplateSpecifies a template used to display a detail row.
DragHintTextTemplateSpecifies the template for the drag hint.
DropTargetModeSpecifies the drop position behavior. Applicable only to drag and drop operations initiated externally.
EditFormButtonsVisibleSpecifies whether the edit form contains the predefined Save and Cancel buttons.
EditFormTemplateSpecifies the template used to display the edit form.
EditModeSpecifies how users edit Grid data.
EditNewRowPositionSpecifies the position of UI elements used to create new rows.
EditOnKeyPressIn EditCell mode, specifies whether cell editing starts once a user begins typing a new value.
EditorRenderModeSpecifies how the Grid renders editors in the filter row and in data rows during edit operations.
EmptyDataAreaTemplateSpecifies the template used to display an empty data area.
EnterKeyDirectionIn EditCell mode, specifies where focus moves after a user presses Enter.
FilterBuilderTemplateSpecifies a template for the filter builder.
FilterMenuButtonDisplayModeSpecifies when the Grid displays filter menu buttons in column headers.
FilterPanelDisplayModeSpecifies the filter panel visibility.
FocusedRowEnabledSpecifies whether the row focus is enabled.
FooterDisplayModeSpecifies when to display the footer in the Grid.
GroupFooterDisplayModeSpecifies when to display group footers in the Grid.
GroupSummaryContains group summary items.
HighlightRowOnHoverSpecifies whether to highlight a data row when a user hovers the mouse pointer over it.
KeyboardNavigationEnabledObsolete. This property is now obsolete because the Grid component activates keyboard navigation and built-in shortcuts by default. Do not use this property in your project.
KeyFieldNameSpecifies the name of a data field that contains unique identifiers for Grid data items.
KeyFieldNamesSpecifies the names of data fields that contain key values. The combination of key values forms a unique identifier for a Grid data item.
PageIndexSpecifies the active page index.
PagerAutoHideNavButtonsSpecifies whether arrow navigation buttons are hidden when all numeric buttons are displayed in the pager.
PagerNavigationModeSpecifies how users navigate between Grid pages.
PagerPositionSpecifies the pager position.
PagerSwitchToInputBoxButtonCountSpecifies the number of pages when the pager switches from numeric buttons to the input box in Auto mode.
PagerVisibleSpecifies whether the Grid displays the pager.
PagerVisibleNumericButtonCountSpecifies the maximum number of numeric buttons displayed in the pager.
PageSizeSpecifies the maximum number of rows displayed on a page.
PageSizeSelectorAllRowsItemVisibleSpecifies whether the page size selector contains the All item.
PageSizeSelectorItemsSpecifies items available in the page size selector.
PageSizeSelectorVisibleSpecifies whether the Grid displays the page size selector in the pager.
PopupEditFormCssClassAssigns a CSS class to the pop-up edit form.
PopupEditFormHeaderTextSpecifies text displayed in the pop-up edit form’s header.
SearchBoxInputDelaySpecifies the time interval between the last typed character in the search box and the consequent search text update.
SearchBoxNullTextSpecifies the prompt text displayed in the search box when it is empty.
SearchBoxTemplateSpecifies a template for the search box.
SearchTextSpecifies the text that the Grid uses to filter and highlight data.
SearchTextParseModeSpecifies how the grid treats search words.
SelectAllCheckboxModeSpecifies whether the Select All checkbox selects all rows on the current page or on all grid pages.
SelectedDataItemIn single selection mode, this property specifies the data item that corresponds to the selected Grid row.
SelectedDataItemsIn multiple selection mode, this property specifies data items that corresponds to selected Grid rows.
SelectionModeSpecifies selection mode.
ShowAllRowsSpecifies whether the Grid displays all rows on one page. To avoid performance issues when the Grid is bound to a large data source, use the VirtualScrollingEnabled property instead.
ShowFilterRowSpecifies whether the Grid displays the filter row.
ShowGroupedColumnsSpecifies whether to display grouped columns with other columns in the grid’s data area.
ShowGroupPanelSpecifies whether to show the Group Panel.
ShowSearchBoxSpecifies whether the Grid displays the search box.
SizeModeSpecifies the size of grid elements (for instance, text size and row height) and other built-in grid components (for instance, pager and buttons).
SkeletonRowsEnabledSpecifies whether the Grid displays skeletons while it loads data.
TextWrapEnabledSpecifies whether the Grid wraps words or trims extra words and displays an ellipsis.
ToolbarTemplateSpecifies a template for a toolbar area.
TotalSummaryContains total summary items.
ValidationEnabledSpecifies whether the Grid validates user input in DevExpress data editors located in the edit form or edit cells.
VirtualScrollingEnabledSpecifies whether virtual scrolling is enabled.
VirtualScrollingModeWhen VirtualScrollingEnabled is set to true, specifies whether the Grid virtualizes rows, columns, or both.

Methods

NameDescription
AutoFitColumnWidths()Adjusts column widths to their content.
AutoFitColumnWidths(Boolean)Obsolete. Automatically adjusts column widths to their content.
BeginUpdate()Suspends Grid updates caused by parameter changes and method calls until the EndUpdate() method is called.
CancelEditAsync()Cancels row editing and discards changes.
ClearFilter()Clears the filter applied to grid data.
ClearSelection()Clears selection.
ClearSort()Clears sorting and ungroups columns.
CollapseAllDetailRows()Collapses all detail rows.
CollapseAllGroupRows()Collapses all group rows.
CollapseDetailRow(Int32)Collapses the specified detail row.
CollapseGroupRow(Int32, Boolean)Collapses a group row with the specified visible index.
DeselectAllAsync()Deselects all rows in the grid.
DeselectAllOnPage()Deselects all rows on the current visible page.
DeselectDataItem(Object)Deselects a row that corresponds to the specified data item.
DeselectDataItems(IEnumerable<Object>)Deselects rows that correspond to the specified data items.
DeselectRow(Int32)Deselects a row with the specified visible index.
DeselectRows(IEnumerable<Int32>)Deselects rows with the specified visible indexes.
EndUpdate()Resumes Grid updates (when the BeginUpdate() method pauses updates) and re-renders the Grid.
Equals(Object, Object) staticDetermines whether the specified object instances are considered equal. Inherited from Object.
Equals(Object)Determines whether the specified object is equal to the current object. Inherited from Object.
ExpandAllGroupRows()Expands all group rows.
ExpandDetailRow(Int32)Expands the specified detail row.
ExpandGroupRow(Int32, Boolean)Expands a group row with the specified visible index.
ExportToCsvAsync(Stream, GridCsvExportOptions)Exports grid data to a stream in CSV format.
ExportToCsvAsync(String, GridCsvExportOptions)Exports grid data in CSV format and downloads the resulting file to the client machine.
ExportToPdfAsync(Stream, GridPdfExportOptions)Exports Grid data in PDF format to the specified stream.
ExportToPdfAsync(String, GridPdfExportOptions)Exports Grid data to PDF and downloads the output file onto the client machine.
ExportToXlsAsync(Stream, GridXlExportOptions)Exports grid data to a stream in XLS format.
ExportToXlsAsync(String, GridXlExportOptions)Exports grid data in XLS format and downloads the resulting file to the client machine.
ExportToXlsxAsync(Stream, GridXlExportOptions)Exports grid data in XLSX format to a stream.
ExportToXlsxAsync(String, GridXlExportOptions)Exports grid data in XLSX format and downloads the resulting file to the client machine.
FilterBy(String, GridFilterRowOperatorType, Object)Filters grid data by the specified column value.
GetColumnEditSettings<T>(String)Returns editor settings of the column bound to the specified data source field.
GetColumns()Returns a collection of all grid columns.
GetDataColumns()Returns a data column collection.
GetDataItem(Int32)Gets a data source item that is bound to the processed row.
GetDataItemValue(Object, String)Returns the value of the specified field for the specified data item.
GetEditContext()Returns the edit context.
GetFieldFilterCriteria(String)Returns the filter criteria applied to the specified field of the bound data source.
GetFilterCriteria()Returns the filter criteria applied to the grid data.
GetFocusedDataItem()Returns a data item bound to the focused data row.
GetFocusedRowIndex()Returns the visible index of the focused row.
GetGroupCount()Gets the number of grouped columns.
GetGroupSummaryDisplayText(IGridSummaryItem, Int32)Gets a group summary item’s display text.
GetGroupSummaryFormattedValue(IGridSummaryItem, Int32)Gets a group summary item’s formatted value.
GetGroupSummaryItems()Gets the collection of group summary items.
GetGroupSummaryLabel(IGridSummaryItem, Int32)Gets the name of a group summary‘s function name.
GetGroupSummaryValue(IGridSummaryItem, Int32)Gets a group summary item’s value.
GetHashCode()Serves as the default hash function. Inherited from Object.
GetPageCount()Returns the total number of pages in the Grid.
GetRowLevel(Int32)Gets the nesting level of the processed row.
GetRowValue(Int32, String)Gets the value of the data source field in the specified row.
GetSortedColumns()Gets the collection of sorted columns.
GetStartRowVisibleIndex()Gets the visible index of the first row on the current page.
GetTotalSummaryDisplayText(IGridSummaryItem)Gets a total summary item’s display text.
GetTotalSummaryFormattedValue(IGridSummaryItem)Gets a total summary item’s formatted value.
GetTotalSummaryItems()Gets the collection of total summary items.
GetTotalSummaryLabel(IGridSummaryItem)Gets the name of a total summary‘s function name.
GetTotalSummaryValue(IGridSummaryItem)Gets a total summary item’s value.
GetType()Gets the Type of the current instance. Inherited from Object.
GetVisibleColumns()Returns a collection of visible columns sorted based on their display order.
GetVisibleRowCount()Gets the total number of visible rows in the grid.
GroupBy(String, Int32)Groups data by values of the specified column and inserts the grouped column in the specified position between other grouped columns.
GroupBy(String)Groups data by values of the specified column.
IsDataItemFocused(Object)Identifies whether the row bound to the specified data item is focused.
IsDataItemSelected(Object)Returns whether the row that corresponds to the specified data item is selected.
IsDetailRowExpanded(Int32)Indicates whether the specified detail row is expanded.
IsEditing()Returns whether the Grid is being edited.
IsEditingNewRow()Returns whether a new Grid row is being edited.
IsEditingRow(Int32)Returns whether the specified Grid row is being edited.
IsGroupRow(Int32)Specifies whether the specified row is a group row.
IsGroupRowExpanded(Int32)Specifies whether the specified group row is expanded.
IsRowFocused(Int32)Identifies whether the row with the specified visible index is focused.
IsRowSelected(Int32)Returns whether the specified row is selected.
LoadLayout(GridPersistentLayout)Restores the DxGrid layout.
MakeCellVisible(Int32, String)Navigates to the cell displayed at the intersection of the specified row and data column.
MakeCellVisibleAsync(Object, String)Navigates to the cell bound to the specified data item’s field.
MakeDataItemVisibleAsync(Object)Makes the row bound to the specified data item visible on screen.
MakeRowVisible(Int32)Makes the row with the specified visible index visible on screen.
MemberwiseClone() protectedCreates a shallow copy of the current Object. Inherited from Object.
ReferenceEquals(Object, Object) staticDetermines whether the specified Object instances are the same instance. Inherited from Object.
RefreshSummary()Refreshes all total and group summary values in the grid.
Reload()Reloads Grid data.
SaveChangesAsync()Triggers validation and raises the EditModelSaving event if validation succeeds. The method immediately raises this event if validation is disabled.
SaveLayout()Saves information about the DxGrid‘s layout.
SelectAllAsync(Boolean)Selects or deselects all rows in the grid.
SelectAllOnPage(Boolean)Selects or deselects all rows on the current visible page.
SelectDataItem(Object, Boolean)Selects or deselects a row that corresponds to the specified data item.
SelectDataItems(IEnumerable<Object>, Boolean)Selects or deselects rows that correspond to the specified data items.
SelectRow(Int32, Boolean)Selects or deselects a row with the specified visible index.
SelectRows(IEnumerable<Int32>, Boolean)Selects or deselects rows with the specified visible indexes.
SetFieldFilterCriteria(String, CriteriaOperator)Applies a filter to the specified data field.
SetFilterCriteria(CriteriaOperator)Applies a filter to grid data.
SetFocusedDataItemAsync(Object)Moves focus to the row bound to the specified data item.
SetFocusedRowIndex(Int32)Moves focus to the row with the specified visible index.
ShowColumnChooser()Shows the column chooser in the center of the grid.
ShowColumnChooser(DialogDisplayOptions)Shows the column chooser and positions it based on the specified display options.
ShowColumnChooser(String)Shows the column chooser below the specified target element.
ShowDataItemDeleteConfirmation(Object)Displays the delete confirmation dialog for the specified data item. If a user confirms the operation, the method raises the DataItemDeleting event.
ShowFilterBuilder()Opens the filter builder dialog.
ShowRowDeleteConfirmation(Int32)Displays the delete confirmation dialog for the specified row. If a user confirms the operation, the method raises the DataItemDeleting event.
SortBy(String, GridColumnSortOrder, Int32)Sorts data by column values in the specified order, and specifies the sorted column’s index.
SortBy(String, GridColumnSortOrder)Sorts data by column values in the specified order.
SortBy(String)Sorts data by the specified column values.
StartEditDataItemAsync(Object, String)Starts editing the specified data item.
StartEditNewRowAsync(String)Starts editing a new row.
StartEditRowAsync(Int32, String)Starts editing the row with the specified visible index.
ToString()Returns a string that represents the current object. Inherited from Object.
WaitForDataLoadAsync()Returns a task that completes when pending asynchronous data load operations are completed.
WaitForInstantFeedbackRowLoadAsync(Int32)Obsolete. Returns a task that is completed when the specified row of an asynchronous Instant Feedback Data Source is loaded.
WaitForRemoteSourceRowLoadAsync(Int32)Returns a task that is completed when the specified row of an asynchronous remote data source is loaded.

Events

NameDescription
CustomGroupEnables you to implement custom logic used to group data in the grid.
CustomizeCellDisplayTextAllows you to customize text displayed within a cell.
CustomizeContextMenuAllows you to customize context menus.
CustomizeDataRowEditorAllows you to customize a cell editor in a data row.
CustomizeEditModelAllows you to create a custom edit model or customize an automatically generated edit model.
CustomizeElementAllows you to customize grid elements.
CustomizeFilterMenuAllows you to customize column filter menu items.
CustomizeFilterRowEditorAllows you to customize a cell editor in the filter row.
CustomizeGroupValueDisplayTextAllows you to customize the group value’s display text.
CustomizeSummaryDisplayTextAllows you to customize the summary display text.
CustomSortAllows you to implement custom logic used to sort data in the grid.
CustomSummaryAllows you to create custom summary items.
DataItemDeletingFires when a user confirms the delete operation in the delete confirmation dialog.
EditCancelingFires before the Grid cancels the edit operation and discards changes.
EditModelSavingFires if validation succeeds after a user saves changes or you call the SaveChangesAsync() method.
EditStartFires before the Grid starts editing a row.
FilterCriteriaChangedFires when filter criteria applied to grid data change.
FocusedRowChangedFires when the row focus changes.
ItemsDroppedFires when a user drops rows onto the Grid.
LayoutAutoLoadingFires when the DxGrid component is initialized and starts to load its layout.
LayoutAutoSavingFires when the grid’s layout changes.
PageIndexChangedFires when the grid’s active page index changes.
PageSizeChangedFires when the page size changes.
RowClickFires when a user clicks or taps a grid row or focuses a data cell and presses Enter.
RowDoubleClickFires when a user double clicks a grid row.
SearchTextChangedFires when the search text changes.
SelectedDataItemChangedIn single selection mode, fires when another Grid row is selected.
SelectedDataItemsChangedIn multiple selection mode, fires when the selection in the Grid changes.
ShowAllRowsChangedFires when the ShowAllRows property value changes.
UnboundColumnDataAllows you to implement custom logic to obtain unbound column values.

See Also

DxGrid Class

DevExpress.Blazor Namespace