Condividi tramite


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

QuickGrid<TGridItem>()

Costruisce un'istanza di QuickGrid<TGridItem>.

Proprietà

AdditionalAttributes

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

ChildContent

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

Class

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

ItemKey

Facoltativamente, definisce un valore per @key in 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, il @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 metodo di estensione AsQueryable(IEnumerable) oppure un oggetto EntityFramework DataSet o un IQueryable derivato da esso.

È consigliabile specificare Items o ItemsProvider, ma non entrambi.

ItemSize

Questa operazione è 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.

OverscanCount

Questa operazione è 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 istanza di QuickGrid<TGridItem> a un modello di PaginationState, causando il recupero della griglia e il rendering solo della pagina corrente di dati.

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

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 viene eseguito il rendering è ridotta o se si usa la paginazione.

Metodi

BuildRenderTree(RenderTreeBuilder)

Componente che visualizza una griglia.

DispatchExceptionAsync(Exception)

Considera la exception fornita come generata 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.

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 campi ElementReference 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 campi ElementReference 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 Taskrestituito, 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.

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

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 utente ColumnOptions 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 sul columnspecificato.

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

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