SubGrid

Die Komponente SubGrid zeigt Dataverse-Datensätze an, die mit einem übergeordneten Datensatz verbunden sind, über eine bestimmte Beziehung. Er muss in ein RecordContext Feld gesetzt werden und benötigt einen Parameter RelationshipName , der angibt, welche Beziehung verwendet werden soll.

Beziehungstypen

SubGrid unterstützt sowohl Eins-zu-Viele (1:N) als auch viele-zu-viele (N:N)-Beziehungen. Die Komponente erkennt automatisch den Beziehungstyp und passt sein Verhalten entsprechend an.

  • Für 1:N-Beziehungen zeigt das Raster Datensätze aus der zugehörigen Tabelle an, die auf den Elterndatensatz verweisen. Werkzeugleisten-Buttons wie NewRecordGridButton, OpenRecordGridButton, und DeleteRecordGridButton werden verwendet, um verwandte Datensätze zu erstellen, zu bearbeiten und zu löschen.
  • Für N:N-Beziehungen zeigt das Raster zugehörige Datensätze an. Toolbar-Buttons wie LinkExistingRecordGridButton und UnlinkExistingRecordGridButton werden verwendet, um Datensätze zu verknüpfen und zu trennen. Erstellungs- und Löschoperationen werden automatisch in Associate- und Disassociate-Anfragen umgewandelt.

Ansichten

Geben Sie ViewIds an, welche Ansichten im Dropdown-Menü verfügbar sind, und DefaultViewId um die ursprünglich ausgewählte Ansicht festzulegen. Wenn keines von beiden bereitgestellt wird, lädt das Raster automatisch alle öffentlichen Ansichten der zugehörigen Tabelle. Sie können auch Inline-FetchXML bereitstellen CustomViewDefinitions , um Ansichten direkt im Code zu definieren.

React
Blazor

Werkzeugleisten-Buttons

Füge mit dem Buttons Renderfragment Buttons zur Rasterleiste hinzu. Siehe die Dokumentation zu den Grid Buttons für detaillierte Konfigurationsoptionen, einschließlich Dialogpositionierung, Assistentenformulare und Speicherverhalten. Folgende eingebaute Tasten sind verfügbar:

  • NewRecordGridButton — Öffnet ein Dialogformular, um einen neuen zugehörigen Datensatz zu erstellen (1:N)
  • OpenRecordGridButton — Öffnet ein Dialogformular, um den ausgewählten Datensatz zu bearbeiten
  • DeleteRecordGridButton — Löscht ausgewählte Datensätze
  • LinkExistingRecordGridButton — Verknüpft einen bestehenden Datensatz über eine N:N-Beziehung
  • UnlinkExistingRecordGridButton — Trennt ausgewählte Datensätze aus einer N:N-Beziehung
  • NavigateNewRecordGridButton — Navigiert zu einer URL, um einen neuen Datensatz zu erstellen.
  • NavigateOpenRecordGridButton — Navigiert zu einer URL, um den ausgewählten Datensatz zu bearbeiten
React
Blazor

Inline-Schnitt

Aktivieren AllowEdit="true" Sie einen Einstellungsschalter, der es den Nutzern ermöglicht, in den Inline-Bearbeitungsmodus zu wechseln. Wenn aktiviert, werden editierbare Spalten direkt im Raster als Formularsteuerung gerendert. Inline-Bearbeitung wird nur für 1:N-Beziehungen unterstützt.

React
Blazor

Paging & Suche

Das Raster unterstützt Seitennavigation mit konfigurierbaren Seitengrößen über DefaultItemsPerPage und PageSizes. Die Suche ist standardmäßig aktiviert und kann mit AllowSearch="false"deaktiviert werden.

React
Blazor

SubGrid (Eins-zu-viele-Beziehung)

Das folgende Beispiel zeigt eine SubGrid Anzeige von Kontakten, die über die Beziehung contact_customer_accounts mit einem Konto verbunden sind. Es enthält Schaltflächen zum Erstellen, Bearbeiten und Löschen von Kontakten.

React-Beispiel
Blazor-Beispiel
Alle KontakteMeine Kontakte
Neu
Alle KontakteMeine Kontakte
Neu

Seitengröße

