Class

TelerikUpload

Declaration

public TelerikUpload()

Automatically uploads files after selection when set to true (default). Set to false to require a manual upload button click. Example: false.

Declaration

[Parameter]
public bool AutoUpload { get; set; }

Property Value

Preloads a list of files into the Upload component on initialization. Example: bind to a list of UploadFileInfo. Useful for displaying previously uploaded files.

Declaration

[Parameter]
public IEnumerable<UploadFileInfo> Files { get; set; }

Property Value

Fires when a user clicks Cancel on a file that is uploading. Use to stop upload and update UI. Example: cancel upload of large file.

Declaration

[Parameter]
public EventCallback<UploadCancelEventArgs> OnCancel { get; set; }

Property Value

Fires when the Clear button is clicked. Use to reset the file list or clear UI. Example: remove all files from the list.

Declaration

[Parameter]
public EventCallback<UploadClearEventArgs> OnClear { get; set; }

Property Value

Fires when an upload or remove request fails. Use to display error messages or retry logic. Example: show error notification if server returns 500.

Declaration

[Parameter]
public EventCallback<UploadErrorEventArgs> OnError { get; set; }

Property Value

Fires when the Pause button is clicked. Use to pause chunked uploads. Only available when chunk upload and Resumable are enabled.

Declaration

[Parameter]
public EventCallback<UploadPauseEventArgs> OnPause { get; set; }

Property Value

Fires when upload progress changes. Use to update progress bars or UI. Example: show "Uploading 50%".

Declaration

[Parameter]
public EventCallback<UploadProgressEventArgs> OnProgress { get; set; }

Property Value

Fires when a user clicks Remove (X) on a file. Use to handle file deletion logic. Example: remove file from server or update UI. See OnError for failure handling.

Declaration

[Parameter]
public EventCallback<UploadEventArgs> OnRemove { get; set; }

Property Value

Fires when the Resume button is clicked. Use to resume paused chunked uploads. Only available when chunk upload and Resumable are enabled.

Declaration

[Parameter]
public EventCallback<UploadResumeEventArgs> OnResume { get; set; }

Property Value

Fires when users select new files for upload. Use to validate or filter files before upload. Example: check file type or size. See OnUpload for upload logic.

Declaration

[Parameter]
public EventCallback<UploadSelectEventArgs> OnSelect { get; set; }

Property Value

Fires when an upload or remove request succeeds. Use to update UI or notify users. Example: show "Upload complete" message.

Declaration

[Parameter]
public EventCallback<UploadSuccessEventArgs> OnSuccess { get; set; }

Property Value

Fires before uploading files. Use to add custom headers or cancel upload. Example: set args.IsCancelled = true to prevent upload. Fires after OnSelect unless AutoUpload is false.

Declaration

[Parameter]
public EventCallback<UploadEventArgs> OnUpload { get; set; }

Property Value

Declaration

public string PopupId { get; }

Property Value

Sets the FormData key for file names sent to RemoveUrl. Example: "files". Change if your server expects a different key.

Declaration

[Parameter]
public string RemoveField { get; set; }

Property Value

Sets the URL endpoint for removing uploaded files. Example: "https://myserver.com/remove". Must be configured for file deletion to work. See SaveUrl for upload endpoint.

Declaration

[Parameter]
public string RemoveUrl { get; set; }

Property Value

Sets the FormData key for uploaded files sent to SaveUrl. Example: "files". Change if your server expects a different key.

Declaration

[Parameter]
public string SaveField { get; set; }

Property Value

Sets the URL endpoint that receives uploaded files. Example: "https://myserver.com/upload". Required for file uploads to work. See RemoveUrl for file removal.

Declaration

[Parameter]
public string SaveUrl { get; set; }

Property Value

Configures advanced upload settings, such as chunk upload. Use UploadChunkSettings as a child component. Example: .

Declaration

[Parameter]
public RenderFragment UploadSettings { get; set; }

Property Value

Enables sending credentials (cookies, headers) with cross-site requests. Set to true if your upload endpoint requires authentication. Example: true.

Declaration

[Parameter]
public bool WithCredentials { get; set; }

Property Value

Declaration

protected override void BuildRenderTree(RenderTreeBuilder __builder)

Parameters

Overrides ComponentBase.BuildRenderTree(RenderTreeBuilder)

Cancels the upload of the specified file and removes it from the collection.

Declaration

public void CancelFile(string fileId)

Parameters

Declaration

protected override void OnInitialized()

Overrides ComponentBase.OnInitialized()

Pauses the upload of the file with the specified identifier, if it exists in the current collection.

Declaration

public void PauseFile(string fileId)

Parameters

Removes the file with the specified identifier from the collection.

Declaration

public void RemoveFile(string fileId)

Parameters

Resumes the upload process for the specified file.

Declaration

public void ResumeFile(string fileId)

Parameters

Attempts to retry the upload of a file with the specified identifier.

Declaration

public void RetryFile(string fileId)

Parameters

Uploads all valid files.

Declaration

public void UploadFiles()