Bahasa

Virtualize<TItem> Kelas

Definisi

Menyediakan fungsionalitas untuk merender daftar item virtual.

generic <typename TItem>
public ref class Virtualize sealed : Microsoft::AspNetCore::Components::ComponentBase, IAsyncDisposable
public sealed class Virtualize<TItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
type Virtualize<'Item> = class
    inherit ComponentBase
    interface IAsyncDisposable
Public NotInheritable Class Virtualize(Of TItem)
Inherits ComponentBase
Implements IAsyncDisposable

Jenis parameter

TItem

Jenis context untuk item yang sedang dirender.

Warisan
Virtualize<TItem>
Penerapan

Konstruktor

Nama Deskripsi
Virtualize<TItem>()

Menyediakan fungsionalitas untuk merender daftar item virtual.

Properti

Nama Deskripsi
AnchorMode

Mendapatkan atau mengatur mode jangkar yang mengontrol bagaimana port tampilan berperilaku di tepi daftar saat item baru tiba. Defaultnya adalah Beginning.

Assets

ResourceAssetCollection Mendapatkan untuk aplikasi.

(Diperoleh dari ComponentBase)
AssignedRenderMode

Mendapatkan yang IComponentRenderMode ditetapkan ke komponen ini.

(Diperoleh dari ComponentBase)
ChildContent

Mendapatkan atau mengatur templat item untuk daftar. Lihat ItemContent.

EmptyContent

Mendapatkan atau mengatur konten yang akan ditampilkan saat Items kosong atau saat TotalItemCount nol.

ItemComparer

Mendapatkan atau mengatur perbandingan yang digunakan untuk mendeteksi apakah item telah ditambahkan sebelumnya atau ditambahkan saat menggunakan ItemsProvider. Pembanding menentukan apakah item pertama yang dimuat berubah di antara panggilan penyedia, yang menunjukkan item disisipkan di atas.

Secara default menjadi Default. Untuk rekaman dan jenis yang menerapkan IEquatable<T>, default berfungsi secara otomatis (kesetaraan nilai). Untuk kelas tanpa semantik kesetaraan nilai, berikan pembanding yang dibandingkan dengan pengidentifikasi unik (misalnya, ); jika tidak, Idfallback kesetaraan referensi akan menghasilkan deteksi prepend positif palsu saat penyedia mengembalikan instans baru.

Deteksi prepend hanya berjalan ketika parameter ini secara eksplisit ditetapkan oleh konsumen. Penganalisis BL0011 memperingatkan kapan ItemsProvider digunakan tanpa penugasan eksplisit ItemComparer .

Untuk dalam memori Items, parameter ini tidak diperlukan karena komponen dapat mendeteksi prepend menggunakan identitas objek.

ItemContent

Mendapatkan atau mengatur templat item untuk daftar.

Items

Mendapatkan atau mengatur sumber item tetap.

ItemSize

Mendapatkan ukuran setiap item dalam piksel. Default ke 50px.

ItemsProvider

Mendapatkan atau mengatur fungsi yang menyediakan item ke daftar.

MaxItemCount

Mendapatkan atau mengatur jumlah maksimum item yang akan dirender, bahkan jika klien melaporkan bahwa viewport-nya cukup besar untuk menampilkan lebih banyak. Nilai defaultnya adalah 100.

Ini hanya boleh digunakan sebagai perlindungan terhadap penggunaan memori yang berlebihan atau beban data besar. Jangan atur ini ke jumlah yang lebih kecil dari yang Anda harapkan pas pada jendela berukuran realistis, karena itu akan meninggalkan celah kosong di bawah ini dan pengguna mungkin tidak dapat melihat konten lainnya.

OverscanCount

Mendapatkan atau menetapkan nilai yang menentukan berapa banyak item tambahan yang akan dirender sebelum dan sesudah wilayah yang terlihat. Ini membantu mengurangi frekuensi penyajian selama pengguliran. Namun, nilai yang lebih tinggi berarti bahwa lebih banyak elemen akan ada di halaman.

Placeholder

Mendapatkan atau mengatur templat untuk item yang belum dimuat dalam memori.

RendererInfo

RendererInfo Mendapatkan komponen yang berjalan.

(Diperoleh dari ComponentBase)
SpacerElement

Mendapatkan atau mengatur nama tag elemen HTML yang akan digunakan sebagai spacer virtualisasi. Salah satu elemen tersebut akan dirender sebelum item yang terlihat, dan satu lagi setelahnya, menggunakan gaya "tinggi" eksplisit untuk mengontrol rentang gulir.

Nilai defaultnya adalah "div". Jika Anda menempatkan instans di Virtualize<TItem> dalam elemen yang memerlukan nama tag anak tertentu, pertimbangkan untuk mengaturnya di sini. Misalnya saat merender di dalam "tbody", pertimbangkan untuk mengatur SpacerElement ke nilai "tr".

Metode

Nama Deskripsi
BuildRenderTree(RenderTreeBuilder)

Merender komponen ke yang disediakan RenderTreeBuilder.

(Diperoleh dari ComponentBase)
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()

Menyediakan fungsionalitas untuk merender daftar item virtual.

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.

(Diperoleh dari ComponentBase)
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.

(Diperoleh dari ComponentBase)
RefreshDataAsync()

Menginstruksikan komponen untuk meminta kembali data dari ItemsProvider. Ini berguna jika data eksternal mungkin telah berubah. Tidak perlu memanggil ini saat menggunakan Items.

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)
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)

Menyediakan fungsionalitas untuk merender daftar item virtual.

(Diperoleh dari ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Menyediakan fungsionalitas untuk merender daftar item virtual.

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

Menyediakan fungsionalitas untuk merender daftar item virtual.

(Diperoleh dari ComponentBase)

Berlaku untuk