QuickGrid<TGridItem> 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
顯示方格的元件。
[Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")]
public class QuickGrid<TGridItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
[<Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")>]
type QuickGrid<'GridItem> = class
inherit ComponentBase
interface IAsyncDisposable
Public Class QuickGrid(Of TGridItem)
Inherits ComponentBase
Implements IAsyncDisposable
類型參數
- TGridItem
方格中每個數據列所表示的數據型別。
- 繼承
- 屬性
- 實作
建構函式
QuickGrid<TGridItem>() |
建構 QuickGrid<TGridItem>的實例。 |
屬性
AdditionalAttributes |
取得或設定將套用至所建立專案之其他屬性的集合。 |
Assets |
取得應用程式的 ResourceAssetCollection。 (繼承來源 ComponentBase) |
AssignedRenderMode |
取得指派給這個元件的 IComponentRenderMode。 (繼承來源 ComponentBase) |
ChildContent |
定義這個實例的子元件。 例如,您可以藉由新增衍生自 ColumnBase<TGridItem> 基類的元件來定義數據行。 |
Class |
選擇性的 CSS 類別名稱。 如果指定,則會包含在轉譯數據表的類別屬性中。 |
ItemKey |
選擇性地為每個轉譯的數據列定義 @key 的值。 這通常應該用來指定每個數據項的唯一標識符,例如主鍵值。 這可讓方格根據數據列專案的唯一標識符保留數據列專案與數據項之間的關聯,即使 TGridItem 實例被新的複本取代(例如,在針對基礎數據存放區進行新的查詢之後)。 如果未設定,@key 會是 TGridItem 實例本身。 |
Items |
方格的可查詢數據源。 這可能是使用 AsQueryable(IEnumerable) 擴充方法或 EntityFramework DataSet 或衍生自它的 IQueryable,轉換成可查詢的記憶體內數據。 您應該提供 Items 或 ItemsProvider,但不應同時提供兩者。 |
ItemSize |
只有在使用 Virtualize時才適用。 它會為每個數據列定義預期的高度,讓虛擬化機制擷取正確的項目數目以符合顯示大小,並確保卷動正確。 |
ItemsProvider |
提供方格數據的回呼。 您應該提供 Items 或 ItemsProvider,但不應同時提供兩者。 |
OverscanCount |
只有在使用 Virtualize時才適用。 它會定義在可見區域前後轉譯多少其他專案,以減少卷動期間的轉譯頻率。 雖然較高的值可以藉由在螢幕外轉譯更多專案來改善卷動平滑度,但它們也可以增加初始載入時間。 建議您根據您的資料集大小和用戶體驗需求來尋找平衡。 預設值為 3。 |
Pagination |
選擇性地將此 QuickGrid<TGridItem> 實例與 PaginationState 模型鏈接,導致方格只擷取和轉譯目前的數據頁面。 這通常與 Paginator 元件或其他UI邏輯搭配使用,以顯示和更新提供的 PaginationState 實例。 |
RendererInfo |
取得正在執行元件的 RendererInfo。 (繼承來源 ComponentBase) |
Theme |
具有預設值 「default」 的主題名稱。 這會影響哪些樣式規則符合數據表。 |
Virtualize |
如果為 true,則會使用虛擬化轉譯方格。 這通常與卷動搭配使用,並讓方格只擷取和轉譯目前卷動檢視區周圍的數據。 這可大幅改善卷動大型數據集時的效能。 如果您使用 Virtualize,則應該提供 ItemSize 值,並確保每個數據列都以相同的常數高度呈現。 一般而言,如果轉譯的數據量很小,或者如果您使用分頁,最好不要使用 Virtualize。 |
方法
BuildRenderTree(RenderTreeBuilder) |
顯示方格的元件。 |
DispatchExceptionAsync(Exception) |
將所提供的 如果例外狀況發生在元件生命週期方法之外,但您想要將其視為元件生命週期方法的例外狀況,這非常有用。 (繼承來源 ComponentBase) |
DisposeAsync() |
顯示方格的元件。 |
InvokeAsync(Action) |
在相關聯的轉譯器同步處理內容上執行提供的工作專案。 (繼承來源 ComponentBase) |
InvokeAsync(Func<Task>) |
在相關聯的轉譯器同步處理內容上執行提供的工作專案。 (繼承來源 ComponentBase) |
OnAfterRender(Boolean) |
每次元件以互動方式轉譯且UI完成更新之後叫用的方法(例如,元素新增至瀏覽器 DOM之後)。 任何 ElementReference 欄位都會在執行時填入。 此方法不會在預先呈現或伺服器端轉譯期間叫用,因為這些進程不會附加至任何實時瀏覽器 DOM,而且已在更新 DOM 之前完成。 (繼承來源 ComponentBase) |
OnAfterRenderAsync(Boolean) |
每次以互動方式轉譯元件且UI完成更新之後叫用的方法(例如,元素新增至瀏覽器 DOM之後)。 任何 ElementReference 欄位都會在執行時填入。 此方法不會在預先呈現或伺服器端轉譯期間叫用,因為這些進程不會附加至任何實時瀏覽器 DOM,而且已在更新 DOM 之前完成。 請注意,元件不會在完成任何傳回 Task之後自動重新轉譯,因為這會導致無限轉譯迴圈。 |
OnInitialized() |
當元件準備好啟動時叫用的方法,已從轉譯樹狀結構中的父代接收其初始參數。 (繼承來源 ComponentBase) |
OnInitializedAsync() |
當元件準備好啟動時叫用的方法,已從轉譯樹狀結構中的父代接收其初始參數。 如果您要執行異步操作,並想要元件在完成該作業時重新整理,請覆寫此方法。 (繼承來源 ComponentBase) |
OnParametersSet() |
當元件從轉譯樹狀結構中的父代接收參數,且傳入值已指派給屬性時叫用的方法。 (繼承來源 ComponentBase) |
OnParametersSetAsync() |
當元件從轉譯樹狀結構中的父代接收參數,且傳入值已指派給屬性時叫用的方法。 |
RefreshDataAsync() |
指示方格從提供的數據源重新擷取和轉譯目前的數據(Items 或 ItemsProvider)。 |
SetParametersAsync(ParameterView) |
設定由元件父代在轉譯樹狀結構中提供的參數。 (繼承來源 ComponentBase) |
ShouldRender() |
傳回旗標,指出元件是否應該呈現。 (繼承來源 ComponentBase) |
ShowColumnOptionsAsync(ColumnBase<TGridItem>) |
顯示指定數據行的 ColumnOptions UI,並關閉先前顯示的任何其他資料行選項 UI。 |
SortByColumnAsync(ColumnBase<TGridItem>, SortDirection) |
將方格目前的排序數據行設定為指定的 |
StateHasChanged() |
通知元件其狀態已變更。 適用時,這會導致元件重新轉譯。 (繼承來源 ComponentBase) |
明確介面實作
IComponent.Attach(RenderHandle) |
顯示方格的元件。 (繼承來源 ComponentBase) |
IHandleAfterRender.OnAfterRenderAsync() |
顯示方格的元件。 (繼承來源 ComponentBase) |
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object) |
顯示方格的元件。 (繼承來源 ComponentBase) |