在ASP.NET 2.0中操作数据之五十五：编辑和删除现有的二进制数据

UPDATE [Categories] SET
 [CategoryName] = @CategoryName,
 [Description] = @Description,
 [BrochurePath] = @BrochurePath ,
 [Picture] = @Picture
WHERE (([CategoryID] = @Original_CategoryID))

[System.ComponentModel.DataObjectMethodAttribute
 (System.ComponentModel.DataObjectMethodType.Delete, true)]
public bool DeleteCategory(int categoryID)
{
 int rowsAffected = Adapter.Delete(categoryID);

 // Return true if precisely one row was deleted, otherwise false
 return rowsAffected == 1;
}

[System.ComponentModel.DataObjectMethodAttribute
 (System.ComponentModel.DataObjectMethodType.Update, false)]
public bool UpdateCategory(string categoryName, string description,
 string brochurePath, byte[] picture, int categoryID)
{
 // If no picture is specified, use other overload
 if (picture == null)
 return UpdateCategory(categoryName, description, brochurePath, categoryID);

 // Update picture, as well
 int rowsAffected = Adapter.UpdateWithPicture
 (categoryName, description, brochurePath, picture, categoryID);

 // Return true if precisely one row was updated, otherwise false
 return rowsAffected == 1;
}

[System.ComponentModel.DataObjectMethodAttribute
 (System.ComponentModel.DataObjectMethodType.Update, true)]
public bool UpdateCategory(string categoryName, string description,
 string brochurePath, int categoryID)
{
 int rowsAffected = Adapter.Update
 (categoryName, description, brochurePath, categoryID);

 // Return true if precisely one row was updated, otherwise false
 return rowsAffected == 1;
}

<asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
 OldValuesParameterFormatString="{0}" SelectMethod="GetCategories"
 TypeName="CategoriesBLL" InsertMethod="InsertWithPicture"
 DeleteMethod="DeleteCategory">
 <InsertParameters>
 <asp:Parameter Name="categoryName" Type="String" />
 <asp:Parameter Name="description" Type="String" />
 <asp:Parameter Name="brochurePath" Type="String" />
 <asp:Parameter Name="picture" Type="Object" />
 </InsertParameters>
 <DeleteParameters>
 <asp:Parameter Name="categoryID" Type="Int32" />
 </DeleteParameters>
</asp:ObjectDataSource>

// A page variable to "remember" the deleted category's BrochurePath value
string deletedCategorysPdfPath = null;

protected void Categories_RowDeleting(object sender, GridViewDeleteEventArgs e)
{
 // Determine the PDF path for the category being deleted...
 int categoryID = Convert.ToInt32(e.Keys["CategoryID"]);

 CategoriesBLL categoryAPI = new CategoriesBLL();
 Northwind.CategoriesDataTable categories =
 categoryAPI.GetCategoryByCategoryID(categoryID);
 Northwind.CategoriesRow category = categories[0];

 if (category.IsBrochurePathNull())
 deletedCategorysPdfPath = null;
 else
 deletedCategorysPdfPath = category.BrochurePath;
}

