程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> .NET網頁編程 >> ASP.NET >> ASP.NET基礎 >> 在ASP.NET 2.0中操作數據之五十三:在Data Web控件顯示二進制數據

在ASP.NET 2.0中操作數據之五十三:在Data Web控件顯示二進制數據

編輯:ASP.NET基礎

導言:

  在前面的教程我們闡述了應用程序處理二進制數據的2種模式,以及使用FileUpload 控件從浏覽器向服務器文件系統上傳文件。當文件上傳並存儲在文件系統裡時,應在相應的數據庫記錄裡存儲該文件的存儲路徑。

  我們先來看如何為最終用戶提供二進制數據。怎樣展示二進制數據呢?這取決於其類型。比如圖片,我們將其顯示為image;如果是PDFs,Microsoft Word文檔、ZIP文件或其它類型的數據,或許提供一個“Download”鏈接比較妥當。

  在本節,我們看如何在GridView和DetailsView一類的數據Web控件裡呈現二進制數據,在後面的教程我們將注意力轉向將上傳文件和數據庫聯系起來。

第一步:提供BrochurePath值

  表Categories的Picture列存儲相關類的圖片信息。具體的講,為16色的低質量位圖,大小為172乘120像素,約11 KB。另外還包括一個約78字節的OLE報頭,在顯示圖片的時候需要將其剝離。為什麼會有報頭信息呢?因為數據庫Northwind源於微軟的Access數據庫。在Access裡二進制數據OLE類型來存儲的,該類型會添加報頭。現在,我們看如何從圖片剝離報頭,以便顯示。在後面的教程我們將創建一個界面,將帶報頭的這些位圖替換為不帶報頭的等價的JPG圖片。

  前面我們考察了如何使用FileUpload控件,讓我們繼續為服務器文件系統添加文件。不過暫時不用更新Categories表的BrochurePath列,那是下一章的內容。我們現在需要手工為BrochurePath賦值。

  在本教程,當你下載東西時,可以看到在~/Brochures7文件夾有7個PDF小冊子,每個小冊子對應一個種類,Seafood除外。我故意沒為Seafood提供PDF小冊子,以便探討如何處理某些記錄沒有附帶二進制數據的情況。在服務器資源管理器裡右鍵點擊Categories,選“查看表數據”,輸入文件路徑,如圖1所示。由於Seafood類沒有圖片,將其BrochurePath的值設為“NULL”。 

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916434861.gif
圖1:手工為表Categories的BrochurePath列鍵入值

第2步:在GridView裡添加一個下載鏈接

  當為表Categories的BrochurePath列賦值後,我們准備創建一個GridView用於展示每個種類,並附帶一個鏈接下載每個類的小冊子。在第4步我們將擴展GridView以顯示每個類的圖片。

  打開BinaryData文件夾的DisplayOrDownloadData.aspx頁面並進入設計模式,從工具箱裡拖一個GridView控件到頁面,設其ID為Categories,從其智能標簽選擇綁定到一個名為CategoriesDataSource的ObjectDataSource控件。該控件調用類CategoriesBLL的GetCategories()方法。

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916434822.gif
圖2:創建一個名為CategoriesDataSource的ObjectDataSource控件

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916434931.gif
圖3:設置ObjectDataSource使用CategoriesBLL類

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916434974.gif
圖4:調用GetCategories()方法

  完成設置後,Visual Studio自動的為CategoryID, CategoryName, Description, NumberOfProducts和BrochurePath生成BoundField。移除NumberOfProducts,因為GetCategories()方法用不上,同樣將CategoryID移除了。分別把CategoryName和 BrochurePath的HeaderText屬性改為“Category”和“Brochure”。做上述修改後,你的GridView and ObjectDataSource的聲明代碼看起來應該像下面的這樣:

<asp:GridView ID="Categories" runat="server"
 AutoGenerateColumns="False" DataKeyNames="CategoryID"
 DataSourceID="CategoriesDataSource" EnableViewState="False">
 <Columns>
 <asp:BoundField DataField="CategoryName" HeaderText="Category"
  SortExpression="CategoryName" />
 <asp:BoundField DataField="Description" HeaderText="Description"
  SortExpression="Description" />
 <asp:BoundField DataField="BrochurePath" HeaderText="Brochure"
  SortExpression="BrochurePath" />
 </Columns>
</asp:GridView>

<asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
 OldValuesParameterFormatString="original_{0}"
 SelectMethod="GetCategories" TypeName="CategoriesBLL">
