ASPxClientUploadControlValidationErrorOccurredEventArgs.showAlert Property
Gets or sets a value specifying whether an alert message is displayed when the ASPxClientUploadControl.ValidationErrorOccurred event fires.
Declaration
showAlert: boolean
Property Value
Type | Description |
---|---|
boolean |
|
Remarks
Set the showAlert property to false
to use a custom window (for example, a popup window) instead of the alert message box to show an error message.
Example
The following example illustrates how to use the ASPxClientUploadControl.ValidationErrorOccurred event to customize an error message for files that didn’t pass validation.
function onUploadControlValidationErrorOccured(s, e) {
e.showAlert = false;
var errorHtmlContentTemplate = "<div class=\"error-attention\">Attention!</div><br />" +
"{0} files are invalid and will not be uploaded.<br /><br /> {1}" +
"All files listed above have been removed from the selection.";
var preparedErrorHtmlContent = errorHtmlContentTemplate
.replace("{0}", e.invalidFiles.length)
.replace("{1}", getDetailsErrorInfoHtml(e));
popupControl.SetContentHtml(preparedErrorHtmlContent);
popupControl.Show();
}
function getDetailsErrorInfoHtml(e) {
var html = "";
html += getDetailsErrorInfoHtmlByErrorType(e, ASPxClientUploadControlValidationErrorTypeConsts.MaxFileCountExceeded,
"These files exceed the allowed file count (the maximum file count is {0}):<br /><ul>{1}</ul><br />",
e.validationSettings.maxFileCount);
html += getDetailsErrorInfoHtmlByErrorType(e, ASPxClientUploadControlValidationErrorTypeConsts.MaxFileSizeExceeded,
"These files exceed the allowed file size (the maximum file size is {0} bytes):<br /><ul>{1}</ul><br />",
e.validationSettings.maxFileSize, true);
html += getDetailsErrorInfoHtmlByErrorType(e, ASPxClientUploadControlValidationErrorTypeConsts.NotAllowedFileExtension,
"Extensions of these files are not allowed (valid extensions are - {0}):<br /><ul>{1}</ul><br />",
e.validationSettings.allowedFileExtensions.join(', '));
html += getDetailsErrorInfoHtmlByErrorType(e, ASPxClientUploadControlValidationErrorTypeConsts.FileNameContainInvalidCharacter,
"Names of this files contain invalid characters ({0}):<br /><ul>{1}</ul><br />",
e.validationSettings.invalidFileNameCharacters.join(","));
return html;
}
function getDetailsErrorInfoHtmlByErrorType(e, errorType, message, commonInfo, isFileSize) {
var filesInfo = getFilesInfoByErrorType(e.invalidFiles, errorType);
if (filesInfo.length == 0)
return "";
var filesHtml = "";
for (var i = 0, len = filesInfo.length; i < len; i++) {
var f = filesInfo[i];
var fileText = isFileSize ? f.fileName + " - " + f.fileSize + " bytes" : f.fileName;
filesHtml += "<li class=\"error-file\">" + fileText + "</li>";
}
return "<div class=\"error-detail\">" + message.replace("{0}", commonInfo).replace("{1}", filesHtml) + "</div>";
}
function getFilesInfoByErrorType(invalidFiles, errorType) {
var filesInfo = [];
for (var i = 0, len = invalidFiles.length; i < len; i++) {
var fileInfo = invalidFiles[i];
if (fileInfo.errorType == errorType)
filesInfo.push(fileInfo);
}
return filesInfo;
}
See Also