FileGrid

El FileGrid componente es una cuadrícula especializada para gestionar registros de Dataverse cuyo contenido principal es una columna de archivo. Envuelve MainGrid y superpone iconos de arrastre y solta subida, previsualización y descarga por fila, y una descarga en masa con zip de cada archivo cargado. La cuadrícula también respeta la lista de extensiones bloqueadas a nivel de entorno de Dataverse y los límites de tamaño por columna, y participa o MainContext RecordContext guarda pipelines cuando uno está dentro del ámbito.

Uso básico

Especifica la tabla y el nombre lógico de la columna de archivo que debe gestionar la cuadrícula. Los botones de Subir, Reemplazar archivo, Descargar todo y Eliminar aparecen automáticamente; también se pueden dejar caer archivos en la cuadrícula. Pasa un <Buttons> fragmento de renderizado para añadir tus propios botones de barra de herramientas junto a los integrados — el mismo patrón MainGrid y SubGrid soporte.

Inyección automática de columna de archivo

Si el FetchXML y la lista de columnas de la vista activa no incluyen ya el FileColumn, la cuadrícula lo injerta en una copia clonada para que el nombre del archivo, el icono de tipo y los iconos de previsualización/descarga por fila siempre se muestren — independientemente de la vista que elija el usuario. La instancia de vista compartida en caché queda intacta, por lo que otras cuadrículas no se ven afectadas.

Tamaño máximo de archivo

Úsalo MaxFileSizeBytes para limitar el tamaño de los archivos subidos. La cuadrícula limita tu valor al menor de los metadatos de la MaxSizeInKB columna y la configuración del maxuploadfilesize entorno, por lo que un archivo rechazado en el lado del servidor no puede ponerse en cola en primer lugar. Los archivos que superan el límite efectivo generan un diálogo antes de enviarse a Dataverse.

Extensiones permitidas

Pasar AllowedExtensions para restringir subidas a una lista blanca de extensiones. Los archivos rechazados generan un diálogo explicando qué extensiones son aceptadas. Cuando no se activa, se permite cualquier extensión (sujeta a la lista de bloqueo del entorno que aparece más abajo).

Lista de bloqueos ambientales

Los entornos Dataverse mantienen una blockedattachments lista que rechaza ciertas extensiones (SVG, EXE, BAT, JS, etc.) independientemente del llamante. Lee FileGrid esta lista en la entrada a través de la IPowerPortalsProService.GetEnvironmentFileSettingsAsync() llamada, la almacena en caché durante una hora y rechaza los archivos coincidentes del lado del cliente con un mensaje amigable en lugar de un fallo del lado del servidor. La lista de bloqueo ambiental siempre gana AllowedExtensions — la lista de permitir de una columna no puede anular un bloque a nivel de entorno.

¿No se pueden subir SVGs?

Los entornos Dataverse bloquean svg por defecto porque los SVG pueden transportar scripts embebidos. Si necesitas cargas SVG, elimínalas de la configuración de 'Establecer extensiones de archivo bloqueadas para adjuntos ' en el centro de administración de Power Platform — esta red detectará el cambio en menos de una hora.

Bloqueo de permisos

El botón de Subir y la activación de la zona de caída respetan si el usuario actual del portal tiene Create permiso en la tabla objetivo. Cuando el usuario no tiene crear, el botón de Subir está oculto y arrastrar archivos por la cuadrícula no es una opción — la aplicación del servidor sigue funcionando como backstop. Los permisos se resuelven mediante ITablePermissionCache implementaciones personalizadas ITableRecordPermissionHandler que alimentan la misma lógica de gates. El botón de Subir también se oculta automáticamente cada vez que se seleccionan una o más filas, para mantener la barra de herramientas ordenada.

Vista previa y descarga por fila

La columna del archivo se muestra como [type-icon] filename [eye] [download]. El icono de Vista previa abre — FilePreviewDialog consulta Renderizado de Vista previa más abajo para ver cómo es cada tipo de archivo. El icono de descarga transmite el archivo a través del FileDownload componente JSInterop. Cualquiera de los dos iconos puede desactivarse por cuadrícula mediante AllowPreviewForFileColumns / AllowDownloadForFileColumns.

