FileGrid

O FileGrid componente é uma grade especializada para gerenciar registros do Dataverse cujo conteúdo principal é uma única coluna de arquivo. Ele envolve MainGrid e sobrepõe o upload arrastando e solta, pré-visualização e download por linha, além de um download zip-pack em massa de cada arquivo carregado. A grade também respeita a lista de extensões bloqueadas em todo o ambiente do Dataverse e os limites de tamanho por coluna, e participa / MainContext RecordContext salva pipelines quando um deles está dentro do escopo.

Uso Básico

Especifique a tabela e o nome lógico da coluna do arquivo que a grade deve gerenciar. Os botões Upload, Substituir Arquivo, Download All e Delete aparecem automaticamente; arquivos também podem ser lançados na grade. Passe um <Buttons> fragmento de renderização para adicionar seus próprios botões de barra de ferramentas junto com os integrados — o mesmo padrão MainGrid e SubGrid suporte.

Injeção Automática de Coluna de Arquivo

Se o FetchXML e a lista de colunas da visualização ativa ainda não incluem o FileColumn, a grade o enxerta em uma cópia clonada, de modo que o nome do arquivo, o ícone de tipo e os ícones de prévia/download por linha sempre aparecem — independentemente da visualização escolhida pelo usuário. A instância de visualização compartilhada no cache fica intocada, então outras grades não são afetadas.

Tamanho Máximo do Arquivo

Use MaxFileSizeBytes para limitar o tamanho dos arquivos enviados. A grade limita seu valor ao menor entre os metadados da MaxSizeInKB coluna e a configuração do maxuploadfilesize ambiente, então um arquivo rejeitado do lado do servidor não pode ser colocado em fila em primeiro lugar. Arquivos acima do limite efetivo produzem um diálogo antes de serem enviados para o Dataverse.

Extensões Permitidas

Passe AllowedExtensions para restringir uploads a uma lista branca de extensões. Arquivos rejeitados geram um diálogo explicando quais extensões são aceitas. Quando deixada sem definir, qualquer extensão é permitida (sujeita à lista de bloqueios do ambiente abaixo).

Lista de Bloqueio Ambiental

Ambientes Dataverse mantêm uma blockedattachments lista que rejeita certas extensões (SVG, EXE, BAT, JS, etc.) independentemente do chamador. Ele FileGrid lê essa lista no init via chamada IPowerPortalsProService.GetEnvironmentFileSettingsAsync() , armazena em cache por uma hora e rejeita arquivos correspondentes do lado do cliente com uma mensagem amigável em vez de uma falha do lado do servidor. A lista de bloqueio ambiental sempre prevalece AllowedExtensions — a lista de permitir de uma coluna não pode sobrescrever um bloco em nível ambiental.

Não é possível enviar SVGs?

Ambientes Dataverse bloqueiam svg por padrão porque SVGs podem carregar scripts embarcados. Se precisar de uploads SVG, remova-o da configuração de Definir extensões de arquivo bloqueadas para anexos no centro de administração do Power Platform — essa grade detectará a mudança em até uma hora.

Bloqueio de Permissão

O botão Upload e a ativação da zona de lançamento honram se o usuário atual do portal tem Create permissão na tabela de alvo. Quando o usuário não tem criar, o botão de Upload fica oculto e arrastar arquivos pela grade é inopável — a aplicação do lado do servidor ainda funciona como backstop. A permissão é resolvida por ITablePermissionCache meio de implementações personalizadas ITableRecordPermissionHandler que alimentam a mesma lógica de gates. O botão Upload também se oculta automaticamente sempre que uma ou mais linhas são selecionadas, para manter a barra de ferramentas organizada.

Prévia e Download por Fileira

A coluna do arquivo é renderizada como [type-icon] filename [eye] [download]. O ícone de Pré-visualização abre — FilePreviewDialog veja Visualização abaixo para ver como cada tipo de arquivo se apresenta. O ícone de Download transmite o arquivo pelo FileDownload componente JSInterop. Qualquer um dos ícones pode ser desativado por grade via AllowPreviewForFileColumns / AllowDownloadForFileColumns.

