Skip to main content

FileUpload in AJAX-enabled web applications


I would like to note that this article is not about the ability to upload files to the server without the postback. There are a lot of articles on this topic, just type "AJAX FileUpload" in any search engine and you'll get many examples. However with AJAX they actually have little in common, because the XMLHttpRequest does not support asynchronous uploading of files to the server, they are rather a variety of imitations, for example, using hidden IFRAME element. Nevertheless I want to emphasize that the article is not about that but about the standard FileUpload control.
There are two problems you might encounter when using it on UpdatePanel.
Problem 1
If the postback is caused by a control which lies on the UpdatePanel, the FileUpload is always empty when it come to the server, regardless whether a file has been selected or not.
Example:
<asp:UpdatePanel ID="UpdatePanel1" runat=server>
  <ContentTemplate>
     <asp:FileUpload ID="FileUpload1" runat=server />
     <asp:Button ID="btnUpload" runat=server Text="Upload" OnClick="btnUpload_Click"/>
  </ContentTemplate>
</asp:UpdatePanel>
Solution
As XMLHttpRequest does not allow to send files asynchronously, they have to be submitted in a common manner. This problem is well described around, it is solved by registration of the control that has to submit the form as a postback trigger (in the above example it is btnUpload button).
<asp:UpdatePanel ID="UpdatePanel1" runat=server>
  <ContentTemplate>
     <asp:FileUpload ID="FileUpload1" runat=server />
     <asp:Button ID="btnUpload" runat=server Text="Upload 2" OnClick="btnUpload_Click"/>
  </ContentTemplate>
  <Triggers>
      <asp:PostBackTrigger ControlID="btnUpload" />
  </Triggers>
</asp:UpdatePanel>

Problem 2
FileUpload does not work if it is loaded not on the initial page load but appears only after asynchronous update of the page part.
Example (pnlUpload panel is invisible in the beginning and is shown after clicking on btnShowFileUpload button):
<asp:UpdatePanel ID="UpdatePanel1" runat=server>
   <ContentTemplate>
        <asp:Button ID="btnShowFileUpload" runat=server Text="Show File Upload" OnClick="btnShowFileUpload_Click"/>
        <asp:Panel ID="pnlUpload" runat=server Visible="False">
           <asp:FileUpload ID="FileUpload1" runat=server />
           <asp:Button ID="btnUpload" runat=server Text="Upload" OnClick="btnUpload_Click"/>
       </asp:Panel>
   </ContentTemplate>
   <Triggers>
        <asp:PostBackTrigger ControlID="btnUpload" />
   </Triggers>
</asp:UpdatePanel>

.......................

protected void btnShowFileUpload_Click(object sender, EventArgs e)
{
    pnlUpload.Visible = true;
}
Solution
The problem is caused by the requirement that for the normal work of FileUpload the form should have enctype="multipart/form-data". Usually, it is set in overriden OnPreRender method of FileUpload control.
protected internal override void OnPreRender(EventArgs e)
{
    base.OnPreRender(e);
    HtmlForm form = this.Page.Form;
    if ((form != null) && (form.Enctype.Length == 0))
    {
        form.Enctype = "multipart/form-data";
    }
}
Although during asynchronous postback this code is also executed but the form is not updated. That is why it is required to set the form content type explicitly during the first page load, for example, in the Page_Load event handler of the page or a control where FileUpload is placed.
protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
        this.Page.Form.Enctype = "multipart/form-data";
}
In case if this task is repeated in a few places you may do a simple control derived from FileUpload with overriden OnLoad method and use it.
public class CustomFileUpload : FileUpload
{
 protected override void OnLoad(EventArgs e)
 {
     base.OnLoad(e);

     if (!Page.IsPostBack)
         this.Page.Form.Enctype = "multipart/form-data";
 }
}

Comments

Popular posts from this blog

JQuery lightbox image slideshow gallery in asp.net

Introduction: In this article I will explain how to create lightbox image slideshow in asp.net using JQuery. Description:  In previous post I explained about  Ajax SlideshowExtender sample  to display images slideshow. Now in this article I will explain how to create lightbox image slideshow in asp.net using JQuery. In many websites generally we will see different types of slideshows like whenever we click on image that is automatically open with lightbox effect and we have a chance to see all the remaining images by press next or previous options in slideshow. All these Slideshows are implemented by using JQuery plugins. After seen those slideshows I decided to write post to use JQuery plugins to implement beautiful slideshown in asp.net.  To implement this one I am using  previous post  insert and display images from folder based on imagepath in database  because in that post I explained clearly how to insert images into our project folder a...

Scrollable GridView with Fixed Headers using jQuery Plugin

Using the same example I have created a jQuery Plugin for Scrollable GridView with Fixed header so that you can directly make a GridView scrollable.   HTML Markup < form   id ="form1"   runat ="server"> < asp : GridView   ID ="GridView1"   runat ="server"   AutoGenerateColumns   =   "false"> < Columns > < asp : BoundField   DataField   =   "ContactName"   HeaderText   =   "Contact Name"   /> < asp : BoundField   DataField   =   "City"   HeaderText   =   "City"   /> < asp : BoundField   DataField   =   "Country"   HeaderText   =   "Country"   /> Columns > asp : GridView > form >   Applying the Scrollable Grid jQuery Plugin < script   src ="Scripts/jquery-1.4.1.min.js"   type ="text/javascript"> script > < script   src ="Scripts/Scro...

Generics

Generics allow us to have type or method which can operate on objects of various types, while providing type safety at the compile time. That means if you define generics class object of type Integer & you are trying to add different type of variable to generic class like String then it will give compile time error. In another sense, if we try to add different types in same list like string and int in a same list then compile time error will be thrown. Generics are available under the namespace System. Collections .Generic. The concept of type parameters is introduce to the .NET Framework with the help of Generics, which makes it possible to design classes & methods which defer the specification of one or more types until that class or method is declared and instantiated by the client code. public class MyGenericClass { void Add(T val) { } ...