Class
TableGridBase<TItem, TCommandEventArgs>

Definition

Namespace:Telerik.Blazor.Components.Common

Assembly:Telerik.Blazor.dll

Type Parameters:

TItem

TCommandEventArgs

Syntax:

cs-api-definition
public abstract class TableGridBase<TItem, TCommandEventArgs> : GridBase<TItem>, IComponent, IHandleEvent, IHandleAfterRender, IDisposable where TCommandEventArgs : TableGridBaseCommandEventArgs, new()

Inheritance: objectComponentBaseBaseComponentDataBoundComponent<TItem>GridBase<TItem>TableGridBase<TItem, TCommandEventArgs>

Derived Classes: TelerikGrid<TItem>TelerikTreeList<TItem>

Implements: IComponentIDisposableIHandleAfterRenderIHandleEvent

Inherited Members GridBase<TItem>.WidthGridBase<TItem>.HeightGridBase<TItem>.PageSizeChangedGridBase<TItem>.PageSizeGridBase<TItem>.PageGridBase<TItem>.PageChangedGridBase<TItem>.PageableGridBase<TItem>.OnModelInitGridBase<TItem>.TotalCountDataBoundComponent<TItem>.SetParametersAsync(ParameterView)DataBoundComponent<TItem>.OnParametersSetAsync()DataBoundComponent<TItem>.Rebind()DataBoundComponent<TItem>.DataBaseComponent.ShouldRender()BaseComponent.OnInitializedAsync()BaseComponent.OnAfterRenderAsync(bool)BaseComponent.InitLocalizer()BaseComponent.ThrowIfParameterIsNull(object, string)BaseComponent.HaveOptionsChanged(IDictionary<string, object>, IDictionary<string, object>)BaseComponent.GetClassString(params string[])BaseComponent.InvokeAsync<T>(string, params object[])BaseComponent.InvokeAsync<T>(string, CancellationToken, params object[])BaseComponent.InvokeVoidAsync(string, params object[])BaseComponent.InvokeComponentMethodAsync<T>(string, params object[])BaseComponent.InvokeComponentMethodAsync<T>(string, CancellationToken, params object[])BaseComponent.InvokeVoidComponentMethodAsync(string, params object[])BaseComponent.InvokeComponentVoidMethodAsync(string, object)BaseComponent.InvokeDisposeAsync()BaseComponent.StateHasChanged()BaseComponent.RootComponentBaseComponent.ClassComponentBase.BuildRenderTree(RenderTreeBuilder)ComponentBase.OnInitialized()ComponentBase.InvokeAsync(Action)ComponentBase.InvokeAsync(Func<Task>)ComponentBase.DispatchExceptionAsync(Exception)

Constructors

TableGridBase()

Declaration

cs-api-definition
protected TableGridBase()

Fields

_selectedItemsMap

Declaration

cs-api-definition
protected HashSet<TItem> _selectedItemsMap

Field Value

HashSet<TItem>

Properties

AutoGenerateColumns

Automatically creates columns based on data model properties when no columns are explicitly defined. Set to false to define columns manually. Cannot be used with dynamic objects (like ExpandoObject) - use explicit column definitions instead.

Declaration

cs-api-definition
[Parameter]
public bool AutoGenerateColumns { get; set; }

Property Value

bool

ColumnVirtualization

Enables column virtualization to improve performance when working with a large number of columns. This feature ensures that only the columns visible in the current viewport are rendered, reducing the rendering load and improving performance and responsiveness. This is particularly useful for grids with many columns, as it enhances scrolling performance and overall user experience.

Declaration

cs-api-definition
[Parameter]
public bool ColumnVirtualization { get; set; }

Property Value

bool

ConfirmDelete

Requires users to confirm before deleting data items. Shows a confirmation dialog to prevent accidental deletions.

Declaration

cs-api-definition
[Parameter]
public bool ConfirmDelete { get; set; }

Property Value

bool

CurrentBreakpoint

Declaration

cs-api-definition
public AdaptiveBreakpoint CurrentBreakpoint { get; set; }

Property Value

AdaptiveBreakpoint

DialogFactory

Declaration

cs-api-definition
[CascadingParameter]
protected DialogFactory DialogFactory { get; set; }

Property Value

DialogFactory

EnableLoaderContainer

Shows a loading indicator during long-running operations like data requests or exports. The default value is true. This has no effect on initial data load.

Declaration

cs-api-definition
[Parameter]
public bool EnableLoaderContainer { get; set; }

Property Value

bool

FilterMenuType

Determines the filter menu interface when GridFilterMode is FilterMenu. Use Menu for traditional filters or CheckBoxList for multi-select filtering.

Declaration

cs-api-definition
[Parameter]
public FilterMenuType FilterMenuType { get; set; }

Property Value

FilterMenuType

FilterRowDebounceDelay

Delay in milliseconds between when user stops typing in filter rows and when filtering is applied. Use this to prevent excessive filtering during typing. Default is 150ms.

Declaration

cs-api-definition
[Parameter]
public int FilterRowDebounceDelay { get; set; }

Property Value

int

Id

Defines the id HTML attribute of the Component.

Declaration

cs-api-definition
[Parameter]
public string Id { get; set; }

Property Value

string

IsPopupRendering

Declaration

cs-api-definition
public bool IsPopupRendering { get; }

Property Value

bool

Navigable

Enables keyboard navigation through Grid cells and rows using arrow keys, Tab, Enter, and other keyboard shortcuts for accessibility.

Declaration

cs-api-definition
[Parameter]
public bool Navigable { get; set; }

Property Value

bool

NoDataTemplate

Template displayed when the Grid has no data to show. Use this to show custom messages or call-to-action buttons for empty states.

Declaration

cs-api-definition
[Parameter]
public RenderFragment NoDataTemplate { get; set; }

Property Value

RenderFragment

OnAdd

Fires when users click on the Add command button to start creating a new data item. Use this to initialize default values or prepare the edit form.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TCommandEventArgs> OnAdd { get; set; }

Property Value

EventCallback<TCommandEventArgs>

OnCancel

Fires when users cancel edit mode via the Cancel command button or Esc key. Use this to clean up temporary data or refresh state.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TCommandEventArgs> OnCancel { get; set; }

Property Value

EventCallback<TCommandEventArgs>

OnCreate

Fires when the Create command is executed. In Popup and Inline modes, this is when users save the new data item. In Incell mode, this event follows immediately the OnAdd event.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TCommandEventArgs> OnCreate { get; set; }

Property Value

EventCallback<TCommandEventArgs>

OnDelete

Fires when users click on the Delete command button or when they confirm the delete operation. See ConfirmDelete for confirmation settings.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TCommandEventArgs> OnDelete { get; set; }

Property Value

EventCallback<TCommandEventArgs>

OnEdit

Fires when users enter edit mode via the Edit command button, cell click, or Enter keypress. Use this to customize the editing experience.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TCommandEventArgs> OnEdit { get; set; }

Property Value

EventCallback<TCommandEventArgs>

OnUpdate

Fires when the Update command is executed. In Popup and Inline modes, this is when users save the data item. In Incell mode, this is when users blur the edit cell or press Enter.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TCommandEventArgs> OnUpdate { get; set; }

Property Value

EventCallback<TCommandEventArgs>

Reorderable

Allows users to drag and drop column headers to change the column order. Enable this for customizable column arrangements.

Declaration

cs-api-definition
[Parameter]
public bool Reorderable { get; set; }

Property Value

bool

Resizable

Allows users to drag column borders to adjust column widths interactively. Enable this for better user control over column sizing.

Declaration

cs-api-definition
[Parameter]
public bool Resizable { get; set; }

Property Value

