Freigeben über


QuickGrid<TGridItem> Klasse

Definition

Eine Komponente, die ein Raster anzeigt.

[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

Typparameter

TGridItem

Der Datentyp, der durch jede Zeile im Raster dargestellt wird.

Vererbung
QuickGrid<TGridItem>
Attribute
Implementiert

Konstruktoren

QuickGrid<TGridItem>()

Erstellt eine Instanz von QuickGrid<TGridItem>.

Eigenschaften

AdditionalAttributes

Dient zum Abrufen oder Festlegen einer Auflistung zusätzlicher Attribute, die auf das erstellte Element angewendet werden.

Assets

Ruft die ResourceAssetCollection für die Anwendung ab.

(Geerbt von ComponentBase)
AssignedRenderMode

Ruft die dieser Komponente zugewiesene IComponentRenderMode ab.

(Geerbt von ComponentBase)
ChildContent

Definiert die untergeordneten Komponenten dieser Instanz. Sie können z. B. Spalten definieren, indem Sie Komponenten hinzufügen, die von der ColumnBase<TGridItem> Basisklasse abgeleitet sind.

Class

Optionaler CSS-Klassenname. Wenn angegeben, wird dies in das Klassenattribute der gerenderten Tabelle eingeschlossen.

ItemKey

Definiert optional einen Wert für @key für jede gerenderte Zeile. In der Regel sollte dies verwendet werden, um einen eindeutigen Bezeichner, z. B. einen Primärschlüsselwert, für jedes Datenelement anzugeben.

Dadurch kann das Raster die Zuordnung zwischen Zeilenelementen und Datenelementen basierend auf ihren eindeutigen Bezeichnern beibehalten, auch wenn die TGridItem-Instanzen durch neue Kopien ersetzt werden (z. B. nach einer neuen Abfrage für den zugrunde liegenden Datenspeicher).

Wenn nicht festgelegt, ist die @key die TGridItem-Instanz selbst.

Items

Eine abfragbare Datenquelle für das Raster.

Dies kann speicherinterne Daten sein, die mithilfe der AsQueryable(IEnumerable) Erweiterungsmethode oder eines EntityFramework DataSets oder eines daraus abgeleiteten IQueryable abgefragt werden können.

Sie sollten entweder Items oder ItemsProviderangeben, aber nicht beide.

ItemSize

Dies gilt nur bei verwendung von Virtualize. Es definiert eine erwartete Höhe in Pixeln für jede Zeile, sodass der Virtualisierungsmechanismus die richtige Anzahl von Elementen abruft, die der Anzeigegröße entsprechen, und um eine genaue Bildlaufgenauigkeit sicherzustellen.

ItemsProvider

Ein Rückruf, der Daten für das Raster bereitstellt.

Sie sollten entweder Items oder ItemsProviderangeben, aber nicht beide.

OverscanCount

Dies gilt nur bei verwendung von Virtualize. Es definiert, wie viele zusätzliche Elemente vor und nach dem sichtbaren Bereich gerendert werden, um die Renderinghäufigkeit während des Bildlaufs zu verringern. Während höhere Werte die Bildlaufglättung verbessern können, indem mehr Elemente außerhalb des Bildschirms gerendert werden, können sie auch die anfänglichen Ladezeiten erhöhen. Das Auffinden eines Guthabens basierend auf den Anforderungen ihrer Datenmenge und der Benutzerfreundlichkeit wird empfohlen. Der Standardwert ist 3.

Pagination

Verknüpft diese QuickGrid<TGridItem> Instanz optional mit einem PaginationState Modell, wodurch das Raster nur die aktuelle Datenseite abruft und rendert.

Dies wird normalerweise in Verbindung mit einer Paginator Komponente oder einer anderen UI-Logik verwendet, die die bereitgestellte PaginationState Instanz anzeigt und aktualisiert.

RendererInfo

Ruft die RendererInfo die Komponente ausgeführt wird.

(Geerbt von ComponentBase)
Theme

Ein Designname mit dem Standardwert "default". Dies wirkt sich darauf aus, welche Formatierungsregeln mit der Tabelle übereinstimmen.

Virtualize

Wenn true, wird das Raster mit Virtualisierung gerendert. Dies wird normalerweise in Verbindung mit dem Bildlauf verwendet und bewirkt, dass das Raster nur die Daten um den aktuellen Bildlauf-Viewport abruft und rendert. Dies kann die Leistung beim Scrollen durch große Datasets erheblich verbessern.

Wenn Sie Virtualizeverwenden, sollten Sie einen Wert für ItemSize angeben und sicherstellen, dass jede Zeile mit derselben Konstantenhöhe gerendert wird.

Im Allgemeinen empfiehlt es sich, Virtualize nicht zu verwenden, wenn die datenmenge, die gerendert wird, klein ist oder wenn Sie die Paginierung verwenden.

Methoden

BuildRenderTree(RenderTreeBuilder)

Eine Komponente, die ein Raster anzeigt.

DispatchExceptionAsync(Exception)

Behandelt die bereitgestellte exception als von dieser Komponente ausgelöst wird. Dies führt dazu, dass der eingeschlossene ErrorBoundary in einen fehlerhaften Zustand wechselt. Wenn kein "ErrorBoundary" eingeschlossen wird, wird es als Ausnahme vom eingeschlossenen Renderer angesehen.

Dies ist nützlich, wenn eine Ausnahme außerhalb der Komponentenlebenszyklusmethoden auftritt, sie aber mit einer Ausnahme aus einer Komponentenlebenszyklusmethode identisch behandeln möchten.

(Geerbt von ComponentBase)
DisposeAsync()

Eine Komponente, die ein Raster anzeigt.

InvokeAsync(Action)

Führt die angegebene Arbeitsaufgabe im Synchronisierungskontext des zugeordneten Renderers aus.

(Geerbt von ComponentBase)
InvokeAsync(Func<Task>)

Führt die angegebene Arbeitsaufgabe im Synchronisierungskontext des zugeordneten Renderers aus.

(Geerbt von ComponentBase)
OnAfterRender(Boolean)

Die Methode wird nach jedem interaktiven Rendern der Komponente aufgerufen und die Benutzeroberfläche hat die Aktualisierung abgeschlossen (z. B. nachdem elemente dem Browser-DOM hinzugefügt wurden). Alle ElementReference Felder werden nach der Ausführung aufgefüllt.

Diese Methode wird während des vor- oder serverseitigen Renderings nicht aufgerufen, da diese Prozesse keinem Livebrowser-DOM zugeordnet sind und bereits abgeschlossen sind, bevor das DOM aktualisiert wird.

(Geerbt von ComponentBase)
OnAfterRenderAsync(Boolean)

Methode wird nach jedem Rendern der Komponente interaktiv aufgerufen und die Benutzeroberfläche hat die Aktualisierung abgeschlossen (z. B. nachdem elemente dem Browser-DOM hinzugefügt wurden). Alle ElementReference Felder werden nach der Ausführung aufgefüllt.

Diese Methode wird während des vor- oder serverseitigen Renderings nicht aufgerufen, da diese Prozesse keinem Livebrowser-DOM zugeordnet sind und bereits abgeschlossen sind, bevor das DOM aktualisiert wird.

Beachten Sie, dass die Komponente nach Abschluss aller zurückgegebenen Tasknicht automatisch erneut gerendert wird, da dies zu einer endlosen Renderschleife führen würde.

OnInitialized()

Die Methode wird aufgerufen, wenn die Komponente gestartet werden kann, nachdem sie die ursprünglichen Parameter von ihrem übergeordneten Element in der Renderstruktur erhalten hat.

(Geerbt von ComponentBase)
OnInitializedAsync()

Die Methode wird aufgerufen, wenn die Komponente gestartet werden kann, nachdem sie die ursprünglichen Parameter von ihrem übergeordneten Element in der Renderstruktur erhalten hat.

Überschreiben Sie diese Methode, wenn Sie einen asynchronen Vorgang ausführen und möchten, dass die Komponente aktualisiert werden soll, wenn dieser Vorgang abgeschlossen ist.

(Geerbt von ComponentBase)
OnParametersSet()

Die Methode wird aufgerufen, wenn die Komponente Parameter von seinem übergeordneten Element in der Renderstruktur empfangen hat, und die eingehenden Werte eigenschaften zugewiesen wurden.

(Geerbt von ComponentBase)
OnParametersSetAsync()

Die Methode wird aufgerufen, wenn die Komponente Parameter von seinem übergeordneten Element in der Renderstruktur empfangen hat, und die eingehenden Werte eigenschaften zugewiesen wurden.

RefreshDataAsync()

Weist das Raster an, die aktuellen Daten aus der angegebenen Datenquelle erneut abzurufen und zu rendern (entweder Items oder ItemsProvider).

SetParametersAsync(ParameterView)

Legt Parameter fest, die vom übergeordneten Element der Komponente in der Renderstruktur bereitgestellt werden.

(Geerbt von ComponentBase)
ShouldRender()

Gibt ein Flag zurück, um anzugeben, ob die Komponente gerendert werden soll.

(Geerbt von ComponentBase)
ShowColumnOptionsAsync(ColumnBase<TGridItem>)

Zeigt die ColumnOptions Ui für die angegebene Spalte an, wobei alle anderen Zuvor angezeigten Benutzeroberfläche für Spaltenoptionen geschlossen werden.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Legt die aktuelle Sortierspalte des Rasters auf die angegebene columnfest.

StateHasChanged()

Benachrichtigt die Komponente, dass sich der Zustand geändert hat. Wenn zutreffend, führt dies dazu, dass die Komponente erneut gerendert wird.

(Geerbt von ComponentBase)

Explizite Schnittstellenimplementierungen

IComponent.Attach(RenderHandle)

Eine Komponente, die ein Raster anzeigt.

(Geerbt von ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Eine Komponente, die ein Raster anzeigt.

(Geerbt von ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Eine Komponente, die ein Raster anzeigt.

(Geerbt von ComponentBase)

Gilt für: