Getting Started

The following section is briefly explain the things to get started with FileExplorer control.

A new ASP Web Application and required assemblies with dependent files

To get start with ASP.NET Web EJ FileExplorer, create a new ASP Web Application and add the required assemblies in references and then refer the below specified dependent CSS file as well as scripts

To create an ASP Web Project and add necessary assemblies you can use the help of the given ASP Web-Getting Started documentation.

Adding the references

To include the control in the application the following references need to be added:

  • CSS references

  • Script references

CSS file

NOTE

Essential JS widgets having the support for 13 built-in themes, to know more please check here

Script references

The external script dependencies of the FileExplorer widget are,

And the internal script dependencies of the FileExplorer widget are:

File Description/Usage
ej.core.min.js

Must be referred always before using all the JS controls.

ej.data.min.js

Used to handle data operation and should be used while binding data to JS controls.

ej.touch.min.js Used to handle touch operations
ej. draggable.min.js Used to handle the drag and drop functionality

ej.scroller.min.js

Used to show the scrollbar in the layout area

ej.button.min.js

Used to display the buttons in the toolbar

ej.checkbox.min.js Used to display the checkbox in files items
ej.splitbutton.min.js Used to display the split buttons in the toolbar

ej.treeview.min.js

Used to display the “TreeView” in the navigation pane

ej.uploadbox.min.js

Used to perform the upload functionality 

ej.waitingpopup.min.js

Used to showcase the waiting popup

ej.dialog.min.js

Used to create the alert windows 

ej.splitter.min.js

Used as the body section to separate the navigation and layout area

ej.toolbar.min.js

Used to showcase the hearer section

ej.menu.min.js

Used to showcase the context menu

ej.grid.min.js

Used to showcase the grid layout view

ej.fileexplorer.min.js FileExplorer plugin
ej.globalize.min.js Used to working with different localization culture formats

You can use the “ej.web.all.min.js” file, which encapsulates all the EJ Web controls and frameworks in one single file

NOTE

To add required assembly references, scripts and CSS files automatically into your application, please refer following link http://help.syncfusion.com/aspnet/getting-started#configuring-syncfusion-nuget-packages-in-visual-studio

Create your FileExplorer

In the view page, add FileExplorer element as shown below.

  • html
  • <ej:FileExplorer
                ID="fileexplorer"
                runat="server"
                AjaxAction="DefaultFunctionalities.aspx/FileActionDefault"
                Path="~/FileBrowser/">
                <AjaxSettings>
                    <Download Url="downloadFile.ashx{0}" />
                    <Upload Url="uploadFiles.ashx{0}" />
                </AjaxSettings>
            </ej:FileExplorer>

    In above code block, “Path” denotes the URL of filesystem that are to be explored in “FileExplorer” and “AjaxAction” specifies the URL of server side AJAX handling method that handles the file operations of FileExplorer control. So “Path” and “AjaxAction” are the mandatory configuration at here along with that you have to specify handler file names in “AjaxSettings” API to perform “download” and “upload” operation.

    Add the following code example to the corresponding code behind page.

  • c#
  • [System.Web.Services.WebMethod]
                public static object FileActionDefault(string ActionType, string Path, string ExtensionsAllow, string LocationFrom, string LocationTo, string Name, string[] Names, string NewName, string Action, bool CaseSensitive, string SearchString, IEnumerable<CommonFileDetails> CommonFiles)
                {
                    FileExplorerOperations operation = new FileExplorerOperations();
                    switch (ActionType)
                    {
                        case "Read":
                            return (operation.Read(Path, ExtensionsAllow));
                        case "CreateFolder":
                            return (operation.CreateFolder(Path, Name));
                        case "Paste":
                            operation.Paste(LocationFrom, LocationTo, Names, Action, CommonFiles);
                            break;
                        case "Remove":
                            operation.Remove(Names, Path);
                            break;
                        case "Rename":
                            operation.Rename(Path, Name, NewName, CommonFiles);
                            break;
                        case "GetDetails":
                            return (operation.GetDetails(Path, Names));
                        case "Search":
                            return (operation.Search(Path, ExtensionsAllow, SearchString, CaseSensitive));
                    }
                    return "";
                }

    For handling upload and download operations in FileExplorer, you have to create two handler files (“downloadFile.ashx” and “uploadFiles.ashx”) and include the following code blocks on it.

    Include following code block in “downloadFile.ashx.cs” file.

  • c#
  • /// <summary>
            /// Summary description for downloadFile
            /// </summary>
            public class downloadFile : IHttpHandler
            {
        
                public void ProcessRequest(HttpContext context)
                {
                    HttpRequest request = context.Request;
                    string path= request.QueryString["Path"];
                    string[] names = request.QueryString.GetValues("Names");
                    FileExplorerOperations operation = new FileExplorerOperations();
                    operation.Download(path, names);                        
                }
                
                public bool IsReusable
                {
                    get
                    {
                        return false;
                    }
                }
            }

    Include following code block in “uploadFiles.ashx.cs” file

  • c#
  • /// <summary>
            /// Summary description for uploadFiles
            /// </summary>
            public class uploadFiles : IHttpHandler
            {
        
                public void ProcessRequest(HttpContext context)
                {
                    HttpRequest request = context.Request;
                    string targetFolder = HttpContext.Current.Server.MapPath(request.QueryString["Path"]);
                    if (!Directory.Exists(targetFolder))
                    {
                        Directory.CreateDirectory(targetFolder);
                    }
                    HttpFileCollection uploadedFiles = request.Files;
                    if (uploadedFiles != null && uploadedFiles.Count > 0)
                    {
                        for (int i = 0; i < uploadedFiles.Count; i++)
                        {
                            string fileName = uploadedFiles[i].FileName;
                            int index = fileName.LastIndexOf("\\");
                            if (index > -1)
                            {
                                fileName = fileName.Substring(index + 1);
                            }
                            uploadedFiles[i].SaveAs(targetFolder + "\\" + fileName);
                        }
                    }           
                }
                public bool IsReusable
                {
                    get
                    {
                        return false;
                    }
                }
            }

    Once you have completed the above steps, you will get an output like below.

    NOTE

    In the section, you can know the details about file handling operations, which are performed at server side of “FileExplorer”.