Getting Started

28 Jun 201714 minutes to read

This section explains briefly about how to create an Uploadbox in your application with JavaScript. Essential JavaScript Uploadbox widget provides support to upload files or photos within your web page. From the following guidelines, you can learn how to upload the files that are used in a Resume Upload scenario. This helps you to restrict some file extensions when you upload the resume in server by using Uploadbox control.

The following screenshot demonstrates the functionality of Uploadbox with the file extension.

In the above screenshot, you can upload a resume that allows .txt file extension. This helps you to avoid unsupported resume formats getting uploaded in a server.

NOTE

To get upload the file, you should either run this sample in Visual Studio IDE or host in local IIS.

Create Uploadbox widgets

Essential JavaScript Uploadbox widget basically renders built-in features like upload multiple files, and deletes the files from Uploadbox. You can know the status of uploading the file whether it is completed or failed and you can retry uploading the files. You can easily create the Uploadbox widget by using the following steps.

Create an HTML file and add the following template to the HTML file.

  • HTML
  • <!DOCTYPE html>
        <html ng-app="UploadApp">
        <head>
        <meta name="viewport" content="width=device-width, initial-scale=1.0" charset="utf-8" />
        <!-- Style sheet for default theme (flat azure) -->
        <link href="http://cdn.syncfusion.com/24.2.3/js/web/flat-azure/ej.web.all.min.css" rel="stylesheet" />
        <!--Scripts-->
        <script src="http://cdn.syncfusion.com/js/assets/external/jquery-2.1.4.min.js"></script>
        <script src="http://cdn.syncfusion.com/js/assets/external/jquery.easing.1.3.min.js"> </script>
    	<script src="http://cdn.syncfusion.com/js/assets/external/angular.min.js"></script>
        <script src="http://cdn.syncfusion.com/24.2.3/js/web/ej.web.all.min.js"></script>
    	<script src="http://cdn.syncfusion.com/24.2.3/js/common/ej.widget.angular.min.js"></script>
        <!--Add custom scripts here -->
        </head>
         <body ng-controller="UploadCtrl">
        <!-- add necessary HTML elements here -->
        </body>
        </html>

    The ng-app directive explains the root element (<html> or <body> tags) of the application. You will assign a name to the ng-app directive, then you must create a module with that name. In this module, you have to define your directives, services, filters and configurations.

    A controller is defined using ng-controller directive. Each controller accepts an object $scope which we pass as a parameter. This object is used to bind the controller with view.

    Properties can be bind to ejUploadbox control using the prefix e- and particular property name.

    Add input element to render a Uploadbox.

  • HTML
  • <div class="targetElement">Select a file to upload </div>
            <div id="UploadDefault" ej-uploadbox e-saveurl="saveurl" e-removeurl="removeurl" ></div>

    Add the given styles to display the Uploadbox with margin alignments.

  • CSS
  • <style>
         #targetElement {
            width: 500px;
            height: 500px;
            margin: 0 auto;
            }
    
         #UploadDefault {
            margin: 0 auto;
           }
       </style>

    Create a new handler file (.ashx) and save it as saveFiles.ashx and then copy the following code into it.

  • C#
  • SaveFiles.ashx
    
        public void ProcessRequest(HttpContext context)
        {
            string targetFolder = HttpContext.Current.Server.MapPath("uploadfiles");
            if (!Directory.Exists(targetFolder))
            {
                Directory.CreateDirectory(targetFolder);
            }
            HttpRequest request = context.Request;
            HttpFileCollection uploadedFiles = context.Request.Files;
            if (uploadedFiles != null && uploadedFiles.Count > 0)
            {
                for (int i = 0; i < uploadedFiles.Count; i++)
                {
                    if (uploadedFiles[i].FileName != null && uploadedFiles[i].FileName != "")
                    {
                        string fileName = uploadedFiles[i].FileName;
                        int indx = fileName.LastIndexOf("\\");
                        if (indx > -1)
                        {
                            fileName = fileName.Substring(indx + 1);
                        }
                        uploadedFiles[i].SaveAs(targetFolder + "\\" + fileName);
                    }
                }
            }
        }

    Create a new handler file (.ashx) and save it as removeFiles.ashx and then copy the following code into it.

  • C#
  • removeFiles.ashx
    
        public void ProcessRequest(HttpContext context)
        {
            System.Collections.Specialized.NameValueCollection s = context.Request.Params;
            string fileName = s["fileNames"];
            string targetFolder = HttpContext.Current.Server.MapPath("uploadfiles");
            if (Directory.Exists(targetFolder))
            {
                string physicalPath = targetFolder + "\\" + fileName;
                if (System.IO.File.Exists(physicalPath))
                {
                    System.IO.File.Delete(physicalPath);
                }
            }
        }

    Initialize the script for Uploadbox.

  • JS
  • angular.module('UploadApp', ['ejangular']).controller('UploadCtrl', function ($scope) {
    	
    	$scope.saveurl="saveFiles.ashx";
    	$scope.removeurl = "removeFiles.ashx";
    	});

    The following screenshot displays an Uploadbox control.

    After you upload the files, the following screen shot is displayed.

    NOTE

    The above screenshot displays the Uploadbox control that shows the files are uploaded successfully.

    Set Restriction for File Extension

    In a real-time scenario, some file extensions are restricted. You can allow files and restrict files by using the following two properties extensionsAllow and extensionsDeny enabled in Uploadbox.

    NOTE

    The SaveUrl and RemoveUrl are the same as above (see step 4)

    Add input elements to create elements for file extension.

    NOTE

    Add the following input elements and two button elements to give file extensions that should support uploading.

  • HTML
  • <div id="targetElement">
                <table id="uploadTable">
                    <tr>
                        <td>
                            Extensions:
                        </td>
                        <td></td>
                    </tr>
                    <tr>
                        <td>
                            <input type="text" id="fileallow" class="ejinputtext" placeholder="Format" />
                            <button id="button21" class="ang-button btn" ej-button e-showroundedcorner="true" e-size="normal" e-text="Allow" e-click="allowfiletype"></button>
                        </td>
                        <td></td>
                    </tr>
                    <tr>
                        <td>
                            <input type="text" id="filedeny" class="ejinputtext" placeholder="Format" />
                            <button id="button22" class="ang-button btn" ej-button e-showroundedcorner="true" e-size="normal" e-text="Deny" e-click="denyfiletype"></button>
                        </td>
                        <td>
                            <div id="UploadDefault"></div>
                        </td>
                    </tr>
                </table>
              </div>

    Add the following code example in script section.

  • JS
  • angular.module('UploadApp', ['ejangular']).controller('UploadCtrl', function ($scope) {
    	
    	  $scope.saveurl="saveFiles.ashx";
    	  $scope.removeurl = "removeFiles.ashx";
    	
    	  $scope.allowfiletype=function()
    	     {
    	    uploadobject = $("#UploadDefault").data("ejUploadbox");
    	    uploadobject.option('extensionsAllow', $("#fileallow").val());
    	    uploadobject.option('extensionsDeny', "");
             }
          $scope.denyfiletype = function ()
    	  {
    	    uploadobject = $("#UploadDefault").data("ejUploadbox");
    	    uploadobject.option('extensionsAllow', "");
    	    uploadobject.option('extensionsDeny', $("#filedeny").val());
           }
         });

    Add the given styles to display the Uploadbox with margin alignments.

  • CSS
  • <style>
          #targetElement {
            width: 520px;
            height: 500px;
            margin: 0 auto;
           }
         #UploadDefault {
            float: right;
          } 
         #uploadTable {
            width: 100%;
         }
         #fileallow, #filedeny {
            width: 150px;
            height: 20px;
            padding: 5px;
         }
        </style>

    NOTE

    You can restrict one or more files at a time by giving it as .html,.txt

    The following screenshot displays an Uploadbox control with the file extension.

    The above screenshot shows the Uploadbox that allows “.txt” files.You can give the number file formats in both allow and deny textbox elements.

    Upload Multiple Files

    You can click the Browse button and select the files to upload multiple files in Uploadbox control. You can see the selected files in Uploadbox control and you can upload all the files.

    The following screenshot displays an Uploadbox control with multiple files.