QuickGrid<TGridItem> Classe

Construit une instance de QuickGrid<TGridItem>.

Obtient ou définit une collection d’attributs supplémentaires qui seront appliqués à l’élément créé.

Obtient ou définit le mode d’ancrage qui contrôle le comportement de la fenêtre d’affichage aux bords de la liste lorsque de nouveaux éléments arrivent pendant la virtualisation. La valeur par défaut est Start.

Cela n’a qu’un effet quand Virtualize est true. Pour l’ancrage fiable avec des types de référence qui n’ont pas de sémantique d’égalité de valeur, fournissez une ItemComparer valeur afin que la grille puisse détecter si les éléments ont été ajoutés ou ajoutés.

Obtient l’application ResourceAssetCollection .

Obtient l’affectation IComponentRenderMode à ce composant.

Définit les composants enfants de cette instance. Par exemple, vous pouvez définir des colonnes en ajoutant des composants dérivés de la ColumnBase<TGridItem> classe de base.

Nom de classe CSS facultatif. Si elle est donnée, elle sera incluse dans l’attribut de classe de la table rendue.

Cela s’applique uniquement lors de l’utilisation Virtualize. Obtient ou définit l’index de base zéro de la ligne à faire défiler jusqu’au premier rendu interactif. Appliqué une fois lorsque la grille connaît d’abord son nombre d’éléments et ignorée lors des réexécrits suivants ; pour faire défiler programmatiquement à n’importe quel point ultérieur, appelez ScrollToItemAsync(Int32, CancellationToken). Les valeurs hors plage sont limitées. La valeur par défaut, 0signifie qu’il n’y a pas de défilement initial.

Obtient ou définit un comparateur utilisé pendant la virtualisation pour détecter si les éléments ont été ajoutés ou ajoutés entre les chargements de données. Lorsque les fenêtres du fournisseur se chevauchent, le comparateur détermine si un élément précédemment rendu a été modifié au même index global, ce qui indique que les éléments ont été insérés au-dessus de la fenêtre d’affichage actuelle, afin que la grille puisse conserver l’ancrage de la fenêtre d’affichage.

Fournissez un comparateur qui compare les éléments par un identificateur unique stable (par exemple, une clé primaire). La valeur par défaut est Default. Pour les enregistrements et les types implémentant IEquatable<T>, la valeur par défaut fonctionne automatiquement (égalité des valeurs). Pour les types de référence sans sémantique d’égalité de valeur, la valeur par défaut revient à l’égalité de référence, ce qui produit une détection prédéfinie faux positif lorsque la source de données retourne de nouvelles instances entre les charges.

Cela n’a qu’un effet quand Virtualize est true.

Définit éventuellement une valeur pour @key chaque ligne rendue. En règle générale, cela doit être utilisé pour spécifier un identificateur unique, tel qu’une valeur de clé primaire, pour chaque élément de données.

Cela permet à la grille de conserver l’association entre les éléments de ligne et les éléments de données en fonction de leurs identificateurs uniques, même lorsque les instances TGridItem sont remplacées par de nouvelles copies (par exemple, après une nouvelle requête sur le magasin de données sous-jacent).

S’il n’est pas défini, il @key s’agit de l’instance TGridItem elle-même.

Source interrogeable de données pour la grille.

Il peut s’agir de données en mémoire converties en requêtes à l’aide de la AsQueryable(IEnumerable) méthode d’extension, d’un Jeu de données EntityFramework ou d’un IQueryable jeu de données dérivé de celui-ci.

Vous devez fournir l’un ou l’autre Items , ItemsProvidermais pas les deux.

Cela s’applique uniquement lors de l’utilisation Virtualize. Il définit une hauteur attendue en pixels pour chaque ligne, ce qui permet au mécanisme de virtualisation d’extraire le nombre correct d’éléments correspondant à la taille d’affichage et de garantir un défilement précis.

Rappel qui fournit des données pour la grille.

Vous devez fournir l’un ou l’autre Items , ItemsProvidermais pas les deux.

Optionnel. Rappel appelé lorsqu’une ligne est cliquée.

Cela s’applique uniquement lors de l’utilisation Virtualize. Il définit le nombre d’éléments supplémentaires qui seront rendus avant et après la région visible pour réduire la fréquence de rendu pendant le défilement. Bien que les valeurs supérieures puissent améliorer la douceur du défilement en affichant davantage d’éléments hors écran, elles peuvent également augmenter les temps de chargement initiaux. La recherche d’un équilibre en fonction de la taille de votre jeu de données et des exigences d’expérience utilisateur est recommandée. La valeur par défaut est 3.

Vous pouvez éventuellement lier cette QuickGrid<TGridItem> instance à un PaginationState modèle, ce qui entraîne l’extraction et le rendu de la grille uniquement sur la page active des données.