El icono de Vista previa solo aparece para los tipos de archivo que el diálogo puede renderizar: las extensiones no soportadas saltan el icono en lugar de mostrar una posibilidad rota. Ambos iconos de acción están ocultos en filas de creación pendiente (registros que aún no se han guardado en Dataverse).

Renderizado de previsualización

Elige FilePreviewDialog un renderizador en función de la extensión del archivo:

• Imágenes (png, jpg, jpeg, gif, bmp, webp, svg) — en línea <img> con una URL de datos base64. Limitado a 70 vh, así que las imágenes muy altas se mantienen desplazables dentro del diálogo.
• PDFs — cargados como URL de blob en un <iframe> SO. El visor integrado del navegador gestiona el desplazamiento multipágina, el zoom, la búsqueda y la selección de texto. La URL del blob se revoca al cerrar el diálogo.
• Markdown (md, markdown) — convertido a HTML en el lado del servidor a través de Markdig con sus extensiones avanzadas (tablas, listas de tareas, código vendido, autolinks, notas al pie) y mostrado en una pestaña de Vista Previa . Una segunda pestaña de Texto muestra la fuente en bruto con resaltado de sintaxis. El paso HTML en bruto en el código fuente se elimina antes de renderizar, por lo que no .md se puede introducir <script> de contrabando o un <iframe>archivo .
• Texto fuente y estructurado (json, xml, yaml, yml, html, htm, js, ts, cs, css) — renderizado en un <pre> con highlight.js colorización. El idioma se elige de la extensión mediante FileTypeIcons.GetSyntaxLanguage; solo los idiomas anunciados se agrupan para mantener el tamaño del activo pequeño. El resaltado se realiza a través de un módulo colocalizado FilePreviewDialog.razor.ts sobre interoperación JS — si la llamada a interop falla, el diálogo vuelve silenciosamente a texto sin colorear.
• Texto plano (txt, log, csv) — renderizado en un <pre> sin resaltado. no se usa intencionadamente highlightAuto porque sus suposiciones en fragmentos cortos (un pequeño log o una sola fila CSV) producen un color más confuso que no tener color alguno.
• Archivos zip (zip) — analizados en memoria y System.IO.Compression.ZipArchive renderizados como un panel dividido: un árbol plegable a la izquierda (carpetas primero, alfabéticamente, con tamaño por entrada y última modificación apareciendo al pasar el cursor), y la vista previa de la entrada seleccionada a la derecha. El panel derecho es anidado FilePreviewContent, así que los archivos internos se enrutan a través de la misma búsqueda del renderizador — imágenes, PDFs, fuente resaltada, markdown e incluso zip-within-zip previsualizan de la misma manera que lo harían por separado. El archivo nunca se extrae al disco.

Descargar todo (Zip)

El botón Descargar Todo de la barra de herramientas transmite cada archivo actualmente renderizado en la cuadrícula como un solo zip, integrado en memoria del ZipArchive lado del servidor y canalizado a través del circuito Blazor — sin necesidad de endpoint HTTP adicional. Los nombres de archivo duplicados reciben un (2)sufijo , (3) . Configurado AllowDownloadAll="false" para ocultar el botón sin desactivar los iconos de descarga por fila.

Personalización del registro creado

Por defecto, cada archivo subido crea un registro mínimo con solo la columna del archivo poblada. Para tablas con columnas adicionales requeridas — o para sembrar otros datos — pasa OnUploadRecordAsync y devuelve un archivo completamente TableRecordpoblado . El delegado es asincrónico, así que puedes consultar servicios, resolver búsquedas o generar nombres antes de volver.

MainContext / Integración de RecordContext

Cuando la cuadrícula está anidada dentro de un MainContext o RecordContext, las subidas se organizan en la lista de creación pendiente de la cuadrícula en lugar de crearse inmediatamente. El contexto IsDirty padre cambia a true, y en SaveAsync los registros en etapas (con sus FileValue bytes) se agrupan ExecuteMultipleAsync — que gestiona la subida de archivos fragmentados post-creación para cada registro. Esto mantiene las subidas de archivos transaccionales con el resto del formulario.

Las filas de pending-create aparecen inmediatamente en la cuadrícula con el icono de tipo de archivo y el nombre del archivo, pero sin los iconos de Vista previa o descarga (aún no hay archivo de servidor). Se eliminan de la lista pendiente cuando el contexto se guarda, o se reinician mediante RefreshContextButton / MainContext.ResetState().