FileGrid

Die Komponente FileGrid ist ein spezialisiertes Raster zur Verwaltung von Dataverse-Datensätzen, dessen Hauptinhalt eine einzelne Dateispalte ist. Es umfasst MainGrid Drag-and-Drop-Upload, pro-zeilen-Vorschau- und Download-Icons sowie einen Bulk-Zip-Download jeder geladenen Datei. Das Grid respektiert außerdem die umgebungsweiten Blocked-Extensions-Liste und die Größenbeschränkungen pro Spalte von Dataverse und beteiligt sich an MainContext / RecordContext speichert Pipelines, wenn eine im Scope liegt.

Grundlegende Verwendung

Gib die Tabelle und den logischen Namen der Dateispalte an, die das Raster verwalten soll. Die Schaltflächen Hochladen, Datei ersetzen, Alles herunterladen und Löschen erscheinen automatisch; Dateien können auch auf das Raster abgelegt werden. Geben Sie ein <Buttons> Renderfragment zu, um eigene Symbolleisten-Buttons neben den eingebauten Funktionen hinzuzufügen – dasselbe Muster MainGrid und SubGrid dieselbe Unterstützung.

Automatische Dateispalteninjektion

Wenn die FetchXML- und Spaltenliste der aktiven Ansicht nicht bereits enthalten , FileColumnwird das Raster auf eine geklonte Kopie eingepflanzt, sodass Dateiname, Typsymbol und Pro-Zeilen-Vorschau-/Download-Icons immer gerendert werden – unabhängig davon, welche Ansicht der Nutzer wählt. Die cache-geteilte View-Instanz bleibt unberührt, sodass andere Raster nicht betroffen sind.

Maximale Dateigröße

Benutze sie, MaxFileSizeBytes um die Größe hochgeladener Dateien zu begrenzen. Das Raster beschränkt deinen Wert auf die kleinere Metadaten der Spalte MaxSizeInKB und die maxuploadfilesize Umgebungseinstellungen, sodass eine serverseitige Datei nicht erst in die Warteschlange gelegt werden kann. Dateien über der effektiven Obergrenze erzeugen einen Dialog, bevor sie an Dataverse gesendet werden.

Erlaubte Erweiterungen

Pass, AllowedExtensions um Uploads auf eine Whitelist von Erweiterungen zu beschränken. Abgelehnte Dateien erzeugen einen Dialog, der erklärt, welche Erweiterungen akzeptiert werden. Wenn sie nicht gesetzt ist, ist jede Erweiterung erlaubt (vorbehaltlich der unten aufgeführten Blockliste der Umgebung).

Umwelt-Blockliste

Dataverse-Umgebungen führen eine blockedattachments Liste, die bestimmte Erweiterungen (SVG, EXE, BAT, JS usw.) unabhängig vom Aufrufer ablehnt. Sie FileGrid liest diese Liste bei init über den IPowerPortalsProService.GetEnvironmentFileSettingsAsync() Aufruf, speichert sie eine Stunde lang und lehnt ab, Dateien clientsseitig mit einer freundlichen Nachricht statt eines serverseitigen Fehlers abzugleichen. Die Umgebungs-Blockliste gewinnt AllowedExtensions immer – die Erlaubnisliste einer Spalte kann einen Block auf Umweltebene nicht überschreiben.

Kann man keine SVGs hochladen?

Dataverse-Umgebungen blockieren svg standardmäßig, weil SVGs eingebettete Skripte tragen können. Wenn du SVG-Uploads brauchst, entferne es aus der Einstellung "Set blocked file extensions for attachments" im Power Platform Admin Center – dieses Grid erkennt die Änderung innerhalb einer Stunde.

Erlaubnis-Gating

Der Upload-Button und die Drop-Zone-Aktivierung berücksichtigen beide, ob der aktuelle Portalnutzer eine Berechtigung für die Zieltabelle hat Create . Wenn der Benutzer keine Erstellung hat, ist der Upload-Button versteckt und das Ziehen von Dateien über das Raster ist ein No-Op – serverseitige Durchsetzung läuft weiterhin als Backstop. Die Berechtigung wird über ITablePermissionCache benutzerdefinierte Implementierungen aufgelöst, sodass sie ITableRecordPermissionHandler in dieselbe Gating-Logik einfließen. Der Upload-Button blendet sich außerdem automatisch aus, wenn eine oder mehrere Zeilen ausgewählt werden, um die Symbolleiste ordentlich zu halten.

Per-Row Vorschau & Download

Die Dateispalte wird als [type-icon] filename [eye] [download]gerendert. Das Vorschau-Symbol öffnet das FilePreviewDialog — siehe Vorschau-Rendering unten, um zu sehen, wie jeder Dateityp aussieht. Das Download-Symbol streamt die Datei über die FileDownload JSInterop-Komponente. Beide Symbole können pro Raster über AllowPreviewForFileColumns / AllowDownloadForFileColumnsausgeschaltet werden.

