FileGrid

Ce FileGrid composant est une grille spécialisée pour la gestion des enregistrements Dataverse dont le contenu principal est une colonne de fichier unique. Il enroule MainGrid et superpose des icônes de téléchargement glisser-déposer, d’aperçu et de téléchargement par rangée, ainsi qu’un téléchargement zip en masse de chaque fichier chargé. La grille respecte également la liste d’extensions bloquées à l’échelle de l’environnement de Dataverse et les limites de taille par colonne, et participe / MainContext RecordContext sauvegarde les pipelines lorsqu’un est dans le champ d’application.

Usage de base

Spécifiez la table et le nom logique de la colonne de fichier que la grille doit gérer. Les boutons Télécharger, Remplacer le fichier, Tout télécharger et Supprimer apparaissent automatiquement ; Les fichiers peuvent également être déposés sur la grille. Passez un <Buttons> fragment de rendu pour ajouter vos propres boutons de barre d’outils en plus des éléments intégrés — le même motif MainGrid et SubGrid le même support.

Injection automatique de colonnes de fichiers

Si le FetchXML et la liste de colonnes de la vue active n’incluent pas déjà le FileColumn, la grille le greffert sur une copie clonée afin que les icônes de nom de fichier, de type et d’aperçu/téléchargement par ligne s’affichent toujours — quel que soit le choix de la vue de l’utilisateur. L’instance de vue partagée en cache reste intacte, donc les autres grilles ne sont pas affectées.

Taille maximale de fichier

À utiliser MaxFileSizeBytes pour limiter la taille des fichiers téléchargés. La grille limite votre valeur à la plus petite des métadonnées de MaxSizeInKB la colonne et au paramètre de maxuploadfilesize l’environnement, donc un fichier rejeté côté serveur ne peut pas être mis en file d’attente à la base. Les fichiers au-dessus de la limite effective produisent un dialogue avant d’être envoyés à Dataverse.

Prolongements autorisés

Passez AllowedExtensions pour restreindre les téléchargements à une liste blanche d’extensions. Les fichiers rejetés génèrent un dialogue expliquant quelles extensions sont acceptées. Lorsqu’elle n’est pas réglée, toute extension est autorisée (sous réserve de la liste de blocage de l’environnement ci-dessous).

Liste de blocage environnementale

Les environnements Dataverse maintiennent une blockedattachments liste qui rejette certaines extensions (SVG, EXE, BAT, JS, etc.) quel que soit l’appelant. Il FileGrid lit cette liste à l’initiation via l’appel IPowerPortalsProService.GetEnvironmentFileSettingsAsync() , la met en cache pendant une heure, et rejette les fichiers compatibles côté client avec un message amical au lieu d’une erreur côté serveur. La liste de blocage environnementale l’emporte AllowedExtensions toujours — la liste d’autorisations d’une colonne ne peut pas passer outre un bloc au niveau environnement.

Impossible de télécharger les SVG ?

Les environnements Dataverse se bloquent svg par défaut car les SVG peuvent transporter des scripts intégrés. Si vous avez besoin de téléchargements SVG, retirez-le de la fonction Set blocked file extensions for attachments de l’environnement dans le centre d’administration Power Platform — cette grille captera la modification en moins d’une heure.

Accès à la permission

Le bouton Upload et l’activation de la zone de largage honorent tous deux la permission de l’utilisateur Create actuel du portail sur la table cible. Lorsque l’utilisateur n’a pas créé de messagerie, le bouton Upload est caché et faire glisser les fichiers sur la grille est hors de question — l’application de la fonction serveur reste un filet de sécurité. Les permissions sont résolues via ITablePermissionCache donc les implémentations personnalisées ITableRecordPermissionHandler alimentent la même logique de saisie. Le bouton Téléverser se masque automatiquement chaque fois qu’une ou plusieurs lignes sont sélectionnées, afin de garder la barre d’outils bien rangée.

Aperçu et téléchargement par ligne

La colonne fichier se rend sous la forme [type-icon] filename [eye] [download]. L’icône Aperçu ouvre — FilePreviewDialog voir Rendu Aperçu ci-dessous pour voir à quoi ressemble chaque type de fichier. L’icône Download diffuse le fichier via le composant FileDownload JSInterop. L’une ou l’autre icône peut être désactivée par grille via AllowPreviewForFileColumns / AllowDownloadForFileColumns.

