Bahasa

QuickGrid<TGridItem> Kelas

Definisi

Komponen yang menampilkan kisi.

[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

Jenis parameter

TGridItem

Jenis data yang diwakili oleh setiap baris dalam kisi.

Warisan
QuickGrid<TGridItem>
Atribut
Penerapan

Konstruktor

Nama Deskripsi
QuickGrid<TGridItem>()

Membuat instans QuickGrid<TGridItem>.

Properti

Nama Deskripsi
AdditionalAttributes

Mendapatkan atau mengatur kumpulan atribut tambahan yang akan diterapkan ke elemen yang dibuat.

Assets

ResourceAssetCollection Mendapatkan untuk aplikasi.

(Diperoleh dari ComponentBase)
AssignedRenderMode

Mendapatkan yang IComponentRenderMode ditetapkan ke komponen ini.

(Diperoleh dari ComponentBase)
ChildContent

Menentukan komponen anak dari instans ini. Misalnya, Anda dapat menentukan kolom dengan menambahkan komponen yang berasal dari ColumnBase<TGridItem> kelas dasar.

Class

Nama kelas CSS opsional. Jika diberikan, ini akan disertakan dalam atribut kelas tabel yang dirender.

ItemKey

Secara opsional menentukan nilai untuk @key pada setiap baris yang dirender. Biasanya ini harus digunakan untuk menentukan pengidentifikasi unik, seperti nilai kunci utama, untuk setiap item data.

Ini memungkinkan kisi untuk mempertahankan hubungan antara elemen baris dan item data berdasarkan pengidentifikasi uniknya, bahkan ketika instans TGridItem digantikan oleh salinan baru (misalnya, setelah kueri baru terhadap penyimpanan data yang mendasarinya).

Jika tidak diatur, @key akan menjadi instans TGridItem itu sendiri.

Items

Sumber data yang dapat dikueri untuk kisi.

Ini bisa berupa data dalam memori yang dikonversi ke yang dapat dikueri menggunakan AsQueryable(IEnumerable) metode ekstensi, atau EntityFramework DataSet atau yang IQueryable berasal darinya.

Anda harus menyediakan atau ItemsItemsProvider, tetapi tidak keduanya.

ItemSize

Ini hanya berlaku saat menggunakan Virtualize. Ini mendefinisikan tinggi yang diharapkan dalam piksel untuk setiap baris, memungkinkan mekanisme virtualisasi untuk mengambil jumlah item yang benar agar sesuai dengan ukuran tampilan dan untuk memastikan pengguliran yang akurat.

ItemsProvider

Panggilan balik yang menyediakan data untuk kisi.

Anda harus menyediakan atau ItemsItemsProvider, tetapi tidak keduanya.

OnRowClick

Optional. Panggilan balik yang dipanggil saat baris diklik.

OverscanCount

Ini hanya berlaku saat menggunakan Virtualize. Ini menentukan berapa banyak item tambahan yang akan dirender sebelum dan sesudah wilayah yang terlihat untuk mengurangi frekuensi penyajian selama pengguliran. Meskipun nilai yang lebih tinggi dapat meningkatkan kehalusan gulir dengan merender lebih banyak item di luar layar, nilai tersebut juga dapat meningkatkan waktu muat awal. Direkomendasikan untuk menemukan keseimbangan berdasarkan ukuran himpunan data dan persyaratan pengalaman pengguna Anda. Nilai defaultnya adalah 3.

Pagination

Secara opsional menautkan instans ini QuickGrid<TGridItem> dengan PaginationState model, menyebabkan kisi mengambil dan merender hanya halaman data saat ini.

Ini biasanya digunakan bersama dengan Paginator komponen atau beberapa logika UI lain yang menampilkan dan memperbarui instans yang disediakan PaginationState .

QueryParameterNamePrefix

Parameter tempat parameter halaman dan pengurutan URL diturunkan. Nilai default adalah string kosong, yang menghasilkan parameter kueri bernama "page", "sort", dan "order". Jika Anda memberikan nilai yang tidak kosong, misalnya "produk", maka parameter kueri akan menjadi "products_page", "products_sort", dan "products_order". Ini memungkinkan Anda untuk menggunakan beberapa QuickGrid<TGridItem> komponen pada halaman yang sama tanpa parameter URL mereka saling bertentangan.

RendererInfo

RendererInfo Mendapatkan komponen yang berjalan.

(Diperoleh dari ComponentBase)
RowClass

Optional. Panggilan balik yang akan dipanggil untuk setiap baris yang dirender untuk menentukan kelas CSS.

Theme

Nama tema, dengan nilai default "default". Ini memengaruhi aturan gaya mana yang cocok dengan tabel.

Virtualize

Jika true, kisi akan dirender dengan virtualisasi. Ini biasanya digunakan bersama dengan pengguliran dan menyebabkan kisi mengambil dan merender hanya data di sekitar viewport gulir saat ini. Ini dapat sangat meningkatkan performa saat menggulir kumpulan data besar.

Jika Anda menggunakan Virtualize, Anda harus menyediakan nilai untuk ItemSize dan harus memastikan bahwa setiap baris dirender dengan tinggi konstanta yang sama.

Umumnya lebih baik tidak digunakan Virtualize jika jumlah data yang dirender kecil atau jika Anda menggunakan penomoran halaman.

Metode

Nama Deskripsi
BuildRenderTree(RenderTreeBuilder)

Komponen yang menampilkan kisi.

DispatchExceptionAsync(Exception)

Memperlakukan yang disediakan exception sebagai yang dilemparkan oleh komponen ini. Ini akan menyebabkan ErrorBoundary yang tertutup beralih ke status gagal. Jika tidak ada ErrorBoundary yang mencakup, itu akan dianggap sebagai pengecualian dari perender penutup.

Ini berguna jika pengecualian terjadi di luar metode siklus hidup komponen, tetapi Anda ingin memperlakukannya sama dengan pengecualian dari metode siklus hidup komponen.

(Diperoleh dari ComponentBase)
DisposeAsync()

Komponen yang menampilkan kisi.

HideColumnOptionsAsync()

ColumnOptions Menutup UI yang sebelumnya ditampilkan.

InvokeAsync(Action)

Menjalankan item kerja yang disediakan pada konteks sinkronisasi perender terkait.

(Diperoleh dari ComponentBase)
InvokeAsync(Func<Task>)

Menjalankan item kerja yang disediakan pada konteks sinkronisasi perender terkait.

(Diperoleh dari ComponentBase)
OnAfterRender(Boolean)

Metode yang dipanggil setelah setiap kali komponen dirender secara interaktif dan UI telah selesai memperbarui (misalnya, setelah elemen ditambahkan ke DOM browser). Bidang apa pun ElementReference akan diisi pada saat ini berjalan.

Metode ini tidak dipanggil selama pra-penyajian atau penyajian sisi server, karena proses tersebut tidak dilampirkan ke DOM browser langsung dan sudah selesai sebelum DOM diperbarui.

(Diperoleh dari ComponentBase)
OnAfterRenderAsync(Boolean)

Metode yang dipanggil setelah setiap kali komponen dirender secara interaktif dan UI telah selesai memperbarui (misalnya, setelah elemen ditambahkan ke DOM browser). Bidang apa pun ElementReference akan diisi pada saat ini berjalan.

Metode ini tidak dipanggil selama pra-penyajian atau penyajian sisi server, karena proses tersebut tidak dilampirkan ke DOM browser langsung dan sudah selesai sebelum DOM diperbarui.

Perhatikan bahwa komponen tidak secara otomatis dirender ulang setelah penyelesaian yang dikembalikan Task, karena itu akan menyebabkan perulangan render tak terbatas.

OnInitialized()

Metode dipanggil ketika komponen siap untuk memulai, setelah menerima parameter awalnya dari induknya di pohon render.

OnInitialized()

Metode dipanggil ketika komponen siap untuk memulai, setelah menerima parameter awalnya dari induknya di pohon render.

(Diperoleh dari ComponentBase)
OnInitializedAsync()

Metode dipanggil ketika komponen siap untuk memulai, setelah menerima parameter awalnya dari induknya di pohon render.

Ambil alih metode ini jika Anda akan melakukan operasi asinkron dan ingin komponen di-refresh ketika operasi tersebut selesai.

(Diperoleh dari ComponentBase)
OnParametersSet()

Metode dipanggil ketika komponen telah menerima parameter dari induknya di pohon render, dan nilai masuk telah ditetapkan ke properti.

(Diperoleh dari ComponentBase)
OnParametersSetAsync()

Metode dipanggil ketika komponen telah menerima parameter dari induknya di pohon render, dan nilai masuk telah ditetapkan ke properti.

RefreshDataAsync()

Menginstruksikan kisi untuk mengambil kembali dan merender data saat ini dari sumber data yang disediakan (baik Items atau ItemsProvider).

SetParametersAsync(ParameterView)

Mengatur parameter yang disediakan oleh induk komponen di pohon render.

(Diperoleh dari ComponentBase)
ShouldRender()

Mengembalikan bendera untuk menunjukkan apakah komponen harus dirender.

(Diperoleh dari ComponentBase)
ShowColumnOptionsAsync(ColumnBase<TGridItem>)

ColumnOptions Menampilkan UI untuk kolom yang ditentukan, menutup UI opsi kolom lain yang sebelumnya ditampilkan.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Mengatur kolom pengurutan kisi saat ini ke yang ditentukan column.

StateHasChanged()

Memberi tahu komponen bahwa statusnya telah berubah. Jika berlaku, ini akan menyebabkan komponen dirender ulang.

(Diperoleh dari ComponentBase)

Implementasi Antarmuka Eksplisit

Nama Deskripsi
IComponent.Attach(RenderHandle)

Komponen yang menampilkan kisi.

(Diperoleh dari ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Komponen yang menampilkan kisi.

(Diperoleh dari ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Komponen yang menampilkan kisi.

(Diperoleh dari ComponentBase)

Berlaku untuk