FileUpload
Datei-Upload per Klick oder Drag & Drop. Unterstützt Einzel- und Mehrfach-Upload, Dateifilter nach Erweiterung, Größenbeschränkung, automatischen Upload bei Auswahl, Fortschrittsanzeige mit Abbrechen sowie vollständige Validierung.
Grundvarianten
Innerhalb eines
Form werden Dateien zuerst im Browser gesammelt und erst mit Upload() übertragen.
@bind-AbsolutFilePaths bzw. @bind-AbsolutFilePath liefern die Serverpfade, HatDateien zeigt eine offene Auswahl an,
AllesLoeschen() leert sie.
Mehrfach-Upload
HatDateien: nein
Wert (AbsolutFilePaths): –
Einzeldatei-Upload
Wert (AbsolutFilePath): –
Ohne Label
Zustände
Disabled: Feld vollständig deaktiviert – ausgegraut, kein Hochladen möglich.
UploadOnChange: Dateien werden sofort nach der Auswahl hochgeladen, ohne separaten Upload-Button (außerhalb eines
UploadOnChange: Dateien werden sofort nach der Auswahl hochgeladen, ohne separaten Upload-Button (außerhalb eines
Form immer aktiv).
Während des Uploads erscheinen Fortschrittsbalken und Abbrechen-Button (AbbrechenUpload()).
Disabled
UploadOnChange = true
Upload abgeschlossen: –
Dateibeschränkungen
AllowedExtensions schränkt auf bestimmte Dateitypen ein. MaxFileSize begrenzt die Dateigröße in Bytes. MaxFiles limitiert die Anzahl bei Mehrfach-Upload.
Verstöße werden sofort nach der Auswahl angezeigt und verhindern den Upload.
Nur Bilder (.png, .jpg, .gif)
Max. 1 MB pro Datei
Max. 2 Dateien
Callbacks
OnFilesChanged feuert bei jeder Änderung der Auswahl. OnFileUploaded liefert den Pfad jeder hochgeladenen Datei.
OnUploadComplete wird nach dem Upload aller Dateien aufgerufen, AfterValueChanged danach einmal pro erfolgreichem Upload.
OnFilesChanged: 0×
OnFileUploaded: –
OnUploadComplete: 0 Datei(en)
AfterValueChanged: 0×
Eigene ID (ForcedIdValue)
ForcedIdValue setzt eine feste ID am internen <input type="file"> – z. B. für Tests oder externe Labels. Das eingebaute Label verweist automatisch darauf.
Input-ID: demo-upload-feste-id
Size
Alle fünf Größen von
Xs bis Xl.
Xs
Sm
Md (Standard)
Lg
Xl
class & style
Beliebige HTML-Attribute (
class, style, data-*, aria-*) werden an den Wrapper durchgereicht.
class
style
data-testid
Validierung
Integration in den
EditContext über Form; @bind-AbsolutFilePath erzeugt die benötigte AbsolutFilePathExpression automatisch. Required="true" erzwingt eine Dateiauswahl vor dem Absenden,
ShowValidationTooltip zeigt Fehlermeldungen als Tooltip (beim Überfahren). Ohne Tooltip stehen die Meldungen unter dem Feld.
Erst bei gültigem Formular wird im OnValidSubmit hochgeladen.
SKILL.md – Fileupload
--- name: FileUpload description: Onesown Blazor Komponente FileUpload (Inputs). Verwende diesen Skill wenn du die FileUpload-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # FileUpload **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Inputs **Basisklasse:** `FormControlBase` Upload-Komponente, die ausgewählte Dateien im Browser sammelt und erst beim Upload in Chunks zum Server überträgt. Dateien können über mehrere Durchsuchen-Aktionen oder per Drag & Drop akkumulierend hinzugefügt und einzeln entfernt werden. Während des Uploads zeigt sie einen Fortschrittsbalken mit Abbrechen-Button. WICHTIG – Einbindung in andere Projekte: Der Chunk-Upload überträgt Dateidaten als Base64 über SignalR. Der SignalR-Default (32 KB) reicht dafür nicht aus. In Program.cs muss zwingend folgendes konfiguriert werden: builder.Services.AddRazorComponents() .AddInteractiveServerComponents() .AddHubOptions(o => o.MaximumReceiveMessageSize = 10 * 1024 * 1024); Ohne diese Einstellung bricht SignalR die Verbindung beim Upload größerer Dateien ab. **Live-Demo:** https://components.schini.com/demo/fileupload ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``AbsolutFilePath`` | ``string`` | | Absoluter Dateipfad der hochgeladenen Einzeldatei. Für Two-Way-Binding @bind-AbsolutFilePath verwenden. | | ``AbsolutFilePathChanged`` | ``EventCallback<string>`` | | EventCallback für Two-Way-Binding mit @bind-AbsolutFilePath. Wird nach jeder hochgeladenen Datei ausgelöst. | | ``AbsolutFilePathExpression`` | ``Expression<Func<object>>`` | | LINQ-Expression auf die Einzeldatei-Property. Wird für die Validierung im EditContext und für Label/Required aus DataAnnotations benötigt. | | ``Multiple`` | ``bool`` | ``true`` | Erlaubt die Auswahl mehrerer Dateien. Bei false ersetzt jede neue Auswahl die bisherige Datei. Standard: true. | | ``AbsolutFilePaths`` | ``List<string>`` | | Liste der absoluten Dateipfade aller beim letzten Upload hochgeladenen Dateien. Für Two-Way-Binding @bind-AbsolutFilePaths verwenden. | | ``AbsolutFilePathsChanged`` | ``EventCallback<List<string>>`` | | EventCallback für Two-Way-Binding mit @bind-AbsolutFilePaths. Wird nach erfolgreichem Upload aller Dateien ausgelöst. | | ``AbsolutFilePathsExpression`` | ``Expression<Func<object>>`` | | LINQ-Expression auf die Mehrfach-Dateipfade-Property. Wird für die Validierung im EditContext und für Label/Required aus DataAnnotations benötigt. | | ``OnFilesChanged`` | ``EventCallback`` | | Wird ausgelöst, nachdem sich die Dateiauswahl geändert hat (Datei hinzugefügt, entfernt oder Auswahl geleert). | | ``UploadOnChange`` | ``bool`` | ``false`` | Wenn true, wird sofort nach der Dateiauswahl hochgeladen. Außerhalb eines <Form> wird immer automatisch hochgeladen. Standard: false. | | ``AbsolutDirectoryPath`` | ``string`` | | Absoluter Verzeichnispfad auf dem Server, in den die Dateien hochgeladen werden. Wird bei Bedarf angelegt; ohne Angabe ist kein Upload möglich. | | ``MaxFileSize`` | ``double`` | ``ByteSize.FromMegaBytes(300).Bytes`` | Maximale Dateigröße in Bytes pro Datei. Standard: 300 MB. | | ``MaxFiles`` | ``int`` | ``10`` | Maximale Anzahl auswählbarer Dateien. Standard: 10. | | ``AllowedExtensions`` | ``string`` | | Erlaubte Dateiendungen als kommagetrennte Liste (z. B. ".pdf,.docx"). Wird als accept-Attribut gesetzt und serverseitig geprüft. Leer = alle Typen erlaubt. | | ``OnFileUploaded`` | ``EventCallback<string>`` | | Wird ausgelöst, nachdem eine einzelne Datei erfolgreich hochgeladen wurde. Liefert den absoluten Dateipfad. | | ``OnUploadComplete`` | ``EventCallback<int>`` | | Wird ausgelöst, nachdem alle Dateien hochgeladen wurden. Liefert die Anzahl der hochgeladenen Dateien. | | ``Required`` | ``bool`` | | Markiert das Feld als Pflichtfeld: Es muss mindestens eine Datei ausgewählt oder bereits hochgeladen sein. | | ``UploadText`` | ``string`` | ``"Oder legen Sie Dateien hier ab."`` | Anzeigetext der Drop-Zone neben dem Durchsuchen-Button. Dient ohne sichtbares Label auch als Accessible-Name. Standard: "Oder legen Sie Dateien hier ab." | | ``ForcedIdValue`` | ``string`` | | Erzwingt eine feste ID für das interne Input-Element (statt Id). Das Label verweist automatisch auf diese ID. | ## Geerbte Parameter (FormControlBase) | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Size`` | ``string`` | ``OoSize.Md`` | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. | | ``Id`` | ``string`` | ``Generator.GenerateRandomHtmlTagID()`` | Eindeutige HTML-ID des Input-Elements. Wird automatisch generiert und kann überschrieben werden (z. B. für Labels mit for-Attribut). | | ``ShowLabel`` | ``bool`` | ``true`` | Blendet das Label über dem Eingabefeld ein oder aus. Standard: true. | | ``IsFloatingLabel`` | ``bool`` | ``true`` | Aktiviert das schwebende Label (Floating Label), das beim Fokus oder bei Eingabe nach oben animiert. false = festes Label über dem Feld. Standard: true bzw. OoDefaults.Input.IsFloatingLabel. | | ``Label`` | ``string`` | | Beschriftung des Eingabefelds. Wird auch als Accessible-Name für Screenreader verwendet. | | ``Placeholder`` | ``string`` | ``" "`` | Platzhaltertext im leeren Eingabefeld. Standard: Leerzeichen (verhindert Floating-Label-Sprung in Chrome). | | ``AutoSaveCallback`` | ``EventCallback`` | | Wird nach jeder Wertänderung ausgelöst und signalisiert der Seite, dass gespeichert werden soll. Kombinierbar mit TriggerAutoSaveCallbackOnlyIfValid. | | ``TriggerAutoSaveCallbackOnlyIfValid`` | ``bool`` | ``true`` | Steuert ob AutoSaveCallback nur bei gültigem Wert ausgelöst wird. Standard: true. | | ``AfterValueChanged`` | ``EventCallback`` | | Wird nach jeder Wertänderung ausgelöst, unabhängig von der Gültigkeit des Werts. Geeignet für Live-Vorschau oder Seiteneffekte. | | ``ShowValidationTooltip`` | ``bool`` | ``false`` | Zeigt Validierungsmeldungen als Tooltip neben dem Feld statt als Text darunter. Standard: false. | ## Hinweise - Immer @bind-Value für Two-Way-Binding verwenden - Für Formular-Validierung ValueExpression="() => _model.Property" setzen - Komponente muss innerhalb eines <Form>- oder <EditForm>-Containers liegen, damit der EditContext greift - AutoSaveCallback wird nach jeder gültigen Änderung ausgelöst, wenn TriggerAutoSaveCallbackOnlyIfValid=true (Standard) - AfterValueChanged wird nach jeder Änderung ausgelöst, unabhängig von der Gültigkeit - ShowValidationTooltip=true zeigt Validierungsmeldungen als Tooltip statt unter dem Feld - Eingabefelder (nicht Button/ToggleButton): Defaults für IsFloatingLabel und Size über DefaultsBereich (Input, ersatzweise Size), appweit im Root-Layout; ein Parameter an der Instanz hat Vorrang - Ändert sich nur ein Cascading-Wert, werden die direkten Parameter nicht erneut gesetzt: Ein Eingabefeld rendert beim Tippen nie den vorigen Wert; inhaltlich gleiche OoDefaults lösen kein Rendern aus - Einzeldatei: Multiple="false" + @bind-AbsolutFilePath; für Validierung zusätzlich AbsolutFilePathExpression - Mehrere Dateien: Multiple="true" (Standard) + @bind-AbsolutFilePaths; für Validierung zusätzlich AbsolutFilePathsExpression - Automatischer Upload: UploadOnChange="true" startet den Upload sofort nach der Dateiauswahl; außerhalb eines <Form> wird immer automatisch hochgeladen - Manueller Upload: Upload() programmatisch aufrufen (z. B. im OnValidSubmit des Formulars); AllesLoeschen() leert die Auswahl, AbbrechenUpload() bricht ab - Dateifilter: AllowedExtensions=".pdf,.docx" begrenzt auswählbare Dateitypen und wird zusätzlich serverseitig validiert - Größe: MaxFileSize in Bytes (Standard: 300 MB); MaxFiles begrenzt die Anzahl der Dateien (Standard: 10) - Pflichtfeld: Required="true" verlangt eine ausgewählte oder bereits hochgeladene Datei; ein [Required] auf der gebundenen Pfad-Property wird nur mit UploadOnChange erfüllt, weil der Pfad erst nach dem Upload gesetzt ist - Nach erfolgreichem Upload werden AfterValueChanged und (falls gültig) AutoSaveCallback ausgelöst - Abbruch oder Fehler: teilweise geschriebene Dateien werden gelöscht, nicht hochgeladene Dateien bleiben ausgewählt - Deaktivieren: disabled="true" als HTML-Attribut setzen - SignalR-Limit: MaximumReceiveMessageSize in Program.cs auf mind. 10 MB setzen - IsFloatingLabel hat hier keine Wirkung, das Label steht immer fest über der Ablagefläche; OoDefaults.Input.IsFloatingLabel wird nicht übernommen