O ícone Pré-visualização só aparece para tipos de arquivos que o diálogo pode renderizar — extensões não suportadas pulam o ícone em vez de mostrar uma possibilidade quebrada. Ambos os ícones de ação estão ocultos em linhas de criação pendente (registros que ainda não foram salvos no Dataverse).

Renderização de Prévia

Ele FilePreviewDialog escolhe um renderizador com base na extensão do arquivo:

• Imagens (png, jpg, jpeg, gif, bmp, webp, svg) — alinhadas <img> com uma URL de dados base64. Limitado a 70 vh, então imagens muito altas permanecem roláveis dentro do diálogo.
• PDFs — carregados como uma URL de blob em um <iframe> so o visualizador embutido do navegador gerencia rolagem de várias páginas, zoom, busca e seleção de texto. A URL do blob é revogada ao fechar o diálogo.
• Markdown (md, markdown) — convertido para HTML do lado do servidor via Markdig com suas extensões avançadas (tabelas, listas de tarefas, código vendido, autolinks, notas de rodapé) e mostrado em uma aba Prévia. Uma segunda aba de Texto mostra a fonte bruta com realce de sintaxe. O passthrough HTML bruto na fonte é removido antes da renderização, então não .md é possível contrabandear <script> ou um <iframe>arquivo .
• Texto fonte e estruturado (json, xml, yaml, yml, html, htm, js, ts, cs, css) — renderizado em um <pre> com highlight.js coloração. A linguagem é escolhida da extensão via FileTypeIcons.GetSyntaxLanguage; apenas as linguagens anunciadas são agrupadas para manter o tamanho do ativo pequeno. O destaque passa por um módulo colocalizado FilePreviewDialog.razor.ts sobre interoperação JS — se a chamada de interoperabilidade falhar, o diálogo silenciosamente volta para texto sem cor.
• Texto simples (txt, log, csv) — renderizado em um <pre> sem ressaltamento. highlightAuto é intencionalmente não usado porque suas suposições em trechos curtos (um pequeno log ou uma única linha CSV) produzem cores mais confusas do que nenhuma cor.
• Zip archives (zip) — analisados em memória via System.IO.Compression.ZipArchive e renderizados como um painel dividido: uma árvore dobrável à esquerda (as pastas primeiro, em ordem alfabética, com tamanho por entrada e última modificação aparecem ao passar o cursor), e a pré-visualização da entrada selecionada à direita. O painel direito é aninhado FilePreviewContent, então arquivos internos passam pela mesma consulta de renderizador — imagens, PDFs, fonte destacada, markdown e até zip-within-zip todos pré-visualizam da mesma forma que fariam standalone. O arquivo nunca é extraído para o disco.

Baixar Tudo (Zip)

O botão Download All da barra de ferramentas transmite todos os arquivos atualmente renderizados na grade como um único zip, embutido na memória do lado do servidor ZipArchive e canalizado pelo circuito Blazor — sem necessidade de endpoint HTTP extra. Nomes de arquivo duplicados recebem um (2)sufixo , (3) . Configure AllowDownloadAll="false" para ocultar o botão sem desabilitar os ícones de download por linha.

Personalizando o Registro Criado

Por padrão, cada arquivo enviado cria um registro mínimo com apenas a coluna do arquivo preenchida. Para tabelas com colunas adicionais obrigatórias — ou para semear outros dados — passe OnUploadRecordAsync e retorne um . TableRecord O delegado é assíncrono, então você pode consultar serviços, resolver consultas ou gerar nomes antes de retornar.

MainContext / Integração RecordContext

Quando a grade está aninhada dentro de um MainContext ou RecordContext, os uploads são posicionados na lista de criação pendente da grade, em vez de serem criados imediatamente. Os contextos IsDirty pais invertem para true, e nos SaveAsync registros em estágio (com seus FileValue bytes) são agrupados ExecuteMultipleAsync — que cuida do upload do arquivo em blocos pós-criação para cada registro. Isso mantém os uploads de arquivos transacionais com o restante do formulário.

As linhas de criação pendente aparecem imediatamente na grade com o ícone do tipo de arquivo e o nome do arquivo, mas sem os ícones de Prévia ou Download (ainda não há arquivo de servidor). Eles são removidos da lista pendente quando o contexto é salvo, ou resetados via RefreshContextButton / MainContext.ResetState().