Lingua

QuickGrid<TGridItem> Classe

Definizione

Componente che visualizza una griglia.

[Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")]
public class QuickGrid<TGridItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
[Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")]
[Microsoft.AspNetCore.Components.CacheBehavior(Microsoft.AspNetCore.Components.CacheBehavior.Throw)]
[Microsoft.AspNetCore.Components.CacheCondition(Microsoft.AspNetCore.Components.CacheVaryBy.Query)]
public class QuickGrid<TGridItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
[<Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")>]
type QuickGrid<'GridItem> = class
    inherit ComponentBase
    interface IAsyncDisposable
[<Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")>]
[<Microsoft.AspNetCore.Components.CacheBehavior(Microsoft.AspNetCore.Components.CacheBehavior.Throw)>]
[<Microsoft.AspNetCore.Components.CacheCondition(Microsoft.AspNetCore.Components.CacheVaryBy.Query)>]
type QuickGrid<'GridItem> = class
    inherit ComponentBase
    interface IAsyncDisposable
Public Class QuickGrid(Of TGridItem)
Inherits ComponentBase
Implements IAsyncDisposable

Parametri di tipo

TGridItem

Tipo di dati rappresentato da ogni riga nella griglia.

Ereditarietà
QuickGrid<TGridItem>
Attributi
Implementazioni

Costruttori

Nome Descrizione
QuickGrid<TGridItem>()

Costruisce un'istanza di QuickGrid<TGridItem>.

Proprietà

Nome Descrizione
AdditionalAttributes

Ottiene o imposta una raccolta di attributi aggiuntivi che verranno applicati all'elemento creato.

AnchorMode

Ottiene o imposta la modalità di ancoraggio che controlla il comportamento del riquadro di visualizzazione ai bordi dell'elenco quando arrivano nuovi elementi durante la virtualizzazione. Il valore predefinito è Start.

Questo ha effetto solo quando Virtualize è true. Per l'ancoraggio affidabile con tipi di riferimento che non dispongono di semantica di uguaglianza dei valori, specificare un oggetto ItemComparer in modo che la griglia possa rilevare se gli elementi sono stati anteporti o accodati.

Assets

Ottiene l'oggetto ResourceAssetCollection per l'applicazione.

(Ereditato da ComponentBase)
AssignedRenderMode

Ottiene l'oggetto IComponentRenderMode assegnato a questo componente.

(Ereditato da ComponentBase)
ChildContent

Definisce i componenti figlio di questa istanza. Ad esempio, è possibile definire colonne aggiungendo componenti derivati dalla ColumnBase<TGridItem> classe base.

Class

Nome facoltativo della classe CSS. Se specificato, verrà incluso nell'attributo della classe della tabella di cui è stato eseguito il rendering.

InitialItemIndex

Questo è applicabile solo quando si usa Virtualize. Ottiene o imposta l'indice in base zero della riga su cui scorrere il primo rendering interattivo. Applicato una volta quando la griglia conosce per la prima volta il conteggio degli elementi e viene ignorato nei successivi rendering; per scorrere a livello di codice in qualsiasi punto successivo, chiamare ScrollToItemAsync(Int32, CancellationToken). I valori non compresi nell'intervallo sono bloccati. Il valore predefinito, 0, non indica uno scorrimento iniziale.

ItemComparer

Ottiene o imposta un operatore di confronto utilizzato durante la virtualizzazione per rilevare se gli elementi sono stati anteporti o accodati tra carichi di dati. Quando le finestre del provider si sovrappongono, l'operatore di confronto determina se un elemento sottoposto a rendering precedentemente modificato nello stesso indice globale, che indica che gli elementi sono stati inseriti sopra il riquadro di visualizzazione corrente, in modo che la griglia possa mantenere ancorato il riquadro di visualizzazione.

Fornire un operatore di confronto che confronta gli elementi in base a un identificatore univoco stabile, ad esempio una chiave primaria. Di default è Default. Per i record e i tipi che implementano IEquatable<T>, il valore predefinito funziona automaticamente (uguaglianza dei valori). Per i tipi di riferimento senza semantica di uguaglianza dei valori, l'impostazione predefinita esegue il fallback all'uguaglianza dei riferimenti, che produce il rilevamento dei prepend falsi positivi quando l'origine dati restituisce istanze aggiornate tra i carichi.

Questo ha effetto solo quando Virtualize è true.

ItemKey

Facoltativamente, definisce un valore per in @key ogni riga sottoposta a rendering. In genere, questo deve essere usato per specificare un identificatore univoco, ad esempio un valore di chiave primaria, per ogni elemento di dati.

Ciò consente alla griglia di mantenere l'associazione tra elementi di riga ed elementi di dati in base ai relativi identificatori univoci, anche quando le istanze di TGridItem vengono sostituite da nuove copie, ad esempio dopo una nuova query sull'archivio dati sottostante.

Se non impostato, @key sarà l'istanza TGridItem stessa.

Items

Origine di dati querybile per la griglia.

Potrebbe trattarsi di dati in memoria convertiti in queryable usando il AsQueryable(IEnumerable) metodo di estensione o un Oggetto EntityFramework DataSet o un IQueryable oggetto derivato da esso.

È consigliabile specificare Items o ItemsProvider, ma non entrambi.

ItemSize

Questo è applicabile solo quando si usa Virtualize. Definisce un'altezza prevista in pixel per ogni riga, consentendo al meccanismo di virtualizzazione di recuperare il numero corretto di elementi in modo che corrispondano alle dimensioni di visualizzazione e per garantire uno scorrimento accurato.

ItemsProvider

Callback che fornisce dati per la griglia.

È consigliabile specificare Items o ItemsProvider, ma non entrambi.

OnRowClick

Optional. Callback richiamato quando si fa clic su una riga.

OverscanCount

Questo è applicabile solo quando si usa Virtualize. Definisce il numero di elementi aggiuntivi di cui verrà eseguito il rendering prima e dopo l'area visibile per ridurre la frequenza di rendering durante lo scorrimento. Anche se i valori più elevati possono migliorare la fluidità dello scorrimento eseguendo il rendering di più elementi sullo schermo, possono anche aumentare i tempi di caricamento iniziali. È consigliabile trovare un equilibrio in base alle dimensioni del set di dati e ai requisiti dell'esperienza utente. Il valore predefinito è 3.

Pagination

Facoltativamente, collega questa QuickGrid<TGridItem> istanza a un PaginationState modello, causando il recupero della griglia e il rendering solo della pagina corrente di dati.

Viene in genere usato insieme a un Paginator componente o a un'altra logica dell'interfaccia utente che visualizza e aggiorna l'istanza fornita PaginationState .

QueryParameterNameOptions

Specifica l'oggetto QueryParameterNameOptions utilizzato per rendere persistente la pagina, ordinare la colonna e la direzione di ordinamento nell'URL. Il valore predefinito è un'istanza i cui parametri di query sono denominati "page", "sort" e "direction".

RendererInfo

Ottiene il RendererInfo componente in esecuzione.

(Ereditato da ComponentBase)
RowClass

Optional. Callback da richiamare per ogni riga sottoposta a rendering per specificare una classe CSS.

Theme

Nome del tema, con valore predefinito "default". Ciò influisce sulle regole di stile che corrispondono alla tabella.

Virtualize

Se true, verrà eseguito il rendering della griglia con la virtualizzazione. In genere viene usato insieme allo scorrimento e fa sì che la griglia recuperi e esegua il rendering solo dei dati intorno al viewport di scorrimento corrente. Ciò può migliorare notevolmente le prestazioni durante lo scorrimento tra set di dati di grandi dimensioni.

Se si usa Virtualize, è necessario specificare un valore per ItemSize e assicurarsi che ogni riga esegua il rendering con la stessa altezza costante.

In genere è preferibile non usare Virtualize se la quantità di dati di cui è stato eseguito il rendering è ridotta o se si usa la paginazione.

Metodi

Nome Descrizione
BuildRenderTree(RenderTreeBuilder)

Componente che visualizza una griglia.

DispatchExceptionAsync(Exception)

Considera l'oggetto fornito exception come generato da questo componente. In questo modo, l'inclusione di ErrorBoundary passerà a uno stato di errore. Se non è presente alcuna inclusione di ErrorBoundary, verrà considerata un'eccezione dal renderer contenitore.

Ciò è utile se si verifica un'eccezione all'esterno dei metodi del ciclo di vita del componente, ma si vuole considerarla come un'eccezione da un metodo del ciclo di vita del componente.

(Ereditato da ComponentBase)
DisposeAsync()

Componente che visualizza una griglia.

HideColumnOptionsAsync()

Chiude l'interfaccia ColumnOptions utente visualizzata in precedenza.

InvokeAsync(Action)

Esegue l'elemento di lavoro fornito nel contesto di sincronizzazione del renderer associato.

(Ereditato da ComponentBase)
InvokeAsync(Func<Task>)

Esegue l'elemento di lavoro fornito nel contesto di sincronizzazione del renderer associato.

(Ereditato da ComponentBase)
OnAfterRender(Boolean)

Metodo richiamato dopo ogni volta che il rendering del componente è stato eseguito in modo interattivo e l'interfaccia utente ha terminato l'aggiornamento (ad esempio, dopo l'aggiunta di elementi al DOM del browser). Tutti i ElementReference campi verranno popolati dall'ora di esecuzione.

Questo metodo non viene richiamato durante il prerendering o il rendering sul lato server, perché tali processi non sono collegati a alcun DOM del browser attivo e sono già stati completati prima dell'aggiornamento del DOM.

(Ereditato da ComponentBase)
OnAfterRenderAsync(Boolean)

Metodo richiamato dopo ogni volta che il rendering del componente è stato eseguito in modo interattivo e l'interfaccia utente ha terminato l'aggiornamento (ad esempio, dopo l'aggiunta di elementi al DOM del browser). Tutti i ElementReference campi verranno popolati dall'ora di esecuzione.

Questo metodo non viene richiamato durante il prerendering o il rendering sul lato server, perché tali processi non sono collegati a alcun DOM del browser attivo e sono già stati completati prima dell'aggiornamento del DOM.

Si noti che il componente non esegue automaticamente il rendering dopo il completamento di qualsiasi oggetto restituito Task, perché ciò causerebbe un ciclo di rendering infinito.

OnInitialized()

Metodo richiamato quando il componente è pronto per l'avvio, dopo aver ricevuto i parametri iniziali dal relativo elemento padre nell'albero di rendering.

OnInitialized()

Metodo richiamato quando il componente è pronto per l'avvio, dopo aver ricevuto i parametri iniziali dal relativo elemento padre nell'albero di rendering.

(Ereditato da ComponentBase)
OnInitializedAsync()

Metodo richiamato quando il componente è pronto per l'avvio, dopo aver ricevuto i parametri iniziali dal relativo elemento padre nell'albero di rendering.

Eseguire l'override di questo metodo se si eseguirà un'operazione asincrona e si desidera che il componente venga aggiornato al termine dell'operazione.

(Ereditato da ComponentBase)
OnParametersSet()

Metodo richiamato quando il componente ha ricevuto parametri dal relativo elemento padre nell'albero di rendering e i valori in ingresso sono stati assegnati alle proprietà.

(Ereditato da ComponentBase)
OnParametersSetAsync()

Metodo richiamato quando il componente ha ricevuto parametri dal relativo elemento padre nell'albero di rendering e i valori in ingresso sono stati assegnati alle proprietà.

RefreshDataAsync()

Indica alla griglia di recuperare nuovamente ed eseguire il rendering dei dati correnti dall'origine dati fornita ( Items o ItemsProvider).

ScrollToItemAsync(Int32, CancellationToken)

Scorre la griglia virtualizzata in modo che la riga in itemIndex sia allineata alla parte superiore dell'area scorrevole. Ha effetto solo quando Virtualize è true.

SetParametersAsync(ParameterView)

Imposta i parametri forniti dall'elemento padre del componente nell'albero di rendering.

(Ereditato da ComponentBase)
ShouldRender()

Restituisce un flag per indicare se il componente deve eseguire il rendering.

(Ereditato da ComponentBase)
ShowColumnOptionsAsync(ColumnBase<TGridItem>)

Visualizza l'interfaccia ColumnOptions utente per la colonna specificata, chiudendo qualsiasi altra interfaccia utente delle opzioni di colonna visualizzata in precedenza.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Imposta la colonna di ordinamento corrente della griglia sull'oggetto specificato column.

StateHasChanged()

Notifica al componente che il relativo stato è stato modificato. Se applicabile, il rendering del componente verrà eseguito di nuovo.

(Ereditato da ComponentBase)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IComponent.Attach(RenderHandle)

Componente che visualizza una griglia.

(Ereditato da ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Componente che visualizza una griglia.

(Ereditato da ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Componente che visualizza una griglia.

(Ereditato da ComponentBase)

Si applica a