102050100
Vollständiger Name
Mobiltelefon
E-Mail
Firmenname
Alter
Bradford Kiehn(878) 546-1743Bradford.Kiehn13@yahoo.comAbernathy - MacGyver64
Jaydon Baumbach(091) 769-5345Jaydon.Baumbach5@gmail.comAbernathy - MacGyver63
Karlee Kuphal(651) 890-0779Karlee11@yahoo.comAbernathy - MacGyver59
Keshawn Lubowitz(405) 079-0110Keshawn_Lubowitz@yahoo.comAbernathy - MacGyver24
Salma Yost(175) 474-8388Salma_Yost@yahoo.comAbernathy - MacGyver55
React TypeScript
Razor
AccountAndContactCustomViews.cs

SubGrid (Viele-zu-Viele-Beziehung)

Das folgende Beispiel zeigt, dass Bereiche SubGrid eines Kontos über die ppp_Account_ppp_Region_ppp_Region viele-zu-viele-Beziehung angezeigt werden.

React-Beispiel
Blazor-Beispiel
Aktive RegionenInaktive Regionen
Link-Existenz
Aktive RegionenInaktive Regionen
Link-Existenz

Seitengröße

102050100
Name
Keine Unterlagen gefunden.
React TypeScript
Razor
Reagieren Blazor

SubGrid Baureihe

Parameter

