DxFileInput.AllowedFileExtensions Property

Specifies file extensions that the File Input component can upload.

Assembly : DevExpress.Blazor.v25.2.dll

Declaration

csharp

[Parameter]
public List<string> AllowedFileExtensions { get; set; }

Property Value

Type	Description
List<String>

A list of allowed file extensions.

Remarks

You can use the following APIs to specify file types and extensions accepted by File Input.

Open File Dialog Filter

The AcceptedFileTypes property sets the file type filter in the Open File dialog. The property value is passed to the accept attribute of the underlying input HTML element.

If a user removes the filter, the Open File dialog displays all file types and users can select files that do not match AcceptedFileTypes.

A user can also skip the Open File dialog and simply drop files onto the drop zone.

File Type Validation

Once a file is added to the file list, the component validates the following:

Whether the file MIME type is in AcceptedFileTypes. To skip MIME type validation, set ValidateByAcceptedFileTypes to false.
Whether the file name extension is in AllowedFileExtensions.

If validation fails, the File Input cannot upload the file and displays an error message.

Example

The following example allows users to upload PNG, JPG, and PDF files:

razor

<DxFileInput FilesUploading="OnFilesUploading"
             AllowedFileExtensions="@(new List<string> { ".png", ".jpg", ".pdf" })" />

@code {
    async Task OnFilesUploading(FilesUploadingEventArgs args) {
        foreach (var file in args.Files) {
            /* The following code is intended for demonstration purposes only.
            Do not read a stream directly in memory to avoid performance and security-related issues. */
            using var stream = new System.IO.MemoryStream();
            await file.OpenReadStream(file.Size).CopyToAsync(stream);
        }
    }
}