Introduction
This article is about inserting images into database and displaying them in GridView
through Handler.ashx.
This article explains the method of inserting images and pictures into SQL Server database table and displays it in an ASP.NET GridView
control with the help of Handler.aspx.
To make your task easier, this article explains the methods of storing the images into data source. There are many advantages of saving the images into database. The main advantage is easy management of images. You can control the number and size of images stored in your server. You can remove all unnecessary images from the database in a single SQL query and you can backup the image data easily. On the other hand, you should be generous in keeping sufficient memory store in your database server.
Inserting Image into Database
To start with, let me explain the SQL Server database table structure we are going to use to insert the image. The table you are going to create to store the image must contain a column of data type IMAGE. This image data type is a Variable-length binary data with a maximum length of 2^31 - 1 (2,147,483,647) bytes. To store the image into this column, we are going to convert it into a binary string with the help of some IO classes and then insert into the table. For demonstration, we are going to create a table named ImageGallery
with four columns in the following structure:
Column Name |
Description |
Data Type |
Img_Id |
Identity column for Image Id |
int |
Image_Content |
Store the Image in Binary Format |
image |
Image_Type |
Store the Image format (i.e. JPEG, GIF, PNG, etc.) |
varch ar |
Image_Size |
Store the Image File Size |
bigint |
After we create a table in the database, we can start the coding part.
- Open your web application in Visual Studio 2005, drag and drop File Upload control and a Button control into the web page.
- In the code-behind, add the namespace
System.IO
.
using System.IO;
- In the Button’s
Button1_Click
event, write the following code:
if (FileUpload1.PostedFile != null
&& FileUpload1.PostedFile.FileName != "")
{
byte[] myimage = new byte[FileUpload1.PostedFile.ContentLength];
HttpPostedFile Image = FileUpload1.PostedFile;
Image.InputStream.Read(myimage, 0, (int)FileUpload1.PostedFile.ContentLength);
SqlConnection myConnection = new SqlConnection(“Your Connection String”);
SqlCommand storeimage = new SqlCommand("INSERT INTO ImageGallery "
+"(Image_Content, Image_Type, Image_Size) "
+" values (@image, @imagetype, @imagesize)", myConnection);
storeimage.Parameters.Add("@image", SqlDbType.Image,
myimage.Length).Value = myimage;
storeimage.Parameters.Add("@imagetype", SqlDbType.VarChar, 100).Value
= FileUpload1.PostedFile.ContentType;
storeimage.Parameters.Add("@imagesize", SqlDbType.BigInt, 99999).Value
= FileUpload1.PostedFile.ContentLength;
myConnection.Open();
storeimage.ExecuteNonQuery();
myConnection.Close();
}
To upload the image from any location (your local drive) to the server, you have to use HttpPostedFile
object. Point the uploaded file to HttpPostedFile
object. Then the InputStream.Read
method will read the content of the image by a sequence of bytes from the current stream and advance the position within the stream by the number of bytes it read. So myimage
contains the image as binary data. Now we have to pass this data into the SqlCommand
object, which will insert it into the database table.
Display the Image in a GridView with Handler.ashx
So far, the article explains the way to insert images into the database. The Image
is in the database in binary data format. Retrieving this data in an ASP.NET web page is fairly easy, but displaying it is not as simple. The basic problem is that in order to show an image in an apsx page, you need to add an image tag that links to a separate image file through the src
attribute or you need to put an Image
control in your page and specify the ImageUrl
.
For example:
<asp:Image ID="Image1" runat="server" ImageUrl="YourImageFilePath" />
<SCRIPT src="file:///C:/Documents%20and%20Settings/nagasridhar/Desktop/
Inserting%20Images%20into%20Database%20and%20Display%20it%20in%20GridView%20
through%20Handler_ashx%20-%20Storing%20Images%20in%20SQL%20Server%20DB,
%20Store%20and%20Display%20Image%20Dynamically%20from%20Database_files/show_ads.js"
type=text/javascript> </SCRIPT>
Unfortunately, this approach will not work if you need to show image data dynamically. Although you can set the ImageUrl
attribute in code, you have no way to set the image content programmatically. You could first save the data to an image file on the web server’s hard drive, but that approach would be dramatically slower, waste space, and raise the possibility of concurrency errors if multiple requests are being served at the same time and they are all trying to write the same file.
In these situations, the solution is to use a separate ASP.NET resource that returns the binary data directly from the database. Here HTTP Handler
class comes to center stage.
What is Handler?
An ASP.NET HTTP Handler is a simple class that allows you to process a request and return a response to the browser. Simply we can say that a Handler is responsible for fulfilling requests from the browser. It can handle only one request at a time, which in turn gives high performance. A handler class implements the IHttpHandler
interface.
For this article demonstration, we are going to display the image in the GridView
control along with the data we stored in the table. Here are the steps required to accomplish this:
- Create a Handler.ashx file to perform image retrieval. This Handler.ashx page will contain only one method called
ProcessRequest
. This method will return binary data to the incoming request. In this method, we do normal data retrieval process and return only the Image_Content
field as bytes of array.
The sample code follows:
public void ProcessRequest (HttpContext context)
{
SqlConnection myConnection = new SqlConnection();
myConnection.Open();
string sql = "Select Image_Content from ImageGallery where Img_Id=@ImageId";
SqlCommand cmd = new SqlCommand(sql, myConnection);
cmd.Parameters.Add("@ImageId", SqlDbType.Int).Value =
context.Request.QueryString["id"];
cmd.Prepare();
SqlDataReader dr = cmd.ExecuteReader();
dr.Read();
context.Response.ContentType = dr["Image_Type"].ToString();
context.Response.BinaryWrite((byte[])dr["Image_Content"]);
}
- Place a GridView control in your aspx page, with one
TemplateField
column, add an Image
control into the TemplateField
's ItemTemplate
section. Specify the ImageUrl
property as:
<asp:TemplateField>
<ItemTemplate>
<asp:Image ID="Image1" runat="server" ImageUrl='<%# "Handler.ashx?id=" + Eval(
"Img_Id") %>' />
</ItemTemplate>
</asp:TemplateField>
<SCRIPT src="file:///C:/Documents%20and%20Settings/nagasridhar/Desktop/
Inserting%20Images%20into%20Database%20and%20Display%20it%20in%20GridView%20
through%20Handler_ashx%20-%20Storing%20Images%20in%20SQL%20Server%20DB,
%20Store%20and%20Display%20Image%20Dynamically%20from%20Database_files/
show_ads.js"
type=text/javascript> </SCRIPT>
- Now we can bind the
GridView
control to display all the records in the table as follows:
GridView1.DataSource = FetchAllImagesInfo();
GridView1.DataBind();
Before you bind the GridView
, you should write the FetchAllImagesInfo
method to return all the records with their image data from the table and then you have to load the images into the GridView
control. The code for FetchAllImagesInfo
is:
public DataTable FetchAllImagesInfo())
{
string sql = "Select * from ImageGallery";
SqlDataAdapter da = new SqlDataAdapter(sql, "Your Connection String");
DataTable dt = new DataTable();
da.Fill(dt);
return dt;
}