Das Vorschau-Symbol erscheint nur bei Dateitypen, die der Dialog rendern kann – nicht unterstützte Erweiterungen überspringen das Symbol, anstatt eine fehlerhafte Affordance anzuzeigen. Beide Aktionssymbole sind in ausstehenden Erstellen-Zeilen (Datensätze, die noch nicht im Dataverse gespeichert wurden) versteckt.

Vorschau-Rendering

Er FilePreviewDialog wählt einen Renderer basierend auf der Dateiendung:

• Bilder (png, jpg, jpeg, gif, bmp, webp, svg) — inline <img> mit einer base64-Daten-URL. Begrenzt auf 70 vh, sodass sehr hohe Bilder im Dialog scrollfähig bleiben.
• PDFs — werden als Blob-URL geladen <iframe> , sodass der integrierte Viewer des Browsers mehrseitiges Scrollen, Zoomen, Suche und Textauswahl übernimmt. Die Blob-URL wird beim Dialogschließen widerrufen.
• Markdown (md, markdown) — serverseitig über Markdig mit seinen erweiterten Erweiterungen (Tabellen, Aufgabenlisten, Fenced Code, Autolinks, Fußnoten) in HTML konvertiert und in einem Vorschau-Tab angezeigt. Ein zweiter Text-Tab zeigt die Rohquelle mit Syntaxhervorhebung. Das Roh-HTML-Passthrough im Quellcode wird vor dem Rendern entfernt, sodass ein .md nicht hereinschmuggeln <script> kann oder ein <iframe>.
• Quell- und strukturierter Text (JSON, XML, YAML, YML, HTML, HTM, JS, TS, CS, CSS) — in einer <pre> mit highlight.js Kolorierung gerendert. Die Sprache wird aus der Erweiterung gewählt über FileTypeIcons.GetSyntaxLanguage; nur die beworbenen Sprachen werden gebündelt, um die Asset-Größe klein zu halten. Das Markieren läuft über ein colociertes FilePreviewDialog.razor.ts Modul über JS-Interop – wenn der Interop-Aufruf fehlschlägt, fällt der Dialog lautlos auf unfarbigen Text zurück.
• Klartext (txt, Log, CSV) – in a <pre> ohne Hervorhebung gerendert. highlightAuto wird absichtlich nicht verwendet, weil seine Vermutungen bei kurzen Ausschnitten (ein winziges Log oder eine einzelne CSV-Zeile) eine verwirrendere Farbe erzeugen als gar keine Farbe.
• Zip-Archive (zip) — im Speicher System.IO.Compression.ZipArchive geparst und als geteilte Scheibe dargestellt: ein zusammenklappbarer Baum links (Ordner zuerst, alphabetisch, mit der Größe pro Eintrag und zuletzt geändert beim Schwebebe) und die Vorschau des ausgewählten Eintrags rechts. Der rechte Bereich ist verschachtelt FilePreviewContent, sodass innere Dateien durch denselben Renderer-Lookup laufen – Bilder, PDFs, hervorgehobene Quelle, Markdown und sogar Zip-in-Zip werden alle genauso vorschauen wie eigenständig. Das Archiv wird niemals auf die Festplatte extrahiert.

Alles herunterladen (Zip)

Der Download All-Button der Toolbar streamt jede aktuell im Raster gerenderte Datei als eine einzige Zip-Datei, die serverseitig im ZipArchive Speicher integriert und durch die Blazor-Leitung geleitet wird – kein zusätzlicher HTTP-Endpunkt erforderlich. Doppelte Dateinamen erhalten ein (2)Suffix. (3) Stellen Sie den Button so ein, AllowDownloadAll="false" dass er den Button aussortiert, ohne die Download-Icons pro Reihe zu deaktivieren.

Anpassung des erstellten Datensatzes

Standardmäßig erstellt jede hochgeladene Datei einen minimalen Datensatz, in dem nur die Dateispalte gefüllt ist. Für Tabellen mit zusätzlichen erforderlichen Spalten – oder zum Seeden anderer Daten – passieren OnUploadRecordAsync und geben sie ein vollständig ausgefülltes TableRecord. Der Delegierte ist asynchron, sodass du Dienste konsultieren, Nachschlagen durchführen oder Namen generieren kannst, bevor du zurückkehrst.

MainContext / RecordContext Integration

Wenn das Raster in einem MainContext oder RecordContextverschachtelt ist, werden Uploads in die Pending-Create-Liste des Gitters gestuft, anstatt sofort erstellt zu werden. Der übergeordnete IsDirty Kontext wechselt zu true, und auf SaveAsync den gestuften Datensätzen (mit ihren FileValue Bytes) werden sie durch ExecuteMultipleAsync Batch verteilt — was den Nachbearbeitungs-Upload von Chunk-Dateien für jeden Datensatz übernimmt. Dadurch bleibt die Datei transaktional mit dem Rest des Formulars hochgeladen.

Pending-create-Zeilen erscheinen sofort im Raster mit dem Dateityp-Symbol und Dateinamen, aber ohne die Icons "Vorschau" oder "Download" (es gibt noch keine Serverdatei). Sie werden aus der Liste der ausstehenden Punkte entfernt, wenn der Kontext gespeichert wird, oder über / MainContext.ResetState()zurückgesetzt RefreshContextButton .