L’icône Aperçu n’apparaît que pour les types de fichiers que le dialogue peut afficher — les extensions non prises en charge sautent l’icône plutôt que de montrer une possibilité défaillante. Les deux icônes d’action sont cachées sur les lignes en attente de création (des enregistrements qui n’ont pas encore été sauvegardés sur Dataverse).

Rendu d’aperçu

Le moteur FilePreviewDialog choisit un moteur de rendu en fonction de l’extension du fichier :

• Images (png, jpg, jpeg, gif, bmp, webp, svg) — en ligne <img> avec une URL de données base64. Limité à 70 vh, donc les images très hautes restent défilables dans le dialogue.
• PDF — chargés sous forme d’URL blob dans un <iframe> So Le visualiseur intégré du navigateur gère le défilement multi-pages, le zoom, la recherche et la sélection de texte. L’URL du blob est révoquée à la fermeture de la conversation.
• Markdown (md, markdown) — converti en HTML côté serveur via Markdig avec ses extensions avancées (tableaux, listes de tâches, code enfermé, autoliaisons, notes de bas de page) et affiché dans un onglet Aperçu . Un second onglet Texte montre la source brute avec la surlignure syntaxique. Le passage HTML brut dans le code source est supprimé avant le rendu, donc un .md fichier ne peut pas s’introduire <script> en douce ou un <iframe>fichier .
• Texte source & structuré (json, xml, yaml, yml, html, htm, js, ts, cs, css) — rendu en a <pre> avec highlight.js colorisation. Le langage est choisi à partir de l’extension via FileTypeIcons.GetSyntaxLanguage; seuls les langages annoncés sont regroupés pour maintenir la taille de l’actif petite. Le surlignage passe par un module co-localisé FilePreviewDialog.razor.ts via l’interop JS — si l’appel d’interop échoue, le dialogue revient silencieusement à un texte non coloré.
• Le texte brut (txt, log, csv) — rendu en un <pre> sans surligne. highlightAuto est intentionnellement interdit car ses suppositions sur de courts extraits (un minuscule journal ou une seule ligne CSV) produisent une couleur plus confuse que l’absence totale de couleur.
• Archives zip (zip) — analysées en mémoire via System.IO.Compression.ZipArchive et rendues sous forme de volet divisé : un arbre pliable à gauche (les dossiers d’abord, par ordre alphabétique, avec la taille par entrée et la dernière modification apparaissaient au survol), et l’aperçu de l’entrée sélectionnée à droite. Le volet de droite est imbriqué FilePreviewContent, donc les fichiers internes passent par la même recherche de rendu — images, PDF, source surlignée, markdown, et même zip-within-zip prévisualisent tous de la même manière qu’ils le feraient de manière autonome. L’archive n’est jamais extraite sur disque.

Télécharger tout (Zip)

Le bouton Download All de la barre d’outils diffuse chaque fichier actuellement rendu dans la grille sous forme d’un seul zip, intégré en mémoire côté ZipArchive serveur et transmis via le circuit Blazor — aucun point de terminaison HTTP supplémentaire n’est requis. Les noms de fichiers dupliqués reçoivent un (2)suffixe , (3) . Configurez AllowDownloadAll="false" pour masquer le bouton sans désactiver les icônes de téléchargement par rangée.

Personnalisation du dossier créé

Par défaut, chaque fichier téléchargé crée un enregistrement minimal avec seulement la colonne du fichier remplie. Pour les tables avec des colonnes supplémentaires requises — ou pour semer d’autres données — passez OnUploadRecordAsync et retournez un fichier TableRecord. Le délégué est asynchrone, donc vous pouvez consulter des services, résoudre des recherches ou générer des noms avant de revenir.

MainContext / Intégration RecordContext

Lorsque la grille est imbriquée dans un MainContext ou RecordContext, les téléchargements sont intégrés à la liste de création en attente de la grille au lieu d’être créés immédiatement. Le contexte IsDirty parent bascule vers true, et sur SaveAsync les enregistrements en phase (avec leurs FileValue octets) est regroupé ExecuteMultipleAsync — ce qui gère le téléchargement de fichiers en blocs post-création pour chaque enregistrement. Cela permet aux téléchargements de fichiers de rester transactionnels avec le reste du formulaire.

Les lignes de création en attente apparaissent immédiatement dans la grille avec l’icône de type de fichier et le nom du fichier, mais sans les icônes Aperçu ou Téléchargement (il n’y a pas encore de fichier serveur). Ils sont retirés de la liste en attente lorsque le contexte est enregistré, ou réinitialisés via RefreshContextButton / MainContext.ResetState().