protected void Categories_RowDeleted(object sender, GridViewDeletedEventArgs e)
{
 // Delete the brochure file if there were no problems deleting the record
 if (e.Exception == null)
 {
 // Is there a file to delete"_blank" href="https://www.jb51.net/article/83697.htm">概述插入、更新和删除数据》里探讨的一样，如果GridView的数据源控件支持编辑，那么我们就可以启用GridView控件的编辑功能。当前，名为CategoriesDataSource的ObjectDataSource控件并不支持编辑，那让我们添加吧。

　　点击ObjectDataSource控件的“设置数据源”链接，一直点到“定义数据方法”界面。由于在CategoriesBLL里对重载的UpdateCategory方法使用了DataObjectMethodAttribute属性，UPDATE标签的下拉列表自动的选择了该方法，它包含4个输入参数（不包含Picture）。我们选择另一个包含5个输入参数的重载的UpdateCategory方法。


图9：设置ObjectDataSource控件使用包含Picture参数的UpdateCategory方法
　　ObjectDataSource控件现在包含了UpdateMethod属性以及相应的UpdateParameters参数集。就像在第4步提到的一样，当使用设置向导时，Visual Studio会将ObjectDataSource控件的OldValuesParameterFormatString属性设置为original_{0}，这导致调用update和delete方法时出现问题。因此，要么将该属性清除，要么设该属性为{0}。
完成后，ObjectDataSource控件的声明代码看起来应该和下面的差不多：


<asp:ObjectDataSource ID="CategoriesDataSource" runat="server"
 OldValuesParameterFormatString="{0}" SelectMethod="GetCategories"
 TypeName="CategoriesBLL" InsertMethod="InsertWithPicture"
 DeleteMethod="DeleteCategory" UpdateMethod="UpdateCategory">
 <InsertParameters>
 <asp:Parameter Name="categoryName" Type="String" />
 <asp:Parameter Name="description" Type="String" />
 <asp:Parameter Name="brochurePath" Type="String" />
 <asp:Parameter Name="picture" Type="Object" />
 </InsertParameters>
 <DeleteParameters>
 <asp:Parameter Name="categoryID" Type="Int32" />
 </DeleteParameters>
 <UpdateParameters>
 <asp:Parameter Name="categoryName" Type="String" />
 <asp:Parameter Name="description" Type="String" />
 <asp:Parameter Name="brochurePath" Type="String" />
 <asp:Parameter Name="picture" Type="Object" />
 <asp:Parameter Name="categoryID" Type="Int32" />
 </UpdateParameters>
</asp:ObjectDataSource>




要启用编辑功能，从GridView控件的智能标签里选“编辑”。这将设置CommandField的ShowEditButton属性为true，结果是为每行添加一个Edit按钮（当记录处于编辑状态时，将呈现为Update和Cancel按钮）


图10：启用GridView控件的编辑功能
　　从浏览器查看该页面，点某条记录的Edit按钮。CategoryName和Description列呈现为一个文本框。由于BrochurePath TemplateField没有EditItemTemplate模板，所以它依旧呈现其ItemTemplate模板——一个指向brochure的链接。Picture列呈现为一个文本框，并且该Picture ImageField的Text属性被指派为DataImageUrlField值，在这里，即CategoryID.


图11：BrochurePath列没有编辑界面
定制BrochurePath编辑界面
我们可以为BrochurePath TemplateField创建一个编辑界面，我们可以选择：
.维持原样

.上传新的brochure以作更新

.将brochure删除（这样一来，类就没有对应的brochure了）
我们也应该更新Picture ImageField的编辑界面，不过我们将放在第7步来讨论。
　　在GridView控件的智能标签里选择“编辑模板”，再从下拉列表里选BrochurePath TemplateField的EditItemTemplate模板。在模板里添加一个RadioButtonList Web控件，其ID为BrochureOptions；AutoPostBack属性为true.再在属性窗口里点Items属性的椭圆型区域，进入ListItem Collection Editor界面，分别添加值为1，2，3的选项：
.Use current brochure

.Remove current brochure

.Upload new brochure
设第一个ListItem的Selected属性为true.


图12：为RadioButtonList控件添加3个ListItems
在RadioButtonList控件下面，添加一个FileUpload控件，ID为BrochureUpload，设其Visible属性为false。


图13：在EditItemTemplate模板里添加RadioButtonList和FileUpload控件
RadioButtonList控件为用户提供了3个选择，只有当选择“Upload new brochure”时， FileUpload控件才会展现出来。为此，我们为RadioButtonList控件的SelectedIndexChanged事件创建事件处理器，如下：


protected void BrochureOptions_SelectedIndexChanged(object sender, EventArgs e)
{
 // Get a reference to the RadioButtonList and its Parent
 RadioButtonList BrochureOptions = (RadioButtonList)sender;
 Control parent = BrochureOptions.Parent;

 // Now use FindControl("controlID") to get a reference of the
 // FileUpload control
 FileUpload BrochureUpload =
 (FileUpload)parent.FindControl("BrochureUpload");

 // Only show BrochureUpload if SelectedValue = "3"
 BrochureUpload.Visible = (BrochureOptions.SelectedValue == "3");
}




　　由于RadioButtonList控件和FileUpload控件同时出现在一个模板里，我们需要通过编程来访问这2个控件。在SelectedIndexChanged事件处理器里，我们通过输入参数sender来引用RadioButtonList控件。为了获取FileUpload控件，我们需要使用RadioButtonList的父控件（parent control），并使用FindControl("controlID")方法。一旦我们同时获取了RadioButtonList和FileUpload控件时，只要RadioButtonList控件的SelectedValue值等于3，即“Upload new brochure” ListItem的值时，将FileUpload控件的Visible属性设置为true 。
　　添加完上述代码后，花几分钟时间来测试编辑页面。点击某行的Edit按钮，默认是选中“Use current brochure”项，改选另一项，页面产生回传，如果是选择第3项，则FileUpload控件将会显示出来，否则处于隐身状态。图14显示点击Edit按钮的情形，而图15则是选择“Upload new brochure”时的情形。


图14：默认选择“Use current brochure”项


图15：选择“Upload new brochure”时FileUpload控件显示出来
保存Brochure文件并更新BrochurePath列
当点击GridView控件的Update按钮时，触发RowUpdating事件，调用ObjectDataSource控件的update命令，然后触发GridView控件的RowUpdated事件。跟deleting流程类似，我们需要创建这些事件的处理器。在RowUpdating事件处理器里，我们需要根据RadioButtonList的SelectedValue值来判断下一步怎么做。
.如果SelectedValue值为1，我们将保持rochurePath不变。所以我们将ObjectDataSource控件的brochurePath参数设置为当前处于编辑状态记录的BrochurePath值，方法为e.NewValues["brochurePath"] = value.
.如果SelectedValue值为2，意味着将BrochurePath设为NULL。为此，我们需要将ObjectDataSource控件的brochurePath参数设为Nothing，结果就是在UPDATE命令里使用NULL。如果存在对应的brochure文件，我们必须将其删除，前提是没有抛出任何的异常。
.如果SelectedValue值为3，我们必须确保用户已经上传了一个PDF文件并将其保存在文件系统，然后更新记录的BrochurePath值。我们要先将被替换的前一个文件删除掉，当然前提是没有引发异常。
在上一章里，当在DetailsView控件里添加新记录时，触发DetailsView控件的ItemInserting事件。在本章，当RadioButtonList控件的SelectedValue为3时（即我们选择Upload new brochure时），接下来要采取的步骤实际上与DetailsView控件的ItemInserting事件处理器实现的功能相似。根据实现的功能，我划分为2个方法：
.ProcessBrochureUpload(FileUpload, out bool)：它以一个FileUpload控件实例为输入参数，结果为一个布尔值（Boolean）。根据该布尔值判断是否继续更新或删除操作，抑或取消操作。如果存在上传文件该方法就返回其路径，反之返回null。
.DeleteRememberedBrochurePath：如果页面变量deletedCategorysPdfPath不为null，则删除该参数指定的文件。
下面是上述2种方法的代码。注意ProcessBrochureUpload方法和DetailsView控件的ItemInserting事件处理器有某些相似性，在本章，我们更新DetailsView控件的事件处理器以使用这些新方法。下载本章的代码，查看我们对DetailsView控件的事件处理器所做的修改。




private string ProcessBrochureUpload
 (FileUpload BrochureUpload, out bool CancelOperation)
{
 CancelOperation = false; // by default, do not cancel operation

 if (BrochureUpload.HasFile)
 {
 // Make sure that a PDF has been uploaded
 if (string.Compare(System.IO.Path.GetExtension(BrochureUpload.FileName),
  ".pdf", true) != 0)
 {
  UploadWarning.Text =
  "Only PDF documents may be used for a category's brochure.";
  UploadWarning.Visible = true;
  CancelOperation = true;
  return null;
 }

 const string BrochureDirectory = "~/Brochures/";
 string brochurePath = BrochureDirectory + BrochureUpload.FileName;
 string fileNameWithoutExtension =
  System.IO.Path.GetFileNameWithoutExtension(BrochureUpload.FileName);

 int iteration = 1;

 while (System.IO.File.Exists(Server.MapPath(brochurePath)))
 {
  brochurePath = string.Concat(BrochureDirectory, fileNameWithoutExtension,
  "-", iteration, ".pdf");
  iteration++;
 }

 // Save the file to disk and set the value of the brochurePath parameter
 BrochureUpload.SaveAs(Server.MapPath(brochurePath));
 return brochurePath;
 }
 else
 {
 // No file uploaded
 return null;
 }
}

private void DeleteRememberedBrochurePath()
{
 // Is there a file to delete"htmlcode">

protected void Categories_RowUpdating(object sender, GridViewUpdateEventArgs e)
{
 // Reference the RadioButtonList
 RadioButtonList BrochureOptions =
 (RadioButtonList)Categories.Rows[e.RowIndex].FindControl("BrochureOptions");

 // Get BrochurePath information about the record being updated
 int categoryID = Convert.ToInt32(e.Keys["CategoryID"]);

 CategoriesBLL categoryAPI = new CategoriesBLL();
 Northwind.CategoriesDataTable categories =
 categoryAPI.GetCategoryByCategoryID(categoryID);
 Northwind.CategoriesRow category = categories[0];

 if (BrochureOptions.SelectedValue == "1")
 {
 // Use current value for BrochurePath
 if (category.IsBrochurePathNull())
  e.NewValues["brochurePath"] = null;
 else
  e.NewValues["brochurePath"] = category.BrochurePath;
 }
 else if (BrochureOptions.SelectedValue == "2")
 {
 // Remove the current brochure (set it to NULL in the database)
 e.NewValues["brochurePath"] = null;
 }
 else if (BrochureOptions.SelectedValue == "3")
 {
 // Reference the BrochurePath FileUpload control
 FileUpload BrochureUpload =
  (FileUpload)Categories.Rows[e.RowIndex].FindControl("BrochureUpload");

 // Process the BrochureUpload
 bool cancelOperation = false;
 e.NewValues["brochurePath"] =
  ProcessBrochureUpload(BrochureUpload, out cancelOperation);

 e.Cancel = cancelOperation;
 }
 else
 {
 // Unknown value!
 throw new ApplicationException(
  string.Format("Invalid BrochureOptions value, {0}",
  BrochureOptions.SelectedValue));
 }

 if (BrochureOptions.SelectedValue == "2" ||
 BrochureOptions.SelectedValue == "3")
 {
 // "Remember" that we need to delete the old PDF file
 if (category.IsBrochurePathNull())
  deletedCategorysPdfPath = null;
 else
  deletedCategorysPdfPath = category.BrochurePath;
 }
}

protected void Categories_RowUpdated(object sender, GridViewUpdatedEventArgs e)
{
 // If there were no problems and we updated the PDF file,
 // then delete the existing one
 if (e.Exception == null)
 {
 DeleteRememberedBrochurePath();
 }
}




注意：RowUpdating事件处理器是如何根据SelectedValue值的不同而使用一系列的条件语句来实现相应的功能。
使用上面的代码，我们就可以编辑一个类了，使用其当前的brochure，或不使用brochure，再或者使用一个新的brochure。在RowUpdating和RowUpdated事件处理器里设置断点（breakpoints）吧，以便更好的理解处理流程。
第7步：上传新图片
　　Picture ImageField的编辑界面呈现为一个文本框，里面显示的是DataImageUrlField 属性的值。在编辑流程，GridView控件向ObjectDataSource传入一个参数，参数名为ImageField的DataImageUrlField属性；参数值为在编辑界面输入文本框里的值。当图片是存储在文件系统，且DataImageUrlField属性包含的是访问该图片的完整URL时，这样做是恰当的。在这种情况下，在编辑界面里，文本框将会显示图片的URL。毫无疑问，默认的界面不允许用户上传新的图片，但用户却可以修改图片的URL值。不过，在本教程不会出现这种情况，因为Picture数据是直接存储在数据库的，且DataImageUrlField属性被设为CategoryID值。
　　为了更好的理解在本教程里编辑某行的ImageField时将会发生上什么，我们做如下假设：用户编辑一个CategoryID值为10行，Picture ImageField呈现为一个文本框，显示10，假设用户将其改为50后点Update按钮，页面回传，GridView控件最初产生一个名为CategoryID，值为50的参数。在GridView传递此参数（连同参数CategoryName和参数Description一起）以前，对DataKeys集添加值。因此，将当前行的CategoryID值10，覆盖掉。简言之，ImageField的编辑界面没有对本章教程的编辑流程产生任何影响，因为ImageField的DataImageUrlField属性和DataKey值都是同一个值。
　　当图片存储在数据库时，ImageField将其显示出来也很容易。不过在编辑界面里我们不需要使用文本框，而提供一个FileUpload控件供最终用户更改图片时使用。与BrochurePath不同，我们不允许类的图片为空——用户要么提供新图片要么使用当前的图片。
　　为定制ImageField的编辑界面，我们需要将其转化为一个TemplateField。在GridView控件的智能标签里点击“编辑列”，进入后选中ImageField，再点击“Convert this field into a TemplateField”链接。


图16：将ImageField转换为TemplateField
　　转换后的TemplateField由2个模版构成。就像下面的声明代码显示的那样，ItemTemplate模版包含一个Image Web控件，其ImageUrl属性由一个数据绑定语法指定，该数据绑定语法基于ImageField的DataImageUrlField和 DataImageUrlFormatString属性。而EditItemTemplate模版则包含一个TextBox，其Text属性绑定到DataImageUrlField属性的值。


<asp:TemplateField>
 <EditItemTemplate>
 <asp:TextBox ID="TextBox1" runat="server"
  Text='<%# Eval("CategoryID") %>'></asp:TextBox>
 </EditItemTemplate>
 <ItemTemplate>
 <asp:Image ID="Image1" runat="server"
  ImageUrl='<%# Eval("CategoryID",
  "DisplayCategoryPicture.aspx") %>' />
 </ItemTemplate>
</asp:TemplateField>



　　我们需要更新EditItemTemplate模版以包含一个FileUpload控件。从GridView控件的智能标签点“编辑模版”，再在下拉列表选择Picture TemplateField的EditItemTemplate模版。在模版里你会看见一个TextBox，将其删除。从工具箱里拖一个FileUpload控件到页面，设其ID为PictureUpload。同时在模版里添加如下的文本：“To change the category's picture, specify a new picture. To keep the category's picture the same, leave the field empty”。


图17：在EditItemTemplate模版里添加一个FileUpload控件


完成定制该编辑界面后，在浏览器里查看。在只读模式里，类的图片和以前没什么两样，当点击Edit按钮时，picture列将呈现一段文本和一个FileUpload控件。


图18：编辑界面包含一个FileUpload控件
　　记得我们设置ObjectDataSource控件调用CategoriesBLL的UpdateCategory方法，该方法的一个输入参数为数组，用于处理图片的数据。如果该数组为null值，则调用另一个重载的UpdateCategory方法，该重载的UpdateCategory方法的UPDATE SQL语句不会更改Picture列，因此类的图片不会由任何变化。在GridView控件的RowUpdating事件处理器里，我们编程访问名为PictureUpload的FileUpload控件，判断是否上传了文件。如果没有文件上传，我们将不会为参数picture指定值；反之，如果上传了文件，我们将确保其为JPG格式的文件，并通过参数picture将其传给ObjectDataSource控件。
　　就像第6步里的代码一样，我们此时将要用到的绝大多数的代码已经存在于DetailsView控件的ItemInserting事件处理器里了。现在我们创建一个新的方法ValidPictureUpload,并更新ItemInserting事件处理器以使用该方法。
　　在GridView控件的RowUpdating事件处理器的开头部分添加如下的代码，这很重要，因为我们不希望将一个不符合条件的上传文件存储在文件系统。


// Reference the PictureUpload FileUpload
FileUpload PictureUpload =
 (FileUpload)Categories.Rows[e.RowIndex].FindControl("PictureUpload");
if (PictureUpload.HasFile)
{
 // Make sure the picture upload is valid
 if (ValidPictureUpload(PictureUpload))
 {
 e.NewValues["picture"] = PictureUpload.FileBytes;
 }
 else
 {
 // Invalid file upload, cancel update and exit event handler
 e.Cancel = true;
 return;
 }
}


　　ValidPictureUpload(FileUpload)方法只有一个FileUpload控件类型的输入参数，通过检查上传文件的扩展符以确保上传的文件为JPG格式。只有当上传了文件时才会调用该方法；如果没有文件上传，参数picture就只能使用其默认值—null。如果上传了图片，且ValidPictureUpload方法返回值true，将用图片的二进制数据对参数picture赋值。如果ValidPictureUpload方法返回值false，则取消更新，并退出事件处理器。
ValidPictureUpload(FileUpload)方法的代码如下：


private bool ValidPictureUpload(FileUpload PictureUpload)
{
 // Make sure that a JPG has been uploaded
 if (string.Compare(System.IO.Path.GetExtension(PictureUpload.FileName),
  ".jpg", true) != 0 &&
 string.Compare(System.IO.Path.GetExtension(PictureUpload.FileName),
  ".jpeg", true) != 0)
 {
 UploadWarning.Text =
  "Only JPG documents may be used for a category's picture.";
 UploadWarning.Visible = true;
 return false;
 }
 else
 {
 return true;
 }
}


第8步：将原始几个类的图片替换为JPG格式
回想起最开始的那8个类的图片为位图文件其包含一个OLE报头。现在我们添加了新功能以编辑现有记录的图片，花几分钟将这些位图文件替换为JPG文件。如果你想使当前类的图片不变，你可以通过下面的布置将其转换为JPG格式：
1.将这些位图保存在硬盘。在浏览器里访问UpdatingAndDeleting.aspx页面，对这8个类的图片，点右键，选则保存图片。
2.在一个图片编辑器（比如Microsoft Paint）软件里打开图片。
3.将图片保存为JPG格式
4.在编辑界面里，用JPG图片更新类的picture
完成更新并上传JPG图片之后，图片不会呈现在浏览器里，原因是DisplayCategoryPicture.aspx将尝试对最开始8个类的图片剥离OLE报头。怎样修正呢？我们将剥离OLE报头的代码移除。这样，DisplayCategoryPicture.aspx页面的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];

 // For new categories, images are JPGs...
 
 // Output HTTP headers providing information about the binary data
 Response.ContentType = "image/jpeg";

 // Output the binary data
 Response.BinaryWrite(category.Picture);
}




