Virtualize<TItem> Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- 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, Deteksi prepend hanya berjalan ketika parameter ini secara eksplisit ditetapkan oleh konsumen.
Penganalisis 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 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) |