bool

RowDraggable

Enables users to drag and drop rows to reorder data. Use the GridRowDropEventArgs<TItem> event to handle row reordering logic. Not compatible with grouping functionality (Groupable).

Declaration

cs-api-definition
[Parameter]
public bool RowDraggable { get; set; }

Property Value

bool

RowHeight

Sets the height of each table row in pixels. This is required when using virtual scrolling (Virtual) for performance calculations. When virtual scrolling is enabled, both RowHeight and Height must be specified.

Declaration

cs-api-definition
[Parameter]
public decimal RowHeight { get; set; }

Property Value

decimal

RowTemplate

Custom template for rendering Grid rows. Use this to create completely custom row layouts instead of the default table row structure.

Declaration

cs-api-definition
[Parameter]
public RenderFragment<TItem> RowTemplate { get; set; }

Property Value

RenderFragment<TItem>

SelectedItems

Collection of currently selected data items when row selection is enabled. Supports two-way binding for programmatic selection management. Also set GridSelectionMode to enable selection functionality.

Declaration

cs-api-definition
[Parameter]
public IEnumerable<TItem> SelectedItems { get; set; }

Property Value

IEnumerable<TItem>

SelectedItemsChanged

Event triggered when the row selection changes. Use this event to handle user actions such as selecting or deselecting rows in the Grid. Pair it with the Value parameter (one-way binding) to track and respond to selection state changes.

Declaration

cs-api-definition
[Parameter]
public EventCallback<IEnumerable<TItem>> SelectedItemsChanged { get; set; }

Property Value

EventCallback<IEnumerable<TItem>>

ShowColumnMenu

Shows a menu button in column headers that provides options for sorting, filtering, grouping, and column visibility. Use ShowColumnMenu to disable the menu for specific columns.

Declaration

cs-api-definition
[Parameter]
public bool ShowColumnMenu { get; set; }

Property Value

bool

SortMode

Controls whether users can sort by one column at a time or multiple columns simultaneously. Use Multiple for complex sorting scenarios. The available options are Single (default) and Multiple. Sortable must be enabled.

Declaration

cs-api-definition
[Parameter]
public SortMode SortMode { get; set; }

Property Value

SortMode

Sortable

Enables data sorting by clicking on column headers. Users can sort data in ascending or descending order to organize information.

Declaration

cs-api-definition
[Parameter]
public bool Sortable { get; set; }

Property Value

bool

Methods

Dispose()

Declaration

cs-api-definition
public override void Dispose()

Overrides DataBoundComponent<TItem>.Dispose()

GetItemFromDropIndex(int)

Declaration

cs-api-definition
protected abstract TItem GetItemFromDropIndex(int index)

Parameters

index

int

Returns

TItem

GetItemFromDropIndex(string)

Gets the data item instance at the specified index position.

Declaration

cs-api-definition
public TItem GetItemFromDropIndex(string index)

Parameters

index

string

The index position within the currently rendered data rows.

Returns

TItem

An object of type TItem.

HandleVirtualScrollPaging()

Declaration

cs-api-definition
protected Task HandleVirtualScrollPaging()

Returns

Task

OnAfterRender(bool)

Declaration

cs-api-definition
protected override void OnAfterRender(bool firstRender)

Parameters

firstRender

bool

Overrides ComponentBase.OnAfterRender(bool)

OnParametersSet()

Declaration

cs-api-definition
protected override void OnParametersSet()

Overrides ComponentBase.OnParametersSet()

PageData()

Declaration

cs-api-definition
protected virtual Task PageData()

Returns

Task

ResetEditContext()

Declaration

cs-api-definition
protected void ResetEditContext()

SetMultiColumnHeaders()

Declaration

cs-api-definition
protected void SetMultiColumnHeaders()

SetSkip(int)

Declaration

cs-api-definition
protected abstract void SetSkip(int skip)

Parameters

skip

int