注意：UpdatingAndDeleting.aspx页面的编辑和添加界面要稍微复杂一点。DetailsView和GridView控件里的CategoryName和Description  BoundFields应当转换成TemplateFields；另外由于CategoryName不能为NULL值，应对其添加一个RequiredFieldValidator控件。此外，Description应修改为允许换行的的文本框（multi-line TextBox），我将这些留给读者作为练习。
总结：

　　本篇为处理二进制数据的完结篇，在本章以及前3章我们考察了如何将二进制数据存放在文件系统或直接存储在数据库里。用户在硬盘里选择一个文件并将其上传到服务器，再存放在文件系统或数据库。ASP.NET 2.0的FileUpload控件提供了上传的界面。然而，就像在教程《使用FileUpload上传文件》里提到的那样，FileUpload控件控件只适合于上传小于1MB的文件。我们也探讨了如何编辑和删除当前记录的二进制数据。
在接下来的一系列教程里，我们探讨各种缓存技术。使用缓存可以提升应用程序的整体性能。
　　祝编程快乐！
作者简介
　　本系列教程作者 Scott Mitchell，著有六本ASP/ASP.NET方面的书，是4GuysFromRolla.com的创始人，自1998年以来一直应用 微软Web技术。大家可以点击查看全部教程《[翻译]Scott Mitchell 的ASP.NET 2.0数据教程》，希望对大家的学习ASP.NET有所帮助。