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 von jeder Zeile im Raster dargestellt wird.

Vererbung
QuickGrid<TGridItem>
Attribute
Implementiert

Konstruktoren

QuickGrid<TGridItem>()

Erstellt eine instance von QuickGrid<TGridItem>.

Eigenschaften

AdditionalAttributes

Ruft eine Auflistung zusätzlicher Attribute ab, die auf das erstellte Element angewendet werden, oder legt diese fest.

ChildContent

Definiert die untergeordneten Komponenten dieses instance. Beispielsweise können Sie Spalten definieren, indem Sie von der ColumnBase<TGridItem> Basisklasse abgeleitete Komponenten hinzufügen.

Class

Ein optionaler CSS-Klassenname. Wenn angegeben, wird dies im Klassenattribute der gerenderten Tabelle eingeschlossen.

ItemKey

Definiert optional einen Wert für für @key 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 sie nicht festgelegt ist, @key handelt es sich um das TGridItem-instance sich selbst.

Items

Eine abfragbare Datenquelle für das Raster.

Dabei kann es sich um In-Memory-Daten handeln, die mithilfe der AsQueryable(IEnumerable) Erweiterungsmethode in abfragebare Daten konvertiert werden können, oder um ein EntityFramework DataSet oder ein daraus abgeleitetes IQueryable Datenset.

Sie sollten entweder Items oder ItemsProviderangeben, aber nicht beide.

ItemSize

Dies gilt nur, wenn verwendet Virtualizewird. Es definiert eine erwartete Höhe in Pixel für jede Zeile, sodass der Virtualisierungsmechanismus die richtige Anzahl von Elementen abrufen kann, die der Anzeigegröße entsprechen, und um einen genauen Bildlauf sicherzustellen.

ItemsProvider

Ein Rückruf, der Daten für die Rid bereitstellt.

Sie sollten entweder Items oder ItemsProviderangeben, aber nicht beide.

Pagination

Diese instance kann optional mit einem PaginationState Modell verknüpft QuickGrid<TGridItem> werden, sodass das Raster nur die aktuelle Datenseite abruft und rendert.

Normalerweise wird dies in Verbindung mit einer Paginator-Komponente oder einer anderen Benutzeroberflächenlogik verwendet, die die bereitgestellte PaginationState-Instanz anzeigt und aktualisiert.

Theme

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

Virtualize

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

Wenn Sie verwenden Virtualize, sollten Sie einen Wert für ItemSize angeben und sicherstellen, dass jede Zeile mit derselben konstanten Höhe gerendert wird.

Im Allgemeinen empfiehlt es sich, nicht zu verwenden Virtualize , wenn die Menge der gerenderten Daten klein ist oder wenn Sie paginieren.

Methoden

BuildRenderTree(RenderTreeBuilder)

Eine Komponente, die ein Raster anzeigt.

DispatchExceptionAsync(Exception)

Behandelt die bereitgestellte exception als von dieser Komponente ausgelöst. Dies führt dazu, dass der einschließende ErrorBoundary in einen fehlerbehafteten Zustand wechselt. Wenn kein eingeschlossener ErrorBoundary vorhanden ist, wird dies als Ausnahme vom einschließenden Renderer betrachtet.

Dies ist nützlich, wenn eine Ausnahme außerhalb der Komponentenlebenszyklusmethoden auftritt, sie aber wie eine Ausnahme aus einer Komponentenlebenszyklusmethode behandelt werden soll.

(Geerbt von ComponentBase)
DisposeAsync()

Eine Komponente, die ein Raster anzeigt.

InvokeAsync(Action)

Führt das angegebene Arbeitselement im Synchronisierungskontext des zugeordneten Renderers aus.

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

Führt das angegebene Arbeitselement im Synchronisierungskontext des zugeordneten Renderers aus.

(Geerbt von ComponentBase)
OnAfterRender(Boolean)

Methode wird aufgerufen, wenn die Komponente interaktiv gerendert wurde und die Benutzeroberfläche die Aktualisierung abgeschlossen hat (z. B. nachdem Elemente zum Browser-DOM hinzugefügt wurden). Alle ElementReference Felder werden nach der Ausführungszeit aufgefüllt.

Diese Methode wird während des Vorabrenderings oder serverseitigen Renderings nicht aufgerufen, da diese Prozesse an kein Live-Browser-DOM angefügt sind und bereits abgeschlossen sind, bevor das DOM aktualisiert wird.

(Geerbt von ComponentBase)
OnAfterRenderAsync(Boolean)

Methode wird aufgerufen, nachdem die Komponente interaktiv gerendert wurde und die Benutzeroberfläche die Aktualisierung abgeschlossen hat (z. B. nachdem Elemente zum Browser-DOM hinzugefügt wurden). Alle ElementReference Felder werden nach der Ausführungszeit aufgefüllt.

Diese Methode wird während des Vorabrenderings oder serverseitigen Renderings nicht aufgerufen, da diese Prozesse an kein Live-Browser-DOM angefügt sind und bereits abgeschlossen sind, bevor das DOM aktualisiert wird.

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

OnInitialized()

Methode, die aufgerufen wird, wenn die Komponente startbereit ist, nachdem sie ihre anfänglichen Parameter von ihrem übergeordneten Element in der Renderstruktur empfangen hat.

(Geerbt von ComponentBase)
OnInitializedAsync()

Methode, die aufgerufen wird, wenn die Komponente startbereit ist, nachdem sie ihre anfänglichen Parameter von ihrem übergeordneten Element in der Renderstruktur empfangen hat.

Überschreiben Sie diese Methode, wenn Sie einen asynchronen Vorgang ausführen und die Komponente nach Abschluss dieses Vorgangs aktualisieren soll.

(Geerbt von ComponentBase)
OnParametersSet()

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

(Geerbt von ComponentBase)
OnParametersSetAsync()

Methode wird aufgerufen, wenn die Komponente Parameter von ihrem ü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 (entweder oder ItemsProvider) Items erneut abzurufen und zu rendern.

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, das angibt, ob die Komponente gerendert werden soll.

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

Zeigt die ColumnOptions Benutzeroberfläche für die angegebene Spalte an und schließt alle anderen Zuvor angezeigten Benutzeroberfläche für Spaltenoptionen.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Legt die aktuelle Sortierspalte des Rasters auf die angegebene columnfest.

StateHasChanged()

Benachrichtigt die Komponente, dass sich ihr Zustand geändert hat. Dies führt ggf. 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: