Compartir a través de


QuickGrid<TGridItem> Clase

Definición

Componente que muestra una cuadrícula.

[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

Parámetros de tipo

TGridItem

Tipo de datos representados por cada fila de la cuadrícula.

Herencia
QuickGrid<TGridItem>
Atributos
Implementaciones

Constructores

QuickGrid<TGridItem>()

Construye una instancia de QuickGrid<TGridItem>.

Propiedades

AdditionalAttributes

Obtiene o establece una colección de atributos adicionales que se aplicarán al elemento creado.

Assets

Obtiene el ResourceAssetCollection de la aplicación.

(Heredado de ComponentBase)
AssignedRenderMode

Obtiene el IComponentRenderMode asignado a este componente.

(Heredado de ComponentBase)
ChildContent

Define los componentes secundarios de esta instancia. Por ejemplo, puede definir columnas agregando componentes derivados de la clase base ColumnBase<TGridItem>.

Class

Un nombre de clase CSS opcional. Si se da, se incluirá en el atributo de clase de la tabla representada.

ItemKey

Opcionalmente, define un valor para @key en cada fila representada. Normalmente, se debe usar para especificar un identificador único, como un valor de clave principal, para cada elemento de datos.

Esto permite que la cuadrícula conserve la asociación entre elementos de fila y elementos de datos en función de sus identificadores únicos, incluso cuando las instancias de TGridItem se reemplazan por nuevas copias (por ejemplo, después de una nueva consulta en el almacén de datos subyacente).

Si no se establece, el @key será la propia instancia de TGridItem.

Items

Origen consultable de datos para la cuadrícula.

Esto podría ser datos en memoria convertidos en consultables mediante el método de extensión AsQueryable(IEnumerable), o un DataSet EntityFramework o un objeto IQueryable derivado de él.

Debe proporcionar Items o ItemsProvider, pero no ambos.

ItemSize

Esto solo es aplicable cuando se usa Virtualize. Define un alto esperado en píxeles para cada fila, lo que permite que el mecanismo de virtualización capture el número correcto de elementos para que coincida con el tamaño de presentación y para garantizar un desplazamiento preciso.

ItemsProvider

Devolución de llamada que proporciona datos para la cuadrícula.

Debe proporcionar Items o ItemsProvider, pero no ambos.

OverscanCount

Esto solo es aplicable cuando se usa Virtualize. Define cuántos elementos adicionales se representarán antes y después de la región visible para reducir la frecuencia de representación durante el desplazamiento. Aunque los valores más altos pueden mejorar la suavidad del desplazamiento mediante la representación de más elementos fuera de la pantalla, también pueden aumentar los tiempos de carga iniciales. Se recomienda encontrar un equilibrio en función del tamaño del conjunto de datos y los requisitos de experiencia del usuario. El valor predeterminado es 3.

Pagination

Opcionalmente, vincula esta instancia de QuickGrid<TGridItem> con un modelo de PaginationState, lo que hace que la cuadrícula capture y represente solo la página actual de datos.

Normalmente se usa junto con un componente de Paginator o alguna otra lógica de interfaz de usuario que muestra y actualiza la instancia de PaginationState proporcionada.

RendererInfo

Obtiene el RendererInfo en el que se ejecuta el componente.

(Heredado de ComponentBase)
Theme

Un nombre de tema, con el valor predeterminado "default". Esto afecta a qué reglas de estilo coinciden con la tabla.

Virtualize

Si es true, la cuadrícula se representará con virtualización. Normalmente se usa junto con el desplazamiento y hace que la cuadrícula capture y represente solo los datos alrededor de la ventanilla de desplazamiento actual. Esto puede mejorar considerablemente el rendimiento al desplazarse por grandes conjuntos de datos.

Si usa Virtualize, debe proporcionar un valor para ItemSize y debe asegurarse de que cada fila se representa con el mismo alto constante.

Por lo general, es preferible no usar Virtualize si la cantidad de datos que se representan es pequeña o si usa paginación.

Métodos

BuildRenderTree(RenderTreeBuilder)

Componente que muestra una cuadrícula.

DispatchExceptionAsync(Exception)

Trata el exception proporcionado como producido por este componente. Esto hará que la inclusión de ErrorBoundary pase a un estado con errores. Si no hay ningún errorBoundary envolvente, se considerará una excepción del representador envolvente.

Esto resulta útil si se produce una excepción fuera de los métodos de ciclo de vida del componente, pero desea tratarla igual que una excepción de un método de ciclo de vida de componentes.

(Heredado de ComponentBase)
DisposeAsync()

Componente que muestra una cuadrícula.

InvokeAsync(Action)

Ejecuta el elemento de trabajo proporcionado en el contexto de sincronización del representador asociado.

(Heredado de ComponentBase)
InvokeAsync(Func<Task>)

Ejecuta el elemento de trabajo proporcionado en el contexto de sincronización del representador asociado.

(Heredado de ComponentBase)
OnAfterRender(Boolean)

Método invocado después de cada vez que el componente se ha representado de forma interactiva y la interfaz de usuario ha terminado de actualizarse (por ejemplo, después de agregar elementos al DOM del explorador). Las ElementReference campos se rellenarán en el momento en que se ejecute.

Este método no se invoca durante la representación previa o del lado servidor, ya que esos procesos no están conectados a ningún DOM del explorador activo y ya están completos antes de actualizar el DOM.

(Heredado de ComponentBase)
OnAfterRenderAsync(Boolean)

Método invocado después de cada vez que el componente se ha representado de forma interactiva y la interfaz de usuario ha terminado de actualizarse (por ejemplo, después de agregar elementos al DOM del explorador). Las ElementReference campos se rellenarán en el momento en que se ejecute.

Este método no se invoca durante la representación previa o del lado servidor, ya que esos procesos no están conectados a ningún DOM del explorador activo y ya están completos antes de actualizar el DOM.

Tenga en cuenta que el componente no vuelve a representarse automáticamente después de la finalización de ningún Taskdevuelto, ya que eso provocaría un bucle de representación infinito.

OnInitialized()

Método invocado cuando el componente está listo para iniciarse, habiendo recibido sus parámetros iniciales de su elemento primario en el árbol de representación.

(Heredado de ComponentBase)
OnInitializedAsync()

Método invocado cuando el componente está listo para iniciarse, habiendo recibido sus parámetros iniciales de su elemento primario en el árbol de representación.

Invalide este método si va a realizar una operación asincrónica y desea que el componente se actualice cuando se complete esa operación.

(Heredado de ComponentBase)
OnParametersSet()

Método invocado cuando el componente ha recibido parámetros de su elemento primario en el árbol de representación y los valores entrantes se han asignado a las propiedades.

(Heredado de ComponentBase)
OnParametersSetAsync()

Método invocado cuando el componente ha recibido parámetros de su elemento primario en el árbol de representación y los valores entrantes se han asignado a las propiedades.

RefreshDataAsync()

Indica a la cuadrícula que vuelva a capturar y representar los datos actuales del origen de datos proporcionado (ya sea Items o ItemsProvider).

SetParametersAsync(ParameterView)

Establece los parámetros proporcionados por el elemento primario del componente en el árbol de representación.

(Heredado de ComponentBase)
ShouldRender()

Devuelve una marca para indicar si el componente debe representarse.

(Heredado de ComponentBase)
ShowColumnOptionsAsync(ColumnBase<TGridItem>)

Muestra la interfaz de usuario de ColumnOptions para la columna especificada, cerrando cualquier otra interfaz de usuario de opciones de columna que se mostrara anteriormente.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Establece la columna de ordenación actual de la cuadrícula en el columnespecificado.

StateHasChanged()

Notifica al componente que ha cambiado su estado. Cuando corresponda, esto hará que el componente se vuelva a representar.

(Heredado de ComponentBase)

Implementaciones de interfaz explícitas

IComponent.Attach(RenderHandle)

Componente que muestra una cuadrícula.

(Heredado de ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Componente que muestra una cuadrícula.

(Heredado de ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Componente que muestra una cuadrícula.

(Heredado de ComponentBase)

Se aplica a