Cela est habituellement utilisé conjointement avec un composant Paginator ou une autre logique d'interface utilisateur qui affiche et met à jour l'instance PaginationState fournie.

Spécifie l’option QueryParameterNameOptions utilisée pour conserver la page, trier la colonne et le sens du tri dans l’URL. La valeur par défaut est une instance dont les paramètres de requête sont nommés « page », « sort » et « direction ».

Obtient le RendererInfo composant en cours d’exécution.

Optionnel. Rappel à appeler pour chaque ligne rendue pour spécifier une classe CSS.

Nom du thème, avec la valeur par défaut « default ». Cela affecte les règles de style qui correspondent à la table.

Si la valeur est true, la grille est rendue avec la virtualisation. Cela est normalement utilisé conjointement avec le défilement et provoque l’extraction et le rendu de la grille uniquement les données autour de la fenêtre d’affichage de défilement actuelle. Cela peut considérablement améliorer les performances lors du défilement de jeux de données volumineux.

Si vous utilisez Virtualize, vous devez fournir une valeur pour ItemSize et vous assurer que chaque ligne s’affiche avec la même hauteur constante.

En règle générale, il est préférable de ne pas utiliser Virtualize si la quantité de données rendues est petite ou si vous utilisez la pagination.

Composant qui affiche une grille.

Traite l’élément fourni exception comme étant levée par ce composant. Cela entraîne la transition de la limite d’erreur englobante en état d’échec. S’il n’existe aucune limite d’erreur englobante, elle est considérée comme une exception du renderer englobant.

Cela est utile si une exception se produit en dehors des méthodes de cycle de vie des composants, mais que vous souhaitez la traiter comme une exception d’une méthode de cycle de vie de composant.

Composant qui affiche une grille.

Ferme l’interface ColumnOptions utilisateur qui a été affichée précédemment.

Exécute l’élément de travail fourni dans le contexte de synchronisation du renderer associé.

Exécute l’élément de travail fourni dans le contexte de synchronisation du renderer associé.

Méthode appelée après chaque rendu interactif du composant et de la mise à jour de l’interface utilisateur (par exemple, après l’ajout d’éléments au DOM du navigateur). Tous les ElementReference champs seront renseignés au moment de l’exécution.

Cette méthode n’est pas appelée pendant le rendu côté serveur ou avant l’affichage côté serveur, car ces processus ne sont pas attachés à un DOM de navigateur en direct et sont déjà terminés avant la mise à jour du DOM.

Méthode appelée après chaque rendu interactif du composant et de la mise à jour de l’interface utilisateur (par exemple, après l’ajout d’éléments au DOM du navigateur). Tous les ElementReference champs seront renseignés au moment de l’exécution.

Cette méthode n’est pas appelée pendant le rendu côté serveur ou avant l’affichage côté serveur, car ces processus ne sont pas attachés à un DOM de navigateur en direct et sont déjà terminés avant la mise à jour du DOM.

Notez que le composant ne réexécure pas automatiquement après l’achèvement d’un élément retourné Task, car cela provoquerait une boucle de rendu infinie.

Méthode appelée lorsque le composant est prêt à démarrer, ayant reçu ses paramètres initiaux de son parent dans l’arborescence de rendu.

Méthode appelée lorsque le composant est prêt à démarrer, ayant reçu ses paramètres initiaux de son parent dans l’arborescence de rendu.

Méthode appelée lorsque le composant est prêt à démarrer, ayant reçu ses paramètres initiaux de son parent dans l’arborescence de rendu.

Remplacez cette méthode si vous effectuez une opération asynchrone et souhaitez que le composant s’actualise une fois cette opération terminée.

Méthode appelée lorsque le composant a reçu des paramètres de son parent dans l’arborescence de rendu et que les valeurs entrantes ont été affectées aux propriétés.

Méthode appelée lorsque le composant a reçu des paramètres de son parent dans l’arborescence de rendu et que les valeurs entrantes ont été affectées aux propriétés.

Indique à la grille de récupérer et de restituer les données actuelles à partir de la source de données fournie (ou ItemsItemsProvider).

Fait défiler la grille virtualisée afin que la ligne située itemIndex en haut de la zone de défilement soit alignée. N’a qu’un effet quand Virtualize est true.

Définit les paramètres fournis par le parent du composant dans l’arborescence de rendu.

Retourne un indicateur pour indiquer si le composant doit être rendu.

Affiche l’interface ColumnOptions utilisateur de la colonne spécifiée, fermant toute autre interface utilisateur d’options de colonne qui a été affichée précédemment.

Définit la colonne de tri actuelle de la grille sur la colonne de tri spécifiée column.

Avertit le composant que son état a changé. Le cas échéant, le composant sera recréé.

Composant qui affiche une grille.

Composant qui affiche une grille.

Composant qui affiche une grille.