</asp:ObjectDataSource>

  在浏覽器查看該頁(如圖5)。列出了所有的8個類,除了Seafood,其它7個類的BoundField列裡顯示各自的BrochurePath值。由於Seafood的BrochurePath為NULL值,看起來為空格。

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916434937.gif
圖5:顯示了每個類別的Name, Description和BrochurePath值

  與其顯示BrochurePath的text值,不如創建一個指向小冊子的鏈接。移除BrochurePath,代之以HyperLinkField。設它的HeaderText屬性為“Brochure”,Text屬性為“View Brochure”, DataNavigateUrlFields屬性為“ BrochurePath”。

 

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435042.gif
圖6:添加一個指向BrochurePath的HyperLinkField

  這樣將在GridView裡添加一列鏈接,如圖7所示。點“View Brochure”時要麼直接在浏覽器顯示PDF,要麼提示用戶下載該文件。這取決於浏覽器的設置以及是否安裝了PDF閱讀器。

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435057.gif
圖7:點擊“View Brochure”訪問某類的Brochure

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435038.gif
圖8:顯示某類的PDF文件

隱藏無小冊子圖片的類的“View Brochure” 文本

  如圖7所示,不管某個類的BrochurePath是否為NULL值,名為BrochurePath的HyperLinkField都呈現為其Text屬性(“View Brochure”) 。當然,如果BrochurePath為NULL值,鏈接只顯示為文本(而不帶下劃線),就像Seafood類一樣(見圖7)。與顯示文本“View Brochure”相比,更為可取的是將那些BrochurePath值為空的類顯示為“No Brochure Available”。

  為達此目的,我們需要用到TemplateField,使其產生一個基於BrochurePath值的合適的結果。我們先來看看如何實現,就像在教程之12《在GridView控件中使用TemplateField》一樣。

  在“編輯列”對話框裡選中名為BrochurePath的HyperLinkField,再點“Convert this field into a TemplateField”鏈接,將其轉換為TemplateField。 

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435109.gif
圖9:將HyperLinkField轉換為TemplateField

  這樣將創建一個TemplateField,其ItemTemplate模板包含一個HyperLink Web控件,該控件的NavigateUrl屬性為BrochurePath值。用下面的代碼將其替換掉:

<asp:TemplateField HeaderText="Brochure">
 <ItemTemplate>
 <%# GenerateBrochureLink(Eval("BrochurePath")) %>
 </ItemTemplate>
</asp:TemplateField>

  然後,在ASP.NET頁面的“後台代碼”裡添加一個protected類型的GenerateBrochureLink方法,它接受一個輸入參數並返回一個字符串。

protected string GenerateBrochureLink(object BrochurePath)
{
 if (Convert.IsDBNull(BrochurePath))
 return "No Brochure Available";
 else
 return string.Format(@"<a href=""{0}"">View Brochure</a>",
  ResolveUrl(BrochurePath.ToString()));
}

  該方法判斷傳入的值是否為NULL。如果是,則返回一個消息指出該類沒有小冊子文件;相反,如果傳入值不為空,將顯示為一個鏈接。我們注意到,當BrochurePath值不為空時,將調用ResolveUrl(url)方法。該方法的作用在於將傳入的相對路徑轉換為物理路徑。比如應用程序的根目錄在/Tutorial55,ResolveUrl("~/Brochures/Meats.pdf")返回的路徑是/Tutorial55/Brochures/Meat.pdf.

圖10為經過上述修改後的界面。我們注意到Seafood類的BrochurePath列現在顯示為文本“No Brochure Available”.

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435131.gif
圖10:沒有小冊子的類將顯示為文本“No Brochure Available”

第3步:新增頁面以顯示類的圖片

  當用戶訪問一個ASP.NET頁面時,他將接收該頁面的HTML代碼。HTML代碼僅僅包含了text文本,而並不包含任何的二進制數據。任何的二進制數據,比如圖片,音樂文件、Flash程序、Windows Media Player視頻等,以獨立資源的形式存放於服務器。

  HTML只包含了這些文件的引用,並不包含這些文件本身。

  比如,在HTML裡<img>元素用來引用一張圖片,其src屬性指向該圖片文件,如:
<img src="MyPicture.jpg" ... />

  當浏覽器收到HTML代碼時,它向服務器發送獲取圖片的請求並將其顯示在浏覽器中,該模式對所有的二進制數據都適用。在第2步中,我們沒有在頁面的HTML標記裡將小冊子顯示在浏覽器,而是在HTML標記裡提供一個超鏈接,當點擊它是,導致浏覽器直接請求PDF文件。

  為了顯示或允許用戶下載儲存在數據庫中的二進制數據,我們需要另外創建一個頁面,用於從數據庫返回所需的數據。對我們的應用程序而言,由於直接存儲在數據庫中的二進制數據只有一項——類的圖片,所以我們需要一個頁面,當需要時從數據庫返回某個特定類的圖片。

  在BinaryData文件夾添加一個DisplayCategoryPicture.aspx頁面,注意不要使用母版頁。該頁面接受一個包含CategoryID值的查詢字符串,返回Picture列的二進制數據。由於該頁只返回二進制數據,所以我們不需要頁面的HTML部分有任何代碼。進入頁面的“源碼”模式,刪除頁面的所有代碼,只保留<%@ Page %>部分。也即:DisplayCategoryPicture.aspx頁面的聲明代碼應該只由如下的單獨行構成:

<%@ Page Language="C#" AutoEventWireup="true"
 CodeFile="DisplayCategoryPicture.aspx.cs"
 Inherits="BinaryData_DisplayCategoryPicture" %>

如果<%@ Page %>裡包含有MasterPageFile屬性,將其刪除,同時在後台代碼類的Page_Load事件處理器裡添加如下代碼:

protected void Page_Load(object sender, EventArgs e)
{
 int categoryID = Convert.ToInt32(Request.QueryString["CategoryID"]);

 // Get information about the specified category
 CategoriesBLL categoryAPI = new CategoriesBLL();
 Northwind.CategoriesDataTable categories =
 categoryAPI.GetCategoryWithBinaryDataByCategoryID(categoryID);
 Northwind.CategoriesRow category = categories[0];

 // Output HTTP headers providing information about the binary data
 Response.ContentType = "image/bmp";

 // Output the binary data
 // But first we need to strip out the OLE header
 const int OleHeaderLength = 78;
 int strippedImageLength = category.Picture.Length - OleHeaderLength;
 byte[] strippedImageData = new byte[strippedImageLength];
 Array.Copy(category.Picture, OleHeaderLength,
 strippedImageData, 0, strippedImageLength);
 
 Response.BinaryWrite(strippedImageData);
}

  代碼先讀取查詢字符串的CategoryID值,並對名為categoryID的變量賦值。然後,通過調用CategoriesBLL類的
GetCategoryWithBinaryDataByCategoryID(categoryID)方法獲取圖片數據,再通過Response.BinaryWrite(data)方法向客戶端返回數據。不過在此之前先要剝離數據的OLE報頭。怎麼實現呢?創建一個名為strippedImageData的byte數組,它包含的字節剛好比Picture列的數據少78。而Array.Copy方法將從category.Picture的第78個字節開始復制數據(即剛好剝離OLE報頭)。

  代碼中的Response.ContentType屬性指定了要返回內容的MIME type,以便浏覽器知道如何顯示數據。由於Categories表的Picture列存儲的是位圖圖片,故在這裡,位圖圖片的MIME type是(image/bmp). 如果你忽視了MIME type,絕大多數浏覽器也可以正確的顯示圖像,因為,它們能根據圖像文件的二進制數據的內容而推斷其類型。即便如此,還是盡可能的使用MIME type。

創建頁面後,可以訪問頁面

DisplayCategoryPicture.aspx?CategoryID=categoryID來查看某個特定類的圖片。圖11顯示的是Beverages類的圖片,頁面為
DisplayCategoryPicture.aspx?CategoryID=1.

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435195.gif
圖11:顯示類Beverages的圖片

  有時候,當你訪問DisplayCategoryPicture.aspx?CategoryID=categoryID頁面時,有可能顯示這樣的提示:“Unable to cast object of type 'System.DBNull' to type 'System.Byte[]'”。原因有可能是如下2方面。第一,表Categories的Picture列允許為NULL值,而DisplayCategoryPicture.aspx page頁面總是假定傳入的為非NULL值。當Picture為NULL值時,不能直接訪問CategoriesDataTable的Picture屬性。如果你允許Picture為NULL值,添加如下代碼:

if (category.IsPictureNull())
{
 // Display some "No Image Available" picture
 Response.Redirect("~/Images/NoPictureAvailable.gif");
}
else
{
 // Send back the binary contents of the Picture column
 // ... Set ContentType property and write out ...
 // ... data via Response.BinaryWrite ...
}

  上述代碼假定在Images文件夾裡存在名為NoPictureAvailable.gif的圖片,當某個類沒有圖片時,就顯示該圖片。

  另一種情況:當你在向導裡選用“使用SQL語句”的模式再次運行主查詢時,它將影響GetCategoryWithBinaryDataByCategoryID方法的SELECT命令返回的列(換句話說,主查詢沒有返回Picture列,再次運行主查詢時將使GetCategoryWithBinaryDataByCategoryID方法也不會返回Picture列)。所以,應確保GetCategoryWithBinaryDataByCategoryID方法的SELECT命令返回Picture列。

  注意:每次訪問DisplayCategoryPicture.aspx頁面時,都會訪問數據庫並返回所需的圖片。如果圖片自最近一次訪問以來沒有改變過的話,這樣每次訪問數據庫再返回數據的做法效率是不高的。幸運的是,HTTP允許使用conditional GETs,這樣的話,客戶端使HTTP請求發送一個If-Modified-Since HTTP header。If-Modified-Since HTTP header包含了客戶端最近一次從服務器獲取的數據以及時間。如果請求的內容沒有發生改變,服務器響應為Not Modified status code (304),並不返回請求的內容。簡而言之,如果請求的資源自最近一次訪問以來沒發送改變的話,服務器將不會回傳該資源,以達到減輕服務器負荷的目的。

第四步:在GridView控件裡顯示Category Pictures

  現在我們有一個web頁面來顯示某個特定種類的圖片的。通過Image Web控件或 HTML <img>元素來指向DisplayCategoryPicture.aspx?CategoryID=categoryID頁面,從而達到顯示該圖片的目的。我們可以在GridView控件或DetailsView控件的 ImageField裡顯示圖片。ImageField的DataImageUrlField屬性、DataImageUrlFormatString屬性與HyperLinkField的DataNavigateUrlFields屬性、DataNavigateUrlFormatString屬性用法相似。

  讓我們對DisplayOrDownloadData.aspx頁面裡名為Categories的GridView控件進行擴充。添加一個ImageField,設其DataImageUrlField屬性為CategoryID;
DataImageUrlFormatString屬性為DisplayCategoryPicture.aspx?CategoryID={0}。這樣將為GridView增加一列,呈現為一個<img>元素,其src屬性為DisplayCategoryPicture.aspx?CategoryID={0},其中{0}將由GridView row的CategoryID值填充。

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435219.gif
圖12:為GridView控件添加一個ImageField

添加完成後,你的GridView控件的聲明代碼看起來應像下面這樣:

<asp:GridView ID="Categories" runat="server" AutoGenerateColumns="False"
 DataKeyNames="CategoryID" DataSourceID="CategoriesDataSource"
 EnableViewState="False">
 <Columns>
 <asp:BoundField DataField="CategoryName" HeaderText="Category"
  SortExpression="CategoryName" />
 <asp:BoundField DataField="Description" HeaderText="Description"
  SortExpression="Description" />
 <asp:TemplateField HeaderText="Brochure">
  <ItemTemplate>
  <%# GenerateBrochureLink(Eval("BrochurePath")) %>
  </ItemTemplate>
 </asp:TemplateField>
 <asp:ImageField DataImageUrlField="CategoryID"
  DataImageUrlFormatString="DisplayCategoryPicture.aspx?CategoryID={0}">
 </asp:ImageField>
 </Columns>
</asp:GridView>

花幾分鐘在浏覽器裡查看該頁面,注意每一行記錄現在都包含一張該類的圖片。

https://www.aspphp.online/bianchen/UploadFiles_4619/201701/2017010916435582.gif
圖13:每一行記錄都顯示一張圖片

總結:

  在本節我們探討了如何顯示二進制數據,數據是如何呈現的取決於它的類型。對PDF小冊子文件來說,我們提供了一個“View Brochure”鏈接,當點擊它時,直接將用戶指向PDF小冊子文件。對某個種類的圖片,我們先是創建一個頁面來從數據庫獲取並顯示它,然後再在一個GridView控件裡顯示圖片。既然看到了如何展示二進制數據,我們准備探討如何對其展開插入、更新、刪除操作。接下來的教程我們看如何將上傳文件和相應的數據庫記錄聯系起來。然後,再探討如何更新現存的二進制數據,以及當刪除數據庫記錄時如何刪除相應的二進制數據。

  祝編程快樂!

作者簡介

  本系列教程作者 Scott Mitchell,著有六本ASP/ASP.NET方面的書,是4GuysFromRolla.com的創始人,自1998年以來一直應用 微軟Web技術。大家可以點擊查看全部教程《[翻譯]Scott Mitchell 的ASP.NET 2.0數據教程》,希望對大家的學習ASP.NET有所幫助。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved