Skip to main content
All docs
V24.1

DxFileInput.UploadFile(UploadFileInfo) Method

Uploads the specified file.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.1.dll

NuGet Package: DevExpress.Blazor

Declaration

public void UploadFile(
    UploadFileInfo fileInfo
)

Parameters

Name Type Description
fileInfo UploadFileInfo

The file to be uploaded.

Remarks

Note

UploadAllFiles, UploadFile, and UploadFiles methods ignore files whose upload processes failed or were canceled.

Once a user selects files in the Open dialog or drags files onto a drop zone, the File Input component adds these files to the file list. The file list displays each file’s upload status and upload, cancel, reload, and remove buttons. On the image below, the file list contains 4 files in different states:

file list

Handle the SelectedFilesChanged event to access the collection of files in the file list. Call the following methods to manage these files in code:

Start Upload Cancel Upload Restart Canceled Upload Remove Files from List
One File UploadFile CancelFileUpload ReloadFile RemoveFile
Multiple Files UploadFiles CancelFilesUpload ReloadFiles RemoveFiles
All Files UploadAllFiles CancelAllFilesUpload ReloadAllFiles RemoveAllFiles

The following example displays a button that uploads the first file:

<DxFileInput @ref="MyFileInput"
             AllowMultiFileUpload="true"
             UploadMode="UploadMode.OnButtonClick"
             SelectedFilesChanged="@SelectedFilesChanged"
             FilesUploading="OnFilesUploading" />

<DxButton Text="Upload the First File" Click="OnUploadButtonClick" />

@code {
    DxFileInput MyFileInput { get; set; }
    IEnumerable<UploadFileInfo> Files { get; set; }

    protected void SelectedFilesChanged(IEnumerable<UploadFileInfo> files) {
        Files = files;
    }
    void OnUploadButtonClick() {
        if (Files != null)
            MyFileInput.UploadFile(Files.First());
    }
    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);
        }
    }
}
See Also