Name
Typ
Default
Beschreibung
AllowChangingPageSizebool
True
Wenn zutreffend, kann der Benutzer die Anzahl der angezeigten Elemente pro Seite ändern.
AllowDownloadForFileColumnsbool
True
Wenn true (der Standard), rendert das Raster ein Download-Icon pro Zeile an der Hinterkante von Datei- und Bildspaltenzellen. Wenn man darauf klickt, wird die Datei auf die Browser des Nutzers. Auf falsch eingestellt, um das Symbol zu unterdrücken – zum Beispiel bei Schreibschutz Audit-Grids, in denen Dateiexport nicht erlaubt ist.
AllowEditbool
False
Sollte die Option für den Benutzer verfügbar sein, die Inline-Bearbeitung für das Raster zu aktivieren.
AllowNavigateOnPrimaryNameClickbool
True
Wenn true (der Standard) und das Raster einen registrierten 'Bearbeiten'-Button hat (a GridButton mit IsOpenRecordButton=true), der Zelle, die rendert Die Spalte Primärname der Tabelle wird zu einem Hyperlink. Wenn man darauf klickt, wird dasselbe gesendet per-Zeilen-Aufruf, wie ein Doppelklick auf eine Zeile machen würde – sodass ein Benutzer zur Bearbeitung springen kann formular (oder die navigierte Bearbeitungs-URL, je nach registriertem Button) ohne First Wähle die Reihe aus. Setzen Sie auf falsch , um den Hyperlink zu unterdrücken und das Symbol darzustellen Primärname-Zelle als Klartext. Hat keinen Effekt, wenn kein Bearbeiten-Button registriert ist.
AllowNavigateOnRowDoubleClickbool
True
Wenn true (der Standard) und das Raster einen registrierten 'Bearbeiten'-Button hat (a GridButton mit IsOpenRecordButton=true), indem man eine Zeile doppelt anklickt ruft das OnClick dieser Schaltfläche für den Datensatz der Zeile auf – öffnen den Bearbeitungsdialog oder die Navigation zur URL bearbeiten, je nachdem, was der Button macht. Stellen Sie auf falsch , um den Doppelklick-Handler zu unterdrücken. Hat keine Wirkung, wenn kein Bearbeiten-Button fehlt ist registriert.
AllowPreviewForFileColumnsbool
True
Wenn true (der Standard), rendert das Raster ein per-Zeilen-'Augen'-Vorschau-Icon an der Hinterkante von Datei- und Bildspaltenzellen, deren Inhalt inline gerendert werden kann (Bilder, PDFs, Klartext). Auf falsch setzen, um das Symbol zu unterdrücken – zum Beispiel auf Raster, in denen die Spalten nicht auch als Vorschau-Einstiegspunkt dienen sollten.
AllowSearchbool
True
Sollte der Nutzer das Raster durchsuchen dürfen.
BorderVisiblebool
True
Kontrolliert, ob ein sichtbarer Rand um das Raster herum gerendert wird.
ButtonsRenderFragment?
Optionales Renderfragment, das zur Definition der Tastenleiste über dem Raster verwendet wird.
ColumnsRenderFragment?
Optionales Fragment mit verbraucherdeklariertem Fragment Components.GridColumnsComponents.GridColumn Kinder. Wenn es versorgt ist, schaltet das Netz auf Ersetzmodus: Nur die deklarierten Spalten werden gerendert (in deklariert Reihenfolge), wird die FetchXML-Projektion umgeschrieben, um zu entsprechen, und die Die Spaltenliste von Underlying View wird ignoriert. null belässt das Raster in seinem Standardverhalten (Spalten automatisch generieren aus die aufgelöste Spaltenmenge der Ansicht).
CustomViewDefinitionsList<GridViewDefinition>?
Benutzerdefinierte Ansichten, die im Dropdown-Menü angezeigt werden.
DataSourceViewDataSource?
Optional, geteilt Data.ViewDataSource. Wenn gesetzt, ist das Gitter liest seine Zeilen + Gesamtanzahl aus der Datenquelle statt Eigene Ausgabe RetrieveRecordsAsync(System.String) Call — dieselbe Datenquelle kann ein Geschwister steuern <DataverseChart> oder ein zweites Gitter, sodass sie alle Paginierung / Filter / Suche zusammen auf einer Hin- und Rückfahrt. Eigenständige Nutzung (ohne GridBase.DataSource) hält das bestehende interne Zustandsmaschine – das Gitter erstellt FetchXML und holt direkt über IPowerPortalsProService . Was die Datenquelle NICHT besitzt: eine Benutzeroberfläche pro Gitter Zustand (ausgewählte Zeilen, ausstehende Zeilen, erstellt / aktualisiert / löscht), Spaltenbreiten). Diese bleiben grid-lokal – zwei Grids, die sich eines teilen Die Datenquelle kann weiterhin eine unabhängige Auswahl und ein per-Gitter-System haben Bearbeitungen stehen aus. Wenn ViewDataSource.Highlight gesetzt wird (z. B. über eine Diagramm-Schnittklick im Kreuzfilter-'Highlight'-Modus), Zeilen, deren Zeilen Der Wert in der hervorgehobenen Spalte passt nicht visuell zu gedämpft über eine CSS-Klasse; Die Zeilendaten + Auswahl sind Unbeeinflusst (der Soft Cross-Filter ist rein Styling).
DefaultItemsPerPageint
50
Standardanzahl der Datensätze, die auf einer Seite geladen werden sollen.
DefaultViewIdGuid?
Der Ansicht, dass das Raster beim ersten Laden angezeigt werden sollte.
Editablebool
False
Ist das Inline-Editing für das Raster aktiviert?
FiltersIReadOnlyList<GridFilterBase>?
Zusätzliche serverseitige Filter AND-merged auf die aufgelösten Ansichten FetchXML vor Auspagieren, Sortieren und Suchen setzt ein. Weitergeleitet an Query.IFetchXmlQueryComposer's FetchXmlQueryOptions.Filters, Jeder Eintrag wird also nach Laufzeittyp gesendet (z. B. Models.RelationshipFilter AND-verschmilzt eine Beziehungsverbindungs-Entität). Typische Nutzung: Der LinkExistingRecordGridButton-Picker übergibt einen Models.RelationshipFilter mit RelationshipFilterMode.ExcludeExistingRecords Also schon- verknüpfte Datensätze sind im M2M-Suche-Dialog verborgen. Kombiniert additiv mit SubGrids eigenem internen System Beziehungsfilter (der direkt im FetchXML integriert ist) anstatt durch den Komponisten-Filter-Slot zu gehen) – beide enden Auf derselben Anfrage.
FullSizebool
False
Wenn zutreffend, dehnt sich das Gitter aus, um den gesamten verfügbaren vertikalen Raum auszufüllen, anstatt eine feste Mindesthöhe zu verwenden.
HidePagingbool
False
Erzwingen Sie, dass die Seitengröße und die Auslagerungskomponenten ausgeborgen werden. Tun Sie dies nur, wenn die Anzahl der Elemente bekannt ist und die Seitengröße auf etwas höher als die Anzahl der Artikel gesetzt ist.
IncludeSearchInPersistedStatebool
False
Wenn zutreffend, wird der aktive Suchtext in die persistente Version einbezogen state-URL-Parameter (unter dem q-Feld ). Standardwert auf falsch — Suchbegriffe sensibel sein können, sich im Browserverlauf ansammeln, und in HTTP-Referrer durchsickern, sodass das Raster sie aus der URL heraushält, es sei denn, Der Verbraucher meldet sich ausdrücklich ein. Hat keine Wirkung, wenn GridBase.PersistedStateQueryParameter nicht festgelegt ist.
IsDirtybool
False
Gibt an, ob das Grid noch nicht gespeicherte Erstellungs-, Aktualisierungs- oder Löschvorgänge hat.
LoadedRecordsIEnumerable<TableRecord>
Datensätze, die derzeit im Raster (der aktuellsten Seite mit Ergebnissen) gerendert werden. Gedacht für Toolbar-Befehle, die auf 'alles Gezeigte' reagieren müssen – z. B. eine Bulk Download-Button. Erstreckt sich nicht über Seiten; Bulk-Querseiten-Operationen sollten ihre Stattdessen eigene unpaged-Apport.
MaxHeightstring?
Maximale Höhe, auf die sich die Gittersteuerung ausdehnen sollte.
MinHeightstring?
300px
Minimale Höhe, die die Grid-Steuerung einnehmen sollte.
ModeGridMode
RecordSelection
Legt den Verhaltensmodus des Rasters fest, wie z. B. Standardinteraktion oder Datensatzauswahlmodus.
PageSizesIEnumerable<int>
Sammlung verfügbarer Seitengrößen für das Raster.
PagingModeGridPagingMode
Paged
Bestimmt, ob das Raster traditionelle Paging- oder Unendlichkeits-Scroll-Virtualisierung verwendet.
PersistedRowsSnapshotPersistedGridRowsSnapshot?
Server-Prerender → interaktives Handoff für die gerenderte Seite mit Zeilen. Das Rahmenwerk Erhält diese Eigenschaft am Ende von Prerender automatisch erhalten und rehydriert sie davor GridBase.OnInitializedAsync auf der interaktiven Seite, also kann der Datenabruf Ich habe das erste interaktive Rendering übersprungen. Wird durch die Position des Renderbaums durch das Framework geschlüsselt; Das Feld PersistedGridRowsSnapshot.ViewId wird beim Verbrauch überprüft Zeit, also wirft ein Rerender gegen eine andere Ansicht die veralteten Reihen weg. Öffentlichkeit gemäß der Anforderung des Rahmens – [PersistentState] sieht öffentliche Objekte nur über Reflexion – aber nicht dazu gedacht, extern gesetzt zu werden.
PersistedStateQueryParameterstring?
Name des URL-Abfragestring-Parameters, um das interaktive Raster zu erhalten Staat an. Wenn gesetzt, liest das Gitter diesen Parameter bei der Anfangslast und Seeds die aktive Ansicht, Seitenzahl, Seitengröße und sortieren daraus; nachfolgende Benutzeraktionen (Ansichtsauswahl, Seitenänderung, Kopfzeilensortierung usw.) Schreibe den neuen Zustand zurück über Components.NavigationManager's Ersetz-Zustand-Pfad. Persistenz übersteht Seitenaktualisierung und Lesezeichen.
RecordTableRecord?
Der übergeordnete Datensatz wird über einen kaskadierenden Parameter bereitgestellt; verwandte Datensätze werden nach der Identität dieses Datensatzes gefiltert.
RelationshipName*string
Der Schemaname der Beziehung, die verwendet wird, um verwandte Datensätze in diesem Sub-Grid zu filtern und anzuzeigen.
SelectedRecordsIEnumerable<TableRecord>
Datensätze, die derzeit im Raster ausgewählt sind.
SelectFromEntireRowbool
True
Wenn das stimmt, wählt ein Klick auf eine beliebige Zeile sie aus; wenn falsch, wählt nur das Kontrollkästchen die Zeile aus.
SelectModeDataGridSelectMode
Multiple
Kontrolliert, ob das Raster eine einzelne oder mehrere Zeilen auswählt.
Titlestring?
Name, der angezeigt wird, wenn das Dropdown-Menü nicht angezeigt wird.
TransformViewAsyncFunc<GridViewDefinition, Task<GridViewDefinition>>?
Optionaler Callback, der unmittelbar nach dem Laden einer Ansicht und vor der Nutzung des Grids ausgeführt wird Es soll Spalten oder Abfragen erstellen. Geben Sie ein modifiziertes Models.GridViewDefinition Formular zurück zu transformieren Sie, was das Raster letztlich rendert – zum Beispiel, um eine bestimmte Spalte sicherzustellen ist unabhängig von der eigenen Konfiguration der Ansicht immer vorhanden. Asynchron, damit Anrufer es können Konsultieren Sie Metadaten-Caches, Dienste oder andere asynchrone Ressourcen bei der Entscheidung, was zu tun ist Include.
ViewIdsIEnumerable<Guid>?
Liste der IDs der Ansichten, auf die das Raster im Dropdown-Menü beschränkt werden sollte.
ViewSortViewSort
NameAscending
Sortiere die Reihenfolge der Ansichten im Ansichts-Dropdown.
Name: AllowChangingPageSize
Typ: bool
Default: True
Beschreibung: Wenn zutreffend, kann der Benutzer die Anzahl der angezeigten Elemente pro Seite ändern.
Name: AllowDownloadForFileColumns
Typ: bool
Default: True
Beschreibung: Wenn true (der Standard), rendert das Raster ein Download-Icon pro Zeile an der Hinterkante von Datei- und Bildspaltenzellen. Wenn man darauf klickt, wird die Datei auf die Browser des Nutzers. Auf falsch eingestellt, um das Symbol zu unterdrücken – zum Beispiel bei Schreibschutz Audit-Grids, in denen Dateiexport nicht erlaubt ist.
Name: AllowEdit
Typ: bool
Default: False
Beschreibung: Sollte die Option für den Benutzer verfügbar sein, die Inline-Bearbeitung für das Raster zu aktivieren.
Name: AllowNavigateOnPrimaryNameClick
Typ: bool
Default: True
Beschreibung: Wenn true (der Standard) und das Raster einen registrierten 'Bearbeiten'-Button hat (a GridButton mit IsOpenRecordButton=true), der Zelle, die rendert Die Spalte Primärname der Tabelle wird zu einem Hyperlink. Wenn man darauf klickt, wird dasselbe gesendet per-Zeilen-Aufruf, wie ein Doppelklick auf eine Zeile machen würde – sodass ein Benutzer zur Bearbeitung springen kann formular (oder die navigierte Bearbeitungs-URL, je nach registriertem Button) ohne First Wähle die Reihe aus. Setzen Sie auf falsch , um den Hyperlink zu unterdrücken und das Symbol darzustellen Primärname-Zelle als Klartext. Hat keinen Effekt, wenn kein Bearbeiten-Button registriert ist.
Name: AllowNavigateOnRowDoubleClick
Typ: bool
Default: True
Beschreibung: Wenn true (der Standard) und das Raster einen registrierten 'Bearbeiten'-Button hat (a GridButton mit IsOpenRecordButton=true), indem man eine Zeile doppelt anklickt ruft das OnClick dieser Schaltfläche für den Datensatz der Zeile auf – öffnen den Bearbeitungsdialog oder die Navigation zur URL bearbeiten, je nachdem, was der Button macht. Stellen Sie auf falsch , um den Doppelklick-Handler zu unterdrücken. Hat keine Wirkung, wenn kein Bearbeiten-Button fehlt ist registriert.
Name: AllowPreviewForFileColumns
Typ: bool
Default: True
Beschreibung: Wenn true (der Standard), rendert das Raster ein per-Zeilen-'Augen'-Vorschau-Icon an der Hinterkante von Datei- und Bildspaltenzellen, deren Inhalt inline gerendert werden kann (Bilder, PDFs, Klartext). Auf falsch setzen, um das Symbol zu unterdrücken – zum Beispiel auf Raster, in denen die Spalten nicht auch als Vorschau-Einstiegspunkt dienen sollten.
Name: AllowSearch
Typ: bool
Default: True
Beschreibung: Sollte der Nutzer das Raster durchsuchen dürfen.
Name: BorderVisible
Typ: bool
Default: True
Beschreibung: Kontrolliert, ob ein sichtbarer Rand um das Raster herum gerendert wird.
Name: Buttons
Typ: RenderFragment?
Beschreibung: Optionales Renderfragment, das zur Definition der Tastenleiste über dem Raster verwendet wird.
Name: Columns
Typ: RenderFragment?
Beschreibung: Optionales Fragment mit verbraucherdeklariertem Fragment Components.GridColumnsComponents.GridColumn Kinder. Wenn es versorgt ist, schaltet das Netz auf Ersetzmodus: Nur die deklarierten Spalten werden gerendert (in deklariert Reihenfolge), wird die FetchXML-Projektion umgeschrieben, um zu entsprechen, und die Die Spaltenliste von Underlying View wird ignoriert. null belässt das Raster in seinem Standardverhalten (Spalten automatisch generieren aus die aufgelöste Spaltenmenge der Ansicht).
Name: CustomViewDefinitions
Typ: List<GridViewDefinition>?
Beschreibung: Benutzerdefinierte Ansichten, die im Dropdown-Menü angezeigt werden.
Name: DataSource
Typ: ViewDataSource?
Beschreibung: Optional, geteilt Data.ViewDataSource. Wenn gesetzt, ist das Gitter liest seine Zeilen + Gesamtanzahl aus der Datenquelle statt Eigene Ausgabe RetrieveRecordsAsync(System.String) Call — dieselbe Datenquelle kann ein Geschwister steuern <DataverseChart> oder ein zweites Gitter, sodass sie alle Paginierung / Filter / Suche zusammen auf einer Hin- und Rückfahrt. Eigenständige Nutzung (ohne GridBase.DataSource) hält das bestehende interne Zustandsmaschine – das Gitter erstellt FetchXML und holt direkt über IPowerPortalsProService . Was die Datenquelle NICHT besitzt: eine Benutzeroberfläche pro Gitter Zustand (ausgewählte Zeilen, ausstehende Zeilen, erstellt / aktualisiert / löscht), Spaltenbreiten). Diese bleiben grid-lokal – zwei Grids, die sich eines teilen Die Datenquelle kann weiterhin eine unabhängige Auswahl und ein per-Gitter-System haben Bearbeitungen stehen aus. Wenn ViewDataSource.Highlight gesetzt wird (z. B. über eine Diagramm-Schnittklick im Kreuzfilter-'Highlight'-Modus), Zeilen, deren Zeilen Der Wert in der hervorgehobenen Spalte passt nicht visuell zu gedämpft über eine CSS-Klasse; Die Zeilendaten + Auswahl sind Unbeeinflusst (der Soft Cross-Filter ist rein Styling).
Name: DefaultItemsPerPage
Typ: int
Default: 50
Beschreibung: Standardanzahl der Datensätze, die auf einer Seite geladen werden sollen.
Name: DefaultViewId
Typ: Guid?
Beschreibung: Der Ansicht, dass das Raster beim ersten Laden angezeigt werden sollte.
Name: Editable
Typ: bool
Default: False
Beschreibung: Ist das Inline-Editing für das Raster aktiviert?
Name: Filters
Typ: IReadOnlyList<GridFilterBase>?
Beschreibung: Zusätzliche serverseitige Filter AND-merged auf die aufgelösten Ansichten FetchXML vor Auspagieren, Sortieren und Suchen setzt ein. Weitergeleitet an Query.IFetchXmlQueryComposer's FetchXmlQueryOptions.Filters, Jeder Eintrag wird also nach Laufzeittyp gesendet (z. B. Models.RelationshipFilter AND-verschmilzt eine Beziehungsverbindungs-Entität). Typische Nutzung: Der LinkExistingRecordGridButton-Picker übergibt einen Models.RelationshipFilter mit RelationshipFilterMode.ExcludeExistingRecords Also schon- verknüpfte Datensätze sind im M2M-Suche-Dialog verborgen. Kombiniert additiv mit SubGrids eigenem internen System Beziehungsfilter (der direkt im FetchXML integriert ist) anstatt durch den Komponisten-Filter-Slot zu gehen) – beide enden Auf derselben Anfrage.
Name: FullSize
Typ: bool
Default: False
Beschreibung: Wenn zutreffend, dehnt sich das Gitter aus, um den gesamten verfügbaren vertikalen Raum auszufüllen, anstatt eine feste Mindesthöhe zu verwenden.
Name: HidePaging
Typ: bool
Default: False
Beschreibung: Erzwingen Sie, dass die Seitengröße und die Auslagerungskomponenten ausgeborgen werden. Tun Sie dies nur, wenn die Anzahl der Elemente bekannt ist und die Seitengröße auf etwas höher als die Anzahl der Artikel gesetzt ist.
Name: IncludeSearchInPersistedState
Typ: bool
Default: False
Beschreibung: Wenn zutreffend, wird der aktive Suchtext in die persistente Version einbezogen state-URL-Parameter (unter dem q-Feld ). Standardwert auf falsch — Suchbegriffe sensibel sein können, sich im Browserverlauf ansammeln, und in HTTP-Referrer durchsickern, sodass das Raster sie aus der URL heraushält, es sei denn, Der Verbraucher meldet sich ausdrücklich ein. Hat keine Wirkung, wenn GridBase.PersistedStateQueryParameter nicht festgelegt ist.
Name: IsDirty
Typ: bool
Default: False
Beschreibung: Gibt an, ob das Grid noch nicht gespeicherte Erstellungs-, Aktualisierungs- oder Löschvorgänge hat.
Name: LoadedRecords
Typ: IEnumerable<TableRecord>
Beschreibung: Datensätze, die derzeit im Raster (der aktuellsten Seite mit Ergebnissen) gerendert werden. Gedacht für Toolbar-Befehle, die auf 'alles Gezeigte' reagieren müssen – z. B. eine Bulk Download-Button. Erstreckt sich nicht über Seiten; Bulk-Querseiten-Operationen sollten ihre Stattdessen eigene unpaged-Apport.
Name: MaxHeight
Typ: string?
Beschreibung: Maximale Höhe, auf die sich die Gittersteuerung ausdehnen sollte.
Name: MinHeight
Typ: string?
Default: 300px
Beschreibung: Minimale Höhe, die die Grid-Steuerung einnehmen sollte.
Name: Mode
Typ: GridMode
Default: RecordSelection
Beschreibung: Legt den Verhaltensmodus des Rasters fest, wie z. B. Standardinteraktion oder Datensatzauswahlmodus.
Name: PageSizes
Typ: IEnumerable<int>
Beschreibung: Sammlung verfügbarer Seitengrößen für das Raster.
Name: PagingMode
Typ: GridPagingMode
Default: Paged
Beschreibung: Bestimmt, ob das Raster traditionelle Paging- oder Unendlichkeits-Scroll-Virtualisierung verwendet.
Name: PersistedRowsSnapshot
Typ: PersistedGridRowsSnapshot?
Beschreibung: Server-Prerender → interaktives Handoff für die gerenderte Seite mit Zeilen. Das Rahmenwerk Erhält diese Eigenschaft am Ende von Prerender automatisch erhalten und rehydriert sie davor GridBase.OnInitializedAsync auf der interaktiven Seite, also kann der Datenabruf Ich habe das erste interaktive Rendering übersprungen. Wird durch die Position des Renderbaums durch das Framework geschlüsselt; Das Feld PersistedGridRowsSnapshot.ViewId wird beim Verbrauch überprüft Zeit, also wirft ein Rerender gegen eine andere Ansicht die veralteten Reihen weg. Öffentlichkeit gemäß der Anforderung des Rahmens – [PersistentState] sieht öffentliche Objekte nur über Reflexion – aber nicht dazu gedacht, extern gesetzt zu werden.
Name: PersistedStateQueryParameter
Typ: string?
Beschreibung: Name des URL-Abfragestring-Parameters, um das interaktive Raster zu erhalten Staat an. Wenn gesetzt, liest das Gitter diesen Parameter bei der Anfangslast und Seeds die aktive Ansicht, Seitenzahl, Seitengröße und sortieren daraus; nachfolgende Benutzeraktionen (Ansichtsauswahl, Seitenänderung, Kopfzeilensortierung usw.) Schreibe den neuen Zustand zurück über Components.NavigationManager's Ersetz-Zustand-Pfad. Persistenz übersteht Seitenaktualisierung und Lesezeichen.
Name: Record
Typ: TableRecord?
Beschreibung: Der übergeordnete Datensatz wird über einen kaskadierenden Parameter bereitgestellt; verwandte Datensätze werden nach der Identität dieses Datensatzes gefiltert.
Name: RelationshipName*
Typ: string
Beschreibung: Der Schemaname der Beziehung, die verwendet wird, um verwandte Datensätze in diesem Sub-Grid zu filtern und anzuzeigen.
Name: SelectedRecords
Typ: IEnumerable<TableRecord>
Beschreibung: Datensätze, die derzeit im Raster ausgewählt sind.
Name: SelectFromEntireRow
Typ: bool
Default: True
Beschreibung: Wenn das stimmt, wählt ein Klick auf eine beliebige Zeile sie aus; wenn falsch, wählt nur das Kontrollkästchen die Zeile aus.
Name: SelectMode
Typ: DataGridSelectMode
Default: Multiple
Beschreibung: Kontrolliert, ob das Raster eine einzelne oder mehrere Zeilen auswählt.
Name: Title
Typ: string?
Beschreibung: Name, der angezeigt wird, wenn das Dropdown-Menü nicht angezeigt wird.
Name: TransformViewAsync
Typ: Func<GridViewDefinition, Task<GridViewDefinition>>?
Beschreibung: Optionaler Callback, der unmittelbar nach dem Laden einer Ansicht und vor der Nutzung des Grids ausgeführt wird Es soll Spalten oder Abfragen erstellen. Geben Sie ein modifiziertes Models.GridViewDefinition Formular zurück zu transformieren Sie, was das Raster letztlich rendert – zum Beispiel, um eine bestimmte Spalte sicherzustellen ist unabhängig von der eigenen Konfiguration der Ansicht immer vorhanden. Asynchron, damit Anrufer es können Konsultieren Sie Metadaten-Caches, Dienste oder andere asynchrone Ressourcen bei der Entscheidung, was zu tun ist Include.
Name: ViewIds
Typ: IEnumerable<Guid>?
Beschreibung: Liste der IDs der Ansichten, auf die das Raster im Dropdown-Menü beschränkt werden sollte.
Name: ViewSort
Typ: ViewSort
Default: NameAscending
Beschreibung: Sortiere die Reihenfolge der Ansichten im Ansichts-Dropdown.

