This event fires when some restriction is broken.

Syntax

ASP.NET

<script type="text/javascript">
function Uploader1_RestrictionFailed(errorCode, fileName, message){
    //...your code...
}
</script>
<aur:Uploader ID="Uploader1" runat="server">
    <ClientEvents>
        <aur:ClientEvent EventName="RestrictionFailed" HandlerName="Uploader1_RestrictionFailed" />
    </ClientEvents>
</aur:Uploader>

PHP

<script type="text/javascript">
function Uploader1_RestrictionFailed(errorCode, fileName, message){
    //...your code...
}
</script>
<?php
    $Uploader = new Uploader("Uploader1");
    //...other params...
    $Uploader->getClientEvents()->setRestrictionFailed("Uploader1_RestrictionFailed");
    //...other params...
    $Uploader->render();
?>

JavaScript

function Uploader1_RestrictionFailed(errorCode, fileName, message){
    //...your code...
}
$au.uploader({
    events: {
        //...other params...
        restrictionFailed: [Uploader1_RestrictionFailed],
        //...other params...
    }
})

Parameters

errorCode

Type: Number

One of the following values:

  • 0 - size of the selected file exceeds the MaxFileSize value;
  • 1 - size of the selected files is less than the MinFileSize value;
  • 2 - the selected image is CMYK, when CMYK images are denied for the upload (i.e. the EnableCmyk is false);
  • 3 - dimensions of the selected image are too large (i.e. image width or height exceeds the MaxImageHeight or MaxImageWidth value);
  • 4 - dimensions of the selected image are too small (i.e. image width or height is less than the MinImageHeight or MinImageWidth value);
  • 5 - the selected file has not allowed name (i.e. filename does not match FileMask, or matches DeniedFileMask);
  • 6 - number of selected files exceeds the MaxFileCount value;
  • 7 - total size of selected files exceeds the MaxTotalFileSize value;
fileName

Type: String

The name of the file which breaks the restriction.

message

Type: String

The message stating that the restriction is broken. The same message is displayed in the information bar.