与OnRead事件绑定数据

本文介绍了OnRead事件，并描述如何使用它来数据绑定Telerik Blazor组件。

• 目的及好处OnRead
• 哪些Blazor组件使用OnRead
• 项目描述OnRead事件参数
• 如何返回数据OnRead与ToDataSourceResult方法
• 例子
• 使用时如何刷新组件数据OnRead

目的和收益

向组件提供数据的最简单方法是设置组件的数据参数IEnumerable < T >。这允许组件拥有所有数据项，并在内部执行所有数据操作(筛选、分页、排序等)。然而，这种情况并不总是最优的。

有两个主要原因使用OnRead事件:性能而且定制。

性能

大量数据需要按需加载。这样可以提高数据库、后端、网络和浏览器的性能。当组件触发时OnRead，它期望收到只呈现数据项。确切的数字取决于组件页大小参数。

OnRead还卸载组件外部的数据操作，例如在远程服务器上。这可以提高WebAssembly应用程序的性能。

定制

OnRead允许完全控制数据操作。例如，如果内置的排序和过滤算法不适合给定的场景，则可以使用自定义排序和过滤算法。这里只是一些例子，但还有更多可能的场景:

• 在组合框和下拉列表中通过多个数据字段搜索
• 在隐藏的网格列中搜索
• 取消网格数据请求
• 反弹组合框过滤器请求

OnRead使数据绑定到OData万博体育手机版网址。

OnRead还允许应用程序知道用户当前看到的确切数据项。

带有OnRead事件的组件

下面的Blazor组件公开了一个OnRead事件。获得性能好处，使用事件一起配合分页或虚拟化(也称为虚拟滚动)。

每个组件名称都指向特定于组件的OnRead文档和示例:

像TreeList和树状视图不要有OnRead事件。相反，它们通过OnExpand事件。

事件参数

的OnRead事件处理程序接收参数，该参数继承自ReadEventArgs。确切的类型取决于组件。例如，网格处理程序接收GridReadEventArgs。ComboBox处理程序接收ComboBoxReadEventArgs等等。

事件参数对象的以下属性对所有对象都是通用的具有OnRead事件。其他属性将在特定于组件的文章中讨论。

async Task GridReadHandler(GridReadEventArgs args){//新页面是什么?// args.Request.Page //页面大小(返回多少项)?// args.Request.PageSize //用户在虚拟场景中滚动了多少行?// args.Request.Skip}

的DataSourceRequest对象可以序列化并发送到远程服务器。使用System.Text.Json序列化器。

ToDataSourceResult方法

的DataSourceRequest对象提供有关所需数据的信息。问题是如何最容易地检索这些数据。有时OnRead数据绑定称为“手动”，但在大多数情况下，它根本不必是手动的。解决办法是ToDataSourceResult。

的ToDataSourceResult扩展方法能够从中提取所请求的数据项IEnumerable,这个IQueryable而且数据表。该方法是Telerik DataSource Extensions。它期望DataSourceRequest论点。

ToDataSourceResult返回一个DataSourceResult对象。它最重要的属性是:

的数据而且总计的属性DataSourceRequest而且DataSourceResult匹配，并允许轻松赋值:

IEnumerable AllGridData {get;设置;} async Task GridReadHandler(GridReadEventArgs args) {DataSourceResult result = AllGridData.ToDataSourceResult(args. request);arg游戏。数据= result.Data; args.Total = result.Total; args.AggregateResults = result.AggregateResults; // Grid only }

ToDataSourceResultAsync的可等待(异步)替代方法吗ToDataSourceResult。

它是可以使用的DataSourceRequest,ToDataSourceResult而且ToDataSourceResultAsync在与特定Telerik组件无关的场景中。

例子

让我们想象一下，我们的数据源包含1000个项目，而我们只想向Grid发送一页项目。

1. 导入Telerik.DataSource.Extensions名称空间。
2. 设置网格的TItem参数设置为模型类型。(有些组件需要TValue参数来定义值类型，而不是Grid。使用TValue使用自动完成、组合框、下拉列表和多选功能。)
3. 订阅OnRead事件。使用异步任务而不是异步无效。事件处理程序接收一个GridReadEventArgs论点。我们给它命名arg游戏。
4. 使用arg游戏。请求而且ToDataSourceResult ()获取一页网格数据。可以根据用户的操作对数据进行筛选和排序。
5. 集arg游戏。数据到要呈现的数据项。
6. 集arg游戏。总计到数据项的总数(1000)。

@using telerikk . datasource . extensions  
 OnGridRead fired at: @LastOnRead 
 @code {private List GridData {get;设置;}私有字符串LastOnRead {get;设置;} //总是使用async Task，而不是async void private async Task OnGridRead(GridReadEventArgs args) {var result = GridData.ToDataSourceResult(args. request);arg游戏。数据= result.Data; args.Total = result.Total; var now = DateTime.Now; LastOnRead = now.ToLongTimeString() + "." + now.Millisecond; } protected override void OnInitialized() { GenerateData(); base.OnInitialized(); } private void GenerateData() { GridData = new List(); for (int i = 1; i <= 1000; i++) { GridData.Add(new SampleModel() { Id = i, Text = $"Grid Text {i}" }); } } public class SampleModel { public int Id { get; set; } public string Text { get; set; } } }

刷新数据

组件触发OnRead用户执行某个操作(如分页、排序、虚拟滚动等)时的事件。调用OnRead手动处理程序将不起作用，因为组件将不会跟踪方法参数。

所有带有OnRead事件有一个重新绑定方法也是。要以编程方式刷新组件数据，请调用此方法。它将迫使组件发射OnRead并接收新的数据。

@using telerikdatasource . extensions   @context. txtId: @context。Text   重新绑定组件 

< TelerikGrid @ref="@TheGrid" TItem="@SampleModel" OnRead="@OnGridRead" AutoGenerateColumns="true" Sortable="true" Pageable="true" PageSize="5" /> @code {TelerikGrid TheGrid {get;设置;} TelerikDropDownList TheDropDown {get;设置;} List GridData {get; set; } List DropDownData { get; set; } int DropDownValue { get; set; } = 1; void RebindComponents() { GenerateData(); // simulate change in the data TheGrid.Rebind(); TheDropDown.Rebind(); } async Task OnGridRead(GridReadEventArgs args) { var result = GridData.ToDataSourceResult(args.Request); args.Data = result.Data; args.Total = result.Total; } async Task OnDropDownRead(DropDownListReadEventArgs args) { var result = DropDownData.ToDataSourceResult(args.Request); args.Data = result.Data; args.Total = result.Total; } protected override void OnInitialized() { GenerateData(); base.OnInitialized(); } void GenerateData() { GridData = new List(); DropDownData = new List(); var rnd = new Random(); for (int i = 1; i <= 10; i++) { GridData.Add(new SampleModel() { Id = i, Text = $"Text {rnd.Next(1, 100)}" }); DropDownData.Add(new SampleModel() { Id = i, Text = $"Text {rnd.Next(1, 100)}" }); } } public class SampleModel { public int Id { get; set; } public string Text { get; set; } } }

另请参阅

• OnRead使用网格
• 数据绑定到云服务万博体育手机版网址