Virtualize<TItem> Sınıf

Tanım

Sanallaştırılmış öğe listesini işlemek için işlevsellik sağlar.

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

Tür Parametreleri

TItem

İşlenen context öğelerin türü.

Devralma
Virtualize<TItem>
Uygulamalar

Oluşturucular

Name Description
Virtualize<TItem>()

Sanallaştırılmış öğe listesini işlemek için işlevsellik sağlar.

Özellikler

Name Description
AnchorMode

Görünüm penceresi yeni öğeler geldiğinde listenin kenarlarında nasıl davranacağını denetleyebilen tutturucu modunu alır veya ayarlar. Varsayılan değer: Beginning.

Assets

ResourceAssetCollection Uygulamanın öğesini alır.

(Devralındığı yer: ComponentBase)
AssignedRenderMode

IComponentRenderMode Bu bileşene atananı alır.

(Devralındığı yer: ComponentBase)
ChildContent

Liste için öğe şablonunu alır veya ayarlar. Bkz. ItemContent.

EmptyContent

İçeriği boş olduğunda veya sıfır olduğunda ItemsTotalItemCount gösterilecek şekilde alır veya ayarlar.

ItemComparer

kullanılırken ItemsProvideröğelerin eklenip eklenmediğini algılamak için kullanılan bir karşılaştırıcı alır veya ayarlar. Karşılaştırıcı, sağlayıcı çağrıları arasında ilk yüklenen öğenin değişip değişmediğini belirler ve bu da öğelerin yukarıya eklendiğini gösterir.

Varsayılan değer Default’dır. uygulayan IEquatable<T>kayıtlar ve türler için varsayılan otomatik olarak çalışır (değer eşitliği). Değer eşitliği semantiği olmayan sınıflar için, benzersiz bir tanımlayıcıyla karşılaştıran bir karşılaştırıcı sağlayın (ör. Id); aksi takdirde, sağlayıcı yeni örnekler döndürdüğünde başvuru-eşitlik geri dönüşü hatalı pozitif ön ödeme algılaması üretir.

Önceden eklenen algılama yalnızca bu parametre tüketici tarafından açıkça atandığında çalışır. Çözümleyici, BL0011 açık ItemComparer atama olmadan kullanıldığında ItemsProvider uyarır.

Bileşen, nesne kimliğini kullanarak prepends algılayabildiğinden bellek Itemsiçi için bu parametre gerekli değildir.

ItemContent

Liste için öğe şablonunu alır veya ayarlar.

Items

Sabit öğe kaynağını alır veya ayarlar.

ItemSize

Her öğenin boyutunu piksel cinsinden alır. Varsayılan değer 50px'tir.

ItemsProvider

Listeye öğe sağlayan işlevi alır veya ayarlar.

MaxItemCount

İstemci, görünüm penceresi daha fazlasını gösterecek kadar büyük olduğunu bildirse bile, işlenecek en fazla öğe sayısını alır veya ayarlar. Varsayılan değer 100 şeklindedir.

Bu yalnızca aşırı bellek kullanımına veya büyük veri yüklerine karşı bir koruma olarak kullanılmalıdır. Gerçekçi boyutlu bir pencereye sığmasını beklediğinizden daha küçük bir sayıya ayarlamayın çünkü bu, aşağıda boş bir boşluk bırakır ve kullanıcı içeriğin geri kalanını göremeyebilir.

OverscanCount

Görünür bölgeden önce ve sonra kaç ek öğenin işleneceğini belirleyen bir değer alır veya ayarlar. Bu, kaydırma sırasında işleme sıklığını azaltmaya yardımcı olur. Ancak, daha yüksek değerler sayfada daha fazla öğe olacağı anlamına gelir.

Placeholder

Henüz belleğe yüklenmemiş öğeler için şablonu alır veya ayarlar.

RendererInfo

Bileşenin RendererInfo üzerinde çalıştığını alır.

(Devralındığı yer: ComponentBase)
SpacerElement

Sanallaştırma ara çubuğu olarak kullanılacak HTML öğesinin etiket adını alır veya ayarlar. Bu tür öğelerden biri görünür öğelerden önce işlenir ve bir öğe daha sonra, kaydırma aralığını denetlemek için açık bir "yükseklik" stili kullanılarak işlenir.

Varsayılan değer "div" değeridir. Örneği belirli bir alt etiket adı gerektiren bir öğenin içine yerleştiriyorsanız Virtualize<TItem> , bunu burada ayarlamayı göz önünde bulundurun. Örneğin bir "gövde" içinde işlenirken "tr" değerine ayarlamayı SpacerElement göz önünde bulundurun.

Yöntemler

Name Description
BuildRenderTree(RenderTreeBuilder)

Bileşeni sağlanan RenderTreeBuilderöğesine işler.

(Devralındığı yer: ComponentBase)
DispatchExceptionAsync(Exception)