Veranstaltungen

Name
Typ
Beschreibung
EditableChangedEventCallback<bool>
Callback wird aufgerufen, wenn sich der Inline-Bearbeitungszustand ändert.
SelectedRecordsChangedEventCallback<IEnumerable<TableRecord>>
Callback wird aufgerufen, wenn sich die Auswahl der Datensätze ändert.
Name: EditableChanged
Typ: EventCallback<bool>
Beschreibung: Callback wird aufgerufen, wenn sich der Inline-Bearbeitungszustand ändert.
Name: SelectedRecordsChanged
Typ: EventCallback<IEnumerable<TableRecord>>
Beschreibung: Callback wird aufgerufen, wenn sich die Auswahl der Datensätze ändert.

Methoden

Name
Parameter
Typ
Beschreibung
ClearSelectionAsyncTask
Löscht alle aktuell ausgewählten Zeilen.
OpenFileDownloadAsyncTableRecord record
string columnName
Task
Ruft die Bytes der Datei-/Bildspalte ab record und streamt sie als Download in den Browser des Nutzers. Aufruft durch das Download-Symbol pro Zeile in der Datei und Bildzellen.
OpenFilePreviewAsyncTableRecord record
string columnName
Task
Öffnet den Inline-Vorschaudialog für die Datei-/Bildspalte columnName auf record. Wird durch das pro-zeilige Vorschausymbol in Datei-/Bildzellen aufgerufen und auch für Kompositionskomponenten verfügbar (zum Beispiel eine Symbolleiste-Schaltfläche auf einem Wrapping Gitter), die einen programmatischen Einstiegspunkt wollen.
RefreshAsyncbool forceRefresh
Task
Weist das Gitter an, die aktuellen Daten aus der bereitgestellten Datenquelle erneut abzurufen und darzustellen.
Validatebool
Validiert alle editierbaren Zeilen im Raster.
Name: ClearSelectionAsync
Typ: Task
Beschreibung: Löscht alle aktuell ausgewählten Zeilen.
Name: OpenFileDownloadAsync
Parameter: TableRecord record
string columnName
Typ: Task
Beschreibung: Ruft die Bytes der Datei-/Bildspalte ab record und streamt sie als Download in den Browser des Nutzers. Aufruft durch das Download-Symbol pro Zeile in der Datei und Bildzellen.
Name: OpenFilePreviewAsync
Parameter: TableRecord record
string columnName
Typ: Task
Beschreibung: Öffnet den Inline-Vorschaudialog für die Datei-/Bildspalte columnName auf record. Wird durch das pro-zeilige Vorschausymbol in Datei-/Bildzellen aufgerufen und auch für Kompositionskomponenten verfügbar (zum Beispiel eine Symbolleiste-Schaltfläche auf einem Wrapping Gitter), die einen programmatischen Einstiegspunkt wollen.
Name: RefreshAsync
Parameter: bool forceRefresh
Typ: Task
Beschreibung: Weist das Gitter an, die aktuellen Daten aus der bereitgestellten Datenquelle erneut abzurufen und darzustellen.
Name: Validate
Typ: bool
Beschreibung: Validiert alle editierbaren Zeilen im Raster.