Skip to main content

ASPxHtmlEditor.DocumentSelectorFileUploading Event

Fires before a file is uploaded to the Document Selector and allows you to cancel the action.

Namespace: DevExpress.Web.ASPxHtmlEditor

Assembly: DevExpress.Web.ASPxHtmlEditor.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

public event FileManagerFileUploadEventHandler DocumentSelectorFileUploading

Event Data

The DocumentSelectorFileUploading event's data class is FileManagerFileUploadEventArgs. The following properties provide information specific to this event:

Property Description
Cancel Gets or sets a value indicating whether the action that raised the event should be canceled. Inherited from FileManagerActionEventArgsBase.
ErrorText Gets or sets a text for the explanatory message. Inherited from FileManagerActionEventArgsBase.
File Gets a file, related to the event.
FileName Gets or sets the name of a file selected to upload.
InputStream Gets a stream object that points to the uploaded file.
OutputStream Gets a stream object that points to the uploaded file.

Remarks

Prior to each time a file is uploaded to the Document Selector, the DocumentSelectorFileUploading event occurs, allowing you to cancel the file upload. The event parameter’s FileManagerFileUploadEventArgs.File property identifies the file that is being processed. The FileManagerFileUploadEventArgs.InputStream and FileManagerFileUploadEventArgs.OutputStream properties allow you to modify a file, before sending it to the server side. The FileManagerFileUploadEventArgs.FileName property allows you specify a custom name for the file.

To cancel the upload operation, set the FileManagerActionEventArgsBase.Cancel property to true. To show a message explaining the reason for the upload cancellation, specify the FileManagerActionEventArgsBase.ErrorText property.

To customize the Document Selector settings use the HtmlEditorInsertLinkDialogSettings.SettingsDocumentSelector property.

See Also