Sağlanan exception bu bileşen tarafından oluşturuldu olarak davranır. Bu, kapsayan ErrorBoundary'nin başarısız duruma geçmesine neden olur. ErrorBoundary kapsayan bir durum yoksa, kapsayan işleyiciden bir özel durum olarak kabul edilir.

Bu, bileşen yaşam döngüsü yöntemlerinin dışında bir özel durum oluşursa, ancak bunu bir bileşen yaşam döngüsü yönteminden bir özel durum olarak ele almak istediğinizde yararlıdır.

(Devralındığı yer: ComponentBase)
DisposeAsync()

Sanallaştırılmış öğe listesini işlemek için işlevsellik sağlar.

InvokeAsync(Action)

Sağlanan iş öğesini ilişkili işleyicinin eşitleme bağlamında yürütür.

(Devralındığı yer: ComponentBase)
InvokeAsync(Func<Task>)

Sağlanan iş öğesini ilişkili işleyicinin eşitleme bağlamında yürütür.

(Devralındığı yer: ComponentBase)
OnAfterRender(Boolean)

Bileşen etkileşimli olarak işlendiğinde ve kullanıcı arabirimi güncelleştirmeyi tamamladığında (örneğin, öğeler tarayıcı DOM'sine eklendikten sonra) yöntemi çağrılır. Tüm ElementReference alanlar, bu çalışma zamanına göre doldurulur.

Bu işlemler herhangi bir canlı tarayıcı DOM'sine bağlı olmadığından ve DOM güncelleştirilmeden önce zaten tamamlandığından, bu yöntem ön kayıt veya sunucu tarafı işleme sırasında çağrılamaz.

(Devralındığı yer: ComponentBase)
OnAfterRenderAsync(Boolean)

Bileşen etkileşimli olarak her işlendiğinde ve kullanıcı arabirimi güncelleştirmeyi tamamladığında (örneğin, öğeler tarayıcı DOM'sine eklendikten sonra) yöntem çağrılır. Tüm ElementReference alanlar, bu çalışma zamanına göre doldurulur.

Bu işlemler herhangi bir canlı tarayıcı DOM'sine bağlı olmadığından ve DOM güncelleştirilmeden önce zaten tamamlandığından, bu yöntem ön kayıt veya sunucu tarafı işleme sırasında çağrılamaz.

Döndürülen herhangi bir Taskişlem tamamlandıktan sonra bileşenin otomatik olarak yeniden işlenmediğini unutmayın, çünkü bu sonsuz bir işleme döngüsüne neden olur.

(Devralındığı yer: ComponentBase)
OnInitialized()

Bileşen başlamaya hazır olduğunda, işleme ağacındaki üst öğesinden ilk parametrelerini alan yöntem çağrılır.

(Devralındığı yer: ComponentBase)
OnInitializedAsync()

Bileşen başlamaya hazır olduğunda, işleme ağacındaki üst öğesinden ilk parametrelerini alan yöntem çağrılır.

Zaman uyumsuz bir işlem gerçekleştirecekseniz ve bu işlem tamamlandığında bileşenin yenilenmesini istiyorsanız bu yöntemi geçersiz kılın.

(Devralındığı yer: ComponentBase)
OnParametersSet()

Yöntem, bileşen işleme ağacında üst öğesinden parametreler aldığında ve gelen değerler özelliklere atandığında çağrılır.

(Devralındığı yer: ComponentBase)
OnParametersSetAsync()

Yöntem, bileşen işleme ağacında üst öğesinden parametreler aldığında ve gelen değerler özelliklere atandığında çağrılır.

(Devralındığı yer: ComponentBase)
RefreshDataAsync()

Bileşenine verilerinden yeniden istekte bulunmalarını ItemsProvidersağlar. Dış veriler değişmiş olabilirse bu yararlı olur. kullanırken Itemsbunu çağırmaya gerek yoktur.

SetParametersAsync(ParameterView)

İşleme ağacında bileşenin üst öğesi tarafından sağlanan parametreleri ayarlar.

(Devralındığı yer: ComponentBase)
ShouldRender()

Bileşenin işlenip işlenmeyeceğini belirtmek için bir bayrak döndürür.

(Devralındığı yer: ComponentBase)
StateHasChanged()

Bileşene durumunun değiştiğini bildirir. Uygun olduğunda bu, bileşenin yeniden işlenmesine neden olur.

(Devralındığı yer: ComponentBase)

Belirtik Arabirim Kullanımları

Name Description
IComponent.Attach(RenderHandle)

Sanallaştırılmış öğe listesini işlemek için işlevsellik sağlar.

(Devralındığı yer: ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Sanallaştırılmış öğe listesini işlemek için işlevsellik sağlar.

(Devralındığı yer: ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Sanallaştırılmış öğe listesini işlemek için işlevsellik sağlar.

(Devralındığı yer: ComponentBase)

Şunlara uygulanır