File Upload

Many Blazor application require single or multiple files upload - images, documents, audio, video, and other files - as their core functionality. The Blazor Upload Component enables you to easily build asynchronous file upload and offers auto upload, multiple configuration options, file upload progress indication, validation, and events out of the box. With just a couple of lines of code your file upload requirements are implemented in both Blazor WebAssembly (WASM) and Server-side Blazor apps.

Demo of Upload Component with built-in validation and progress indicator.

Users can select single or multiple files and upload them at the same time, which is quite useful when uploading large number of documents to a file sharing application, or images to a gallery. In addition to that, for large files you can monitor the progress of the uploaded files. Upon file upload you are presented with option to remove specific files that were part of the initial selection but are not relevant.

The File Upload control offers several built-in parameters to help you easily perform validation of the selected files on the client. You can set restrictions to the allowed size using MinFileSize and MaxFileSize properties, or file format using the AllowedExtensions parameter

Demo of file upload validation scenarios with the Blazor Upload component.

File uploads often require handling of both selected and uploaded files, and various steps of the file upload process. The Upload UI control comes handy with a long list of exposed events to help you easily handle various scenarios and have full control over the uploading. The events arguments provide list of the files, corresponding actions (upload, deletion etc.) and access to the request objects so you can provide metadata to the server (such as authentication information).

• OnSelect - fires every time the user selects new files for upload.
• OnUpload - fires when files will be uploaded and allows you to add custom metadata with the upload request such as authentication tokens.
• OnRemove - fires when the users click the [x] button of an uploaded file. It sends a request to the server so you can clean up the file the user changed their mind about.
• OnProgress - fires each time a file makes progress in its upload process.
• OnSuccess - fires each time a request is successful - either an upload of a file, or the deletion of a file. 
• OnError - fires each time a request fails - either an upload of a file, or the deletion of a file.
• OnCancel - fires when the user clicks the "Cancel" button on a file that is currently uploading.
• OnClear - fires when the user clicks the "Clear" button.

Demo of Upload Component events.

The Telerik Blazor Upload component has several built-in themes such as Default (our own styling), Material (based on the Material Design guidelines) and Bootstrap (which looks like the Bootstrap styling to integrate better). You can easily customize any of out-of-the-box themes with a few lines of CSS, or create new theme to match your colors and branding by using the Telerik SASS ThemeBuilder application.

Users can use the arrow keys to navigate between the uploaded files, retry a failed file upload, cancel an upload in progress or delete an already uploaded file—all without taking their hands off the keyboard.

The Upload control has built-in localization support, which makes it easy to localize your Blazor upload to any language that your app may require.

Demo of Upload Component in various languages.