SubGrid

El SubGrid componente muestra los registros Dataverse relacionados con un registro padre a través de una relación especificada. Debe colocarse dentro de a RecordContext y requiere un RelationshipName parámetro que especifique qué relación usar.

Tipos de relaciones

SubGrid soporta tanto relaciones de uno a muchos (1:N) como de muchos a muchos (N:N). El componente detecta automáticamente el tipo de relación y ajusta su comportamiento en consecuencia.

  • Para relaciones 1:N, la cuadrícula muestra los registros de la tabla relacionada que hacen referencia al registro padre. Los botones de la barra de herramientas como NewRecordGridButton, OpenRecordGridButton, y DeleteRecordGridButton se usan para crear, editar y eliminar registros relacionados.
  • Para las relaciones N:N, la cuadrícula muestra los registros asociados. Botones de barra de herramientas como LinkExistingRecordGridButton y UnlinkExistingRecordGridButton se usan para asociar y disociar registros. Las operaciones de creación y eliminación se convierten automáticamente en solicitudes de asociación y desasociación.

Opiniones

Úsase ViewIds para especificar qué vistas están disponibles en el desplegable selector de vistas y DefaultViewId para establecer la vista seleccionada inicialmente. Si no se proporciona ninguno, la cuadrícula carga automáticamente todas las vistas públicas de la tabla correspondiente. También puedes proporcionar CustomViewDefinitions FetchXML en línea para definir vistas directamente en código.

React
Blazor

Botones de la barra de herramientas

Añadir botones a la barra de herramientas de la cuadrícula usando el Buttons fragmento de renderizado. Consulta la documentación de Grid Buttons para opciones de configuración detalladas, incluyendo posicionamiento de diálogos, formularios asistentes y comportamiento de guardado. Los siguientes botones integrados están disponibles:

  • NewRecordGridButton — Abre un formulario de diálogo para crear un nuevo registro relacionado (1:N)
  • OpenRecordGridButton — Abre un formulario de diálogo para editar el registro seleccionado
  • DeleteRecordGridButton — Elimina registros seleccionados
  • LinkExistingRecordGridButton — Asocia un registro existente mediante una relación N:N
  • UnlinkExistingRecordGridButton — Desasocia registros seleccionados de una relación N:N
  • NavigateNewRecordGridButton — Navega a una URL para crear un nuevo registro
  • NavigateOpenRecordGridButton — Navega a una URL para editar el registro seleccionado
React
Blazor

Edición en línea

Configura AllowEdit="true" para activar un interruptor de configuración que permite a los usuarios cambiar al modo de edición en línea. Cuando están habilitadas, las columnas editables se renderizan como controles de formulario directamente en la cuadrícula. La edición en línea solo se soporta para relaciones 1:N.

React
Blazor

Paginación y búsqueda

La cuadrícula soporta navegación paginada con tamaños de página configurables mediante DefaultItemsPerPage y PageSizes. La búsqueda está habilitada por defecto y puede desactivarse con AllowSearch="false".

React
Blazor

SubGrid (Relación de Uno a Muchos)

El siguiente ejemplo muestra a SubGrid mostrando los contactos relacionados con una cuenta a través de la contact_customer_accounts relación. Incluye botones para crear, editar y eliminar contactos.

Ejemplo de reacción
Ejemplo de Blazor
Mis contactosTodos los contactos
Nuevo
Mis contactosTodos los contactos
Nuevo

Tamaño de página

102050100
Nombre completo
Teléfono móvil
Correo electrónico
Nombre de la empresa
Edad
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 (Relación de muchos a muchos)

El siguiente ejemplo muestra regiones SubGrid asociadas a una cuenta a través de la ppp_Account_ppp_Region_ppp_Region relación de muchos a muchos.

Ejemplo de reacción
Ejemplo de Blazor
Regiones activasRegiones inactivas
Enlace existente
Regiones activasRegiones inactivas
Enlace existente

Tamaño de página

102050100
Nombre
No se han encontrado registros.
React TypeScript
Razor
Reaccionar Blazor

SubGrid Clase

Parámetros

Nombre
Tipo
Default
Descripción
AllowChangingPageSizebool
True
Cuando es cierto, el usuario puede cambiar el número de elementos mostrados por página.
AllowDownloadForFileColumnsbool
True
Cuando es cierto (por defecto), la cuadrícula muestra un icono de descarga por fila en el borde trasero de las celdas de columna de archivo e imagen. Al hacer clic en él, el archivo se transmite a la navegador del usuario. Configura en falso para suprimir el icono — por ejemplo, en modo solo lectura Cuadrículas de auditoría donde no se permite exportar archivos.
AllowEditbool
False
¿Debería estar disponible la opción para que el usuario active la edición en línea para la cuadrícula?
AllowNavigateOnPrimaryNameClickbool
True
Cuando es cierto (por defecto) y la cuadrícula tiene un botón de 'editar' registrado (un GridButton con IsOpenRecordButton=true), la celda que renderiza la columna de nombre principal de la tabla se convierte en un hipervínculo. Al hacer clic se despacha lo mismo invocación por fila que un doble clic en fila haría — para que el usuario pueda saltar a la edición form (o la URL de edición navegada, dependiendo del botón registrado) sin antes Seleccionar la fila. Configura en false para suprimir el hipervínculo y renderizar el celda de nombre principal como texto plano. No tiene efecto cuando no hay ningún botón de edición registrado.
AllowNavigateOnRowDoubleClickbool
True
Cuando es cierto (por defecto) y la cuadrícula tiene un botón de 'editar' registrado (un GridButton con IsOpenRecordButton=true), haciendo doble clic en una fila invoca el OnClick de ese botón para el registro de la fila — apertura el diálogo de edición o navegar hasta la URL de edición, según lo que haga el botón. A ajustar false para suprimir el controlador de doble clic. No tiene efecto cuando no hay botón de edición está registrado.
AllowPreviewForFileColumnsbool
True
Cuando es cierto (por defecto), la cuadrícula muestra un icono de vista previa 'eye' por fila en el borde trasero de celdas de columna de archivo e imagen cuyo contenido puede renderizarse en línea (imágenes, PDFs, texto plano). Configura en falso para suprimir el icono — por ejemplo, en cuadrículas donde las columnas no deberían servir de punto de entrada para previsualizar.
AllowSearchbool
True
¿Debería permitirse al usuario buscar en la cuadrícula?
BorderVisiblebool
True
Controla si se representa un borde visible alrededor de la cuadrícula.
ButtonsRenderFragment?
Fragmento de renderizado opcional usado para definir la barra de botones mostrada sobre la cuadrícula.
ColumnsRenderFragment?
Fragmento opcional Components.GridColumns que transporta declarado por el consumidor Components.GridColumn niños. Cuando se suministra, la red cambia a Modo de reemplazo: solo se renderizan las columnas declaradas (en declarado orden), la proyección FetchXML se reescribe para coincidir, y el La lista de columnas de Underlying View es ignorada. null deja la cuadrícula en su comportamiento predeterminado (auto-generar columnas desde el conjunto de columnas resueltas de la vista).
CustomViewDefinitionsList<GridViewDefinition>?
Vistas personalizadas para mostrar en el desplegable.
DataSourceViewDataSource?
Opcional compartido Data.ViewDataSource. Cuando se ajusta, la cuadrícula lee sus filas + conteo total de la fuente de datos en lugar de emitiendo su propio RetrieveRecordsAsync(System.String) llamada — La misma fuente de datos puede impulsar a un hermano <DataverseChart> o una segunda cuadrícula para que todos ellos Paginar / filtrar / buscar juntos en un solo viaje de ida y vuelta. El uso independiente (no GridBase.DataSource) mantiene el máquina de estados internos existente — la cuadrícula compone FetchXML y obtiene directamente a través de IPowerPortalsProService . Lo que la fuente de datos NO posee: interfaz por cuadrícula estado (filas seleccionadas, filas pendientes creadas / actualizaciones / eliminadas, anchos de columna). Esos se mantienen en cuadrícula local: dos cuadrículas compartiendo una La fuente de datos puede seguir teniendo selección independiente y por cuadrícula Correcciones pendientes. Cuando ViewDataSource.Highlight se establece (por ejemplo, mediante un click en segmento gráfico en modo de filtro cruzado 'resaltado'), filas cuyo El valor en la columna resaltada no coincide visualmente silenciado mediante una clase CSS; los datos de fila + selección son no afectado (el filtro cruzado suave es puramente de estilo).
DefaultItemsPerPageint
50
Número predeterminado de registros que se cargan en una página.
DefaultViewIdGuid?
ID de la vista que la cuadrícula debería mostrar al cargar inicialmente.
Editablebool
False
¿Está activada la edición en línea para la cuadrícula?
FiltersIReadOnlyList<GridFilterBase>?
Filtros adicionales del lado del servidor AND se fusionaron en las vistas resueltas FetchXML antes de paginar, ordenar o buscar se activa. Reenviado a Query.IFetchXmlQueryComposer's FetchXmlQueryOptions.Filters, Así, cada entrada se despacha por tipo de tiempo de ejecución (por ejemplo, Models.RelationshipFilter AND-fusiona una relación entidad-enlace). Uso típico: el selector LinkExistingRecordGridGrid pasa un Models.RelationshipFilter con RelationshipFilterMode.ExcludeExistingRecords Así que ya- los registros enlazados están ocultos al diálogo de consulta M2M. Se combina aditivamente con el propio sistema interno de SubGrid filtro de relaciones (que está integrado directamente en FetchXML en lugar de pasar por la ranura de Filtros del compositor) — ambos extremos En la misma consulta.
FullSizebool
False
Cuando es cierto, la cuadrícula se expande para llenar todo el espacio vertical disponible en lugar de usar una altura mínima fija.
HidePagingbool
False
Forzar que el tamaño de página y los componentes de paginación estén ocultos. Solo hazlo cuando se conoce el número de elementos y el tamaño de la página está configurado a algo mayor que el número de elementos.
IncludeSearchInPersistedStatebool
False
Cuando es cierto, el texto de búsqueda activa se incluye en el persistente parámetro de URL de estado (debajo del campo q ). Por defecto es falso — los términos de búsqueda pueden ser sensibles, acumularse en el historial del navegador, y filtrarse a los referentes HTTP, así que la cuadrícula los mantiene fuera de la URL a menos que El consumidor opta explícitamente por participar. No tiene efecto cuando GridBase.PersistedStateQueryParameter no está fija.
IsDirtybool
False
Indica si la cuadrícula tiene pendientes las operaciones de creación, actualización o eliminación desguardadas.
LoadedRecordsIEnumerable<TableRecord>
Registros actualmente renderizados en la cuadrícula (la página más reciente de resultados). Pensado para comandos de barra de herramientas que deben actuar sobre 'todo lo mostrado' — por ejemplo, un bloque botón de descarga. No abarca páginas; Las operaciones de bloqueo de páginas deben ejecutar su En su lugar, busca tu propio recado sin página.
MaxHeightstring?
Altura máxima a la que debería expandirse el control de la cuadrícula.
MinHeightstring?
300px
Altura mínima que debe ocupar el control de la cuadrícula.
ModeGridMode
RecordSelection
Establece el modo de comportamiento de la cuadrícula, como la interacción predeterminada o el modo de selección de registros.
PageSizesIEnumerable<int>
Colección de tamaños de página disponibles para la cuadrícula.
PagingModeGridPagingMode
Paged
Determina si la cuadrícula utiliza paginación tradicional o virtualización de desplazamiento infinito.
PersistedRowsSnapshotPersistedGridRowsSnapshot?
El prerenderizado del servidor → transferencia interactiva para la página renderizada de filas. El marco Persiste automáticamente esta propiedad al final del prerenderizado y la rehidrata antes GridBase.OnInitializedAsync en el lado interactivo, así que la obtención de datos puede ser Me salté el primer render interactivo. Clave por la posición del árbol de renderizado por el framework; El PersistedGridRowsSnapshot.ViewId campo se comprueba en el consumo tiempo, así que un rerender contra otra vista descarta las filas obsoletas. Público según el el requisito del marco — [PersistentState] solo ve propiedades públicas a través de reflexión — pero no está destinada a ser puesta externamente.
PersistedStateQueryParameterstring?
Nombre del parámetro de la cadena de consulta URL para mantener la interacción de la cuadrícula Estala a. Cuando se establece, la cuadrícula interpreta este parámetro en la carga inicial y siembra la vista activa, número de página, tamaño de página y ordena a partir de ella; acciones posteriores del usuario (selección de vista, cambio de página, ordenación de encabezado, etc.) Escribe el nuevo estado de vuelta a través Components.NavigationManagerde 's Camino de reemplazo de estado. La persistencia sobrevive a la actualización de página y a los marcadores.
RecordTableRecord?
El registro padre suministrado mediante un parámetro en cascada; Los registros relacionados se filtran por la identidad de este registro.
RelationshipName*string
El nombre del esquema de la relación utilizada para filtrar y mostrar los registros relacionados en esta subcuadrícula.
SelectedRecordsIEnumerable<TableRecord>
Registros que actualmente se seleccionan en la cuadrícula.
SelectFromEntireRowbool
True
Cuando es cierto, al hacer clic en cualquier parte de una fila se selecciona; cuando es falso, solo la casilla selecciona la fila.
SelectModeDataGridSelectMode
Multiple
Controla si la cuadrícula permite la selección de una sola fila o de varias filas.
Titlestring?
Nombre para mostrar cuando no se muestra el desplegable de vista.
TransformViewAsyncFunc<GridViewDefinition, Task<GridViewDefinition>>?
Callback opcional que se ejecuta inmediatamente después de cargar una vista y antes de que la cuadrícula se use es para construir columnas o consultas. Devolver un modificado Models.GridViewDefinition a transforma lo que la cuadrícula finalmente renderiza — por ejemplo, para asegurar una columna específica siempre está presente independientemente de la configuración propia de la vista. Asíncrono para que los llamantes puedan consulta cachés de metadatos, servicios u otros recursos asíncronos mientras decides qué hacer incluir.
ViewIdsIEnumerable<Guid>?
Lista de identificaciones de las vistas a las que la cuadrícula debería limitarse en el desplegable de vistas.
ViewSortViewSort
NameAscending
Ordena las vistas en el desplegable de vistas.
Nombre: AllowChangingPageSize
Tipo: bool
Default: True
Descripción: Cuando es cierto, el usuario puede cambiar el número de elementos mostrados por página.
Nombre: AllowDownloadForFileColumns
Tipo: bool
Default: True
Descripción: Cuando es cierto (por defecto), la cuadrícula muestra un icono de descarga por fila en el borde trasero de las celdas de columna de archivo e imagen. Al hacer clic en él, el archivo se transmite a la navegador del usuario. Configura en falso para suprimir el icono — por ejemplo, en modo solo lectura Cuadrículas de auditoría donde no se permite exportar archivos.
Nombre: AllowEdit
Tipo: bool
Default: False
Descripción: ¿Debería estar disponible la opción para que el usuario active la edición en línea para la cuadrícula?
Nombre: AllowNavigateOnPrimaryNameClick
Tipo: bool
Default: True
Descripción: Cuando es cierto (por defecto) y la cuadrícula tiene un botón de 'editar' registrado (un GridButton con IsOpenRecordButton=true), la celda que renderiza la columna de nombre principal de la tabla se convierte en un hipervínculo. Al hacer clic se despacha lo mismo invocación por fila que un doble clic en fila haría — para que el usuario pueda saltar a la edición form (o la URL de edición navegada, dependiendo del botón registrado) sin antes Seleccionar la fila. Configura en false para suprimir el hipervínculo y renderizar el celda de nombre principal como texto plano. No tiene efecto cuando no hay ningún botón de edición registrado.
Nombre: AllowNavigateOnRowDoubleClick
Tipo: bool
Default: True
Descripción: Cuando es cierto (por defecto) y la cuadrícula tiene un botón de 'editar' registrado (un GridButton con IsOpenRecordButton=true), haciendo doble clic en una fila invoca el OnClick de ese botón para el registro de la fila — apertura el diálogo de edición o navegar hasta la URL de edición, según lo que haga el botón. A ajustar false para suprimir el controlador de doble clic. No tiene efecto cuando no hay botón de edición está registrado.
Nombre: AllowPreviewForFileColumns
Tipo: bool
Default: True
Descripción: Cuando es cierto (por defecto), la cuadrícula muestra un icono de vista previa 'eye' por fila en el borde trasero de celdas de columna de archivo e imagen cuyo contenido puede renderizarse en línea (imágenes, PDFs, texto plano). Configura en falso para suprimir el icono — por ejemplo, en cuadrículas donde las columnas no deberían servir de punto de entrada para previsualizar.
Nombre: AllowSearch
Tipo: bool
Default: True
Descripción: ¿Debería permitirse al usuario buscar en la cuadrícula?
Nombre: BorderVisible
Tipo: bool
Default: True
Descripción: Controla si se representa un borde visible alrededor de la cuadrícula.
Nombre: Buttons
Tipo: RenderFragment?
Descripción: Fragmento de renderizado opcional usado para definir la barra de botones mostrada sobre la cuadrícula.
Nombre: Columns
Tipo: RenderFragment?
Descripción: Fragmento opcional Components.GridColumns que transporta declarado por el consumidor Components.GridColumn niños. Cuando se suministra, la red cambia a Modo de reemplazo: solo se renderizan las columnas declaradas (en declarado orden), la proyección FetchXML se reescribe para coincidir, y el La lista de columnas de Underlying View es ignorada. null deja la cuadrícula en su comportamiento predeterminado (auto-generar columnas desde el conjunto de columnas resueltas de la vista).
Nombre: CustomViewDefinitions
Tipo: List<GridViewDefinition>?
Descripción: Vistas personalizadas para mostrar en el desplegable.
Nombre: DataSource
Tipo: ViewDataSource?
Descripción: Opcional compartido Data.ViewDataSource. Cuando se ajusta, la cuadrícula lee sus filas + conteo total de la fuente de datos en lugar de emitiendo su propio RetrieveRecordsAsync(System.String) llamada — La misma fuente de datos puede impulsar a un hermano <DataverseChart> o una segunda cuadrícula para que todos ellos Paginar / filtrar / buscar juntos en un solo viaje de ida y vuelta. El uso independiente (no GridBase.DataSource) mantiene el máquina de estados internos existente — la cuadrícula compone FetchXML y obtiene directamente a través de IPowerPortalsProService . Lo que la fuente de datos NO posee: interfaz por cuadrícula estado (filas seleccionadas, filas pendientes creadas / actualizaciones / eliminadas, anchos de columna). Esos se mantienen en cuadrícula local: dos cuadrículas compartiendo una La fuente de datos puede seguir teniendo selección independiente y por cuadrícula Correcciones pendientes. Cuando ViewDataSource.Highlight se establece (por ejemplo, mediante un click en segmento gráfico en modo de filtro cruzado 'resaltado'), filas cuyo El valor en la columna resaltada no coincide visualmente silenciado mediante una clase CSS; los datos de fila + selección son no afectado (el filtro cruzado suave es puramente de estilo).
Nombre: DefaultItemsPerPage
Tipo: int
Default: 50
Descripción: Número predeterminado de registros que se cargan en una página.
Nombre: DefaultViewId
Tipo: Guid?
Descripción: ID de la vista que la cuadrícula debería mostrar al cargar inicialmente.
Nombre: Editable
Tipo: bool
Default: False
Descripción: ¿Está activada la edición en línea para la cuadrícula?
Nombre: Filters
Tipo: IReadOnlyList<GridFilterBase>?
Descripción: Filtros adicionales del lado del servidor AND se fusionaron en las vistas resueltas FetchXML antes de paginar, ordenar o buscar se activa. Reenviado a Query.IFetchXmlQueryComposer's FetchXmlQueryOptions.Filters, Así, cada entrada se despacha por tipo de tiempo de ejecución (por ejemplo, Models.RelationshipFilter AND-fusiona una relación entidad-enlace). Uso típico: el selector LinkExistingRecordGridGrid pasa un Models.RelationshipFilter con RelationshipFilterMode.ExcludeExistingRecords Así que ya- los registros enlazados están ocultos al diálogo de consulta M2M. Se combina aditivamente con el propio sistema interno de SubGrid filtro de relaciones (que está integrado directamente en FetchXML en lugar de pasar por la ranura de Filtros del compositor) — ambos extremos En la misma consulta.
Nombre: FullSize
Tipo: bool
Default: False
Descripción: Cuando es cierto, la cuadrícula se expande para llenar todo el espacio vertical disponible en lugar de usar una altura mínima fija.
Nombre: HidePaging
Tipo: bool
Default: False
Descripción: Forzar que el tamaño de página y los componentes de paginación estén ocultos. Solo hazlo cuando se conoce el número de elementos y el tamaño de la página está configurado a algo mayor que el número de elementos.
Nombre: IncludeSearchInPersistedState
Tipo: bool
Default: False
Descripción: Cuando es cierto, el texto de búsqueda activa se incluye en el persistente parámetro de URL de estado (debajo del campo q ). Por defecto es falso — los términos de búsqueda pueden ser sensibles, acumularse en el historial del navegador, y filtrarse a los referentes HTTP, así que la cuadrícula los mantiene fuera de la URL a menos que El consumidor opta explícitamente por participar. No tiene efecto cuando GridBase.PersistedStateQueryParameter no está fija.
Nombre: IsDirty
Tipo: bool
Default: False
Descripción: Indica si la cuadrícula tiene pendientes las operaciones de creación, actualización o eliminación desguardadas.
Nombre: LoadedRecords
Tipo: IEnumerable<TableRecord>
Descripción: Registros actualmente renderizados en la cuadrícula (la página más reciente de resultados). Pensado para comandos de barra de herramientas que deben actuar sobre 'todo lo mostrado' — por ejemplo, un bloque botón de descarga. No abarca páginas; Las operaciones de bloqueo de páginas deben ejecutar su En su lugar, busca tu propio recado sin página.
Nombre: MaxHeight
Tipo: string?
Descripción: Altura máxima a la que debería expandirse el control de la cuadrícula.
Nombre: MinHeight
Tipo: string?
Default: 300px
Descripción: Altura mínima que debe ocupar el control de la cuadrícula.
Nombre: Mode
Tipo: GridMode
Default: RecordSelection
Descripción: Establece el modo de comportamiento de la cuadrícula, como la interacción predeterminada o el modo de selección de registros.
Nombre: PageSizes
Tipo: IEnumerable<int>
Descripción: Colección de tamaños de página disponibles para la cuadrícula.
Nombre: PagingMode
Tipo: GridPagingMode
Default: Paged
Descripción: Determina si la cuadrícula utiliza paginación tradicional o virtualización de desplazamiento infinito.
Nombre: PersistedRowsSnapshot
Tipo: PersistedGridRowsSnapshot?
Descripción: El prerenderizado del servidor → transferencia interactiva para la página renderizada de filas. El marco Persiste automáticamente esta propiedad al final del prerenderizado y la rehidrata antes GridBase.OnInitializedAsync en el lado interactivo, así que la obtención de datos puede ser Me salté el primer render interactivo. Clave por la posición del árbol de renderizado por el framework; El PersistedGridRowsSnapshot.ViewId campo se comprueba en el consumo tiempo, así que un rerender contra otra vista descarta las filas obsoletas. Público según el el requisito del marco — [PersistentState] solo ve propiedades públicas a través de reflexión — pero no está destinada a ser puesta externamente.
Nombre: PersistedStateQueryParameter
Tipo: string?
Descripción: Nombre del parámetro de la cadena de consulta URL para mantener la interacción de la cuadrícula Estala a. Cuando se establece, la cuadrícula interpreta este parámetro en la carga inicial y siembra la vista activa, número de página, tamaño de página y ordena a partir de ella; acciones posteriores del usuario (selección de vista, cambio de página, ordenación de encabezado, etc.) Escribe el nuevo estado de vuelta a través Components.NavigationManagerde 's Camino de reemplazo de estado. La persistencia sobrevive a la actualización de página y a los marcadores.
Nombre: Record
Tipo: TableRecord?
Descripción: El registro padre suministrado mediante un parámetro en cascada; Los registros relacionados se filtran por la identidad de este registro.
Nombre: RelationshipName*
Tipo: string
Descripción: El nombre del esquema de la relación utilizada para filtrar y mostrar los registros relacionados en esta subcuadrícula.
Nombre: SelectedRecords
Tipo: IEnumerable<TableRecord>
Descripción: Registros que actualmente se seleccionan en la cuadrícula.
Nombre: SelectFromEntireRow
Tipo: bool
Default: True
Descripción: Cuando es cierto, al hacer clic en cualquier parte de una fila se selecciona; cuando es falso, solo la casilla selecciona la fila.
Nombre: SelectMode
Tipo: DataGridSelectMode
Default: Multiple
Descripción: Controla si la cuadrícula permite la selección de una sola fila o de varias filas.
Nombre: Title
Tipo: string?
Descripción: Nombre para mostrar cuando no se muestra el desplegable de vista.
Nombre: TransformViewAsync
Tipo: Func<GridViewDefinition, Task<GridViewDefinition>>?
Descripción: Callback opcional que se ejecuta inmediatamente después de cargar una vista y antes de que la cuadrícula se use es para construir columnas o consultas. Devolver un modificado Models.GridViewDefinition a transforma lo que la cuadrícula finalmente renderiza — por ejemplo, para asegurar una columna específica siempre está presente independientemente de la configuración propia de la vista. Asíncrono para que los llamantes puedan consulta cachés de metadatos, servicios u otros recursos asíncronos mientras decides qué hacer incluir.
Nombre: ViewIds
Tipo: IEnumerable<Guid>?
Descripción: Lista de identificaciones de las vistas a las que la cuadrícula debería limitarse en el desplegable de vistas.
Nombre: ViewSort
Tipo: ViewSort
Default: NameAscending
Descripción: Ordena las vistas en el desplegable de vistas.

Eventos

Nombre
Tipo
Descripción
EditableChangedEventCallback<bool>
Se invoca la llamada de regreso cuando cambia el estado de la edición en línea.
SelectedRecordsChangedEventCallback<IEnumerable<TableRecord>>
Se invoca la llamada de regreso cuando cambia la colección de registros seleccionada.
Nombre: EditableChanged
Tipo: EventCallback<bool>
Descripción: Se invoca la llamada de regreso cuando cambia el estado de la edición en línea.
Nombre: SelectedRecordsChanged
Tipo: EventCallback<IEnumerable<TableRecord>>
Descripción: Se invoca la llamada de regreso cuando cambia la colección de registros seleccionada.

Métodos

Nombre
Parámetros
Tipo
Descripción
ClearSelectionAsyncTask
Limpia todas las filas seleccionadas actualmente.
OpenFileDownloadAsyncTableRecord record
string columnName
Task
Recupera los bytes de la columna de archivo/imagen y record los transmite en streaming al navegador del usuario como descarga. Invocado por el icono de descarga por fila en el archivo y células de imagen.
OpenFilePreviewAsyncTableRecord record
string columnName
Task
Abre el cuadro de vista previa en línea para la columna columnName de archivo/imagen en record. Invocado por el icono de vista previa por fila en las celdas de archivo/imagen y también disponible para componer componentes (por ejemplo, un botón de barra de herramientas en un envoltorio Grid) que quieren un punto de entrada programático.
RefreshAsyncbool forceRefresh
Task
Indica a la cuadrícula que vuelva a buscar y renderice los datos actuales de la fuente de datos suministrada.
Validatebool
Valida todas las filas editables en la cuadrícula.
Nombre: ClearSelectionAsync
Tipo: Task
Descripción: Limpia todas las filas seleccionadas actualmente.
Nombre: OpenFileDownloadAsync
Parámetros: TableRecord record
string columnName
Tipo: Task
Descripción: Recupera los bytes de la columna de archivo/imagen y record los transmite en streaming al navegador del usuario como descarga. Invocado por el icono de descarga por fila en el archivo y células de imagen.
Nombre: OpenFilePreviewAsync
Parámetros: TableRecord record
string columnName
Tipo: Task
Descripción: Abre el cuadro de vista previa en línea para la columna columnName de archivo/imagen en record. Invocado por el icono de vista previa por fila en las celdas de archivo/imagen y también disponible para componer componentes (por ejemplo, un botón de barra de herramientas en un envoltorio Grid) que quieren un punto de entrada programático.
Nombre: RefreshAsync
Parámetros: bool forceRefresh
Tipo: Task
Descripción: Indica a la cuadrícula que vuelva a buscar y renderice los datos actuales de la fuente de datos suministrada.
Nombre: Validate
Tipo: bool
Descripción: Valida todas las filas editables en la cuadrícula.