New to Telerik UI for BlazorStart a free 30-day trial

A component that enables you to create and edit spreadsheet-like workbooks with sheets, cells, and formulas. Supports toolsets for formatting and commands, file open/download workflows, context menus, dialogs, and localization.

Definition

Namespace:Telerik.Blazor.Components

Assembly:Telerik.Blazor.dll

Syntax:

C#
public class TelerikSpreadsheet : BaseComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposable

Inheritance: objectComponentBaseBaseComponentTelerikSpreadsheet

Implements: IComponentIDisposableIHandleAfterRenderIHandleEvent

Inherited Members BaseComponent.ShouldRender()BaseComponent.OnInitializedAsync()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.InvokeVoidAsyncWithoutAwait(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.OnInitialized()ComponentBase.OnParametersSet()ComponentBase.OnAfterRender(bool)ComponentBase.InvokeAsync(Action)ComponentBase.InvokeAsync(Func<Task>)ComponentBase.DispatchExceptionAsync(Exception)ComponentBase.SetParametersAsync(ParameterView)...

Constructors

C#
public TelerikSpreadsheet()

Methods

C#
protected override void BuildRenderTree(RenderTreeBuilder __builder)
Parameters:__builderRenderTreeBuilder

Overrides: ComponentBase.BuildRenderTree(RenderTreeBuilder)

C#
public override void Dispose()

Overrides: BaseComponent.Dispose()

Exports the Spreadsheet to raw data.

C#
public Task<byte[]> ExportToExcelAsync()
Returns:

Task<byte[]>

C#
protected Task InitJsComponentAsync()
Returns:

Task

C#
protected override Task OnAfterRenderAsync(bool firstRender)
Parameters:firstRenderboolReturns:

Task

Overrides: BaseComponent.OnAfterRenderAsync(bool)

C#
protected override Task OnParametersSetAsync()
Returns:

Task

Overrides: ComponentBase.OnParametersSetAsync()

Updates the component and processes the latest file data.

C#
public void Rebind()

Refreshes the component.

C#
public void Refresh()

Properties

Sets the height of the column headers in pixels. Example: ColumnHeaderHeight = 24.

C#
[Parameter]
public double ColumnHeaderHeight { get; set; }

Sets the number of columns in each sheet. Example: ColumnsCount = 100. Increasing this value may impact performance for very large sheets.

C#
[Parameter]
public int ColumnsCount { get; set; }

Sets the default width of columns in pixels. Example: ColumnWidth = 80. Changing this affects all columns unless overridden per column.

C#
[Parameter]
public double ColumnWidth { get; set; }

Provides the file data to load into the Spreadsheet. Set this to a valid Excel file byte array to open a file programmatically. Example: Data = myFileBytes.

C#
[Parameter]
public byte[] Data { get; set; }

Shows a loading indicator during long-running operations, such as file import or export. Set to false to disable the loader. Example: EnableLoaderContainer = false.

C#
[Parameter]
public bool EnableLoaderContainer { get; set; }

Enables the registration of WebMCP tools for this Spreadsheet instance. When set to true, Spreadsheet operations are exposed as tools discoverable by AI models through the browser. Default value is false.

C#
[Parameter]
public bool EnableWebMcpTools { get; set; }

Sets the height of the Spreadsheet component. Accepts CSS values such as "600px" or "100%". Example: Height = "400px".

C#
[Parameter]
public string Height { get; set; }

Fires when a file is downloaded from the Spreadsheet. Use to handle custom logic after file export. Example: OnDownload = EventCallback.Factory.Create(this, OnSpreadsheetDownload).

C#
[Parameter]
public EventCallback<SpreadsheetDownloadEventArgs> OnDownload { get; set; }

Fires when a file is opened in the Spreadsheet. Use to handle custom logic after file load. Example: OnOpen = EventCallback.Factory.Create(this, OnSpreadsheetOpen).

C#
[Parameter]
public EventCallback<SpreadsheetOpenEventArgs> OnOpen { get; set; }

Sets the width of the row headers in pixels. Example: RowHeaderWidth = 40.

C#
[Parameter]
public double RowHeaderWidth { get; set; }

Sets the default height of rows in pixels. Example: RowHeight = 24. Required for some features such as virtual scrolling.

C#
[Parameter]
public double RowHeight { get; set; }

Sets the number of rows in each sheet. Example: RowsCount = 500. Large values may affect performance.

C#
[Parameter]
public int RowsCount { get; set; }

Provides configuration for WebMCP tools, such as a Name to distinguish this Spreadsheet from others on the same page.

C#
[Parameter]
public RenderFragment SpreadsheetSettings { get; set; }

Configures the visible toolbars and tools in the Spreadsheet. Use All for all tools or customize with a SpreadsheetToolSet. Example: Tools = SpreadsheetToolSets.All.

C#
[Parameter]
public SpreadsheetToolSet Tools { get; set; }

Sets the width of the Spreadsheet component. Accepts CSS values like "800px" or "100%". Example: Width = "100%".

C#
[Parameter]
public string Width { get; set; }