在ASP.NET 2.0中操作數據::概述插入、更新和刪除數據
導言
結束前面的幾節,我們已經探討過了如何使用GridView、DetailsView和FormView控件來顯示數據。這些控件簡單地操作提供給它的數據。一般地,這些控件通過使用一個數據源控件,例如ObjectDataSource來存取數據。我們已經看過了ObjectDataSource是如何在ASP.NET頁面和潛在的數據之間扮演一個代理的角色。當一個GridView需要顯示數據時,它調用ObjectDataSource的
Select()
方法,這個方法轉而調用一個來自我們的業務邏輯層(BLL)的方法,繼而調用一個適當的數據訪問層(DAL)的表適配器(TableAdapter)的方法,從而它發送一個
SELECT
查詢到Northwind數據庫。
記得在我們的教程里當創建DAL中的表適配器時,Visual Studio自動地添加從潛在數據庫插入、更新和刪除數據的方法。此外,在
創
建一個業務邏輯層
這一節我們已經設計了調用這些數據更改的DAL方法的BLL方法。
除了它的
Select()
方法,ObjectDataSource還有
Insert()
、
Update()
和
Delete()
方法。跟
Select()
方法類似,這三個方法映射到一個隱含的對象。當配置插入、更新或刪除數據時,GridView、DetailsView和FormView控件提供了一個修改潛在的數據的用戶界面。這個用戶界面調用ObjectDataSource的
Insert()
、
Update()
和
Delete()
方法,它們繼而調用隱含對象的關聯方法(見圖1)。
本節我們將看看如何映射ObjectDataSource的
Insert()
、
Update()
和
Delete()
方法到BLL中的類,也看看如何配置GridView、DetailsView和FormView控件提供修改數據的功能。
第一步: 創建Insert、Update和Delete教程頁面
在我們開始探討如何插入、修改和刪除數據之前,讓我們先花些時間在我們的站點項目里添加這些本節里和下一節里需要的ASP.NET頁面。首先添加一個名為
EditInsertDelete
的新文件夾。然后,在這個文件夾里添加下面這些ASP.NET頁面,并且確認每個頁面都關聯
Site.master
母版頁:
·
Default.aspx
·
Basics.aspx
·
DataModificationEvents.aspx
·
ErrorHandling.aspx
·
UIValidation.aspx
·
CustomizedUI.aspx
·
OptimisticConcurrency.aspx
·
ConfirmationOnDelete.aspx
·
UserLevelAccess.aspx
類似在其它文件夾里,
EditInsertDelete
文件夾里的
Default.aspx
將列出這些教程章節。記得用戶控件提供這個功能。因此,從解決方案資源管理器中拖拽一個這個用戶控件到頁面的設計視圖,從而添加它到
Default.aspx
頁面。
最后,添加這些頁面地址項到
Web.sitemap
文件。明確地,在Customized Formatting
<siteMapNode>
后添加如下標記:
<siteMapNode title="Editing, Inserting, and Deleting" url="~/EditInsertDelete/Default.aspx" description="Samples of Reports that Provide Editing, Inserting, and Deleting Capabilities">
<siteMapNode url="~/EditInsertDelete/Basics.aspx" title="Basics" description="Examines the basics of data modification with the GridView, DetailsView, and FormView controls." />
<siteMapNode url="~/EditInsertDelete/DataModificationEvents.aspx" title="Data Modification Events" description="Explores the events raised by the ObjectDataSource pertinent to data modification." />
<siteMapNode url="~/EditInsertDelete/ErrorHandling.aspx" title="Error Handling" description="Learn how to gracefully handle exceptions raised during the data modification workflow." />
<siteMapNode url="~/EditInsertDelete/UIValidation.aspx" title="Adding Data Entry Validation" description="Help prevent data entry errors by providing validation." />
<siteMapNode url="~/EditInsertDelete/CustomizedUI.aspx" title="Customize the User Interface" description="Customize the editing and inserting user interfaces." />
<siteMapNode url="~/EditInsertDelete/OptimisticConcurrency.aspx" title="Optimistic Concurrency" description="Learn how to help prevent simultaneous users from overwritting one another's changes." />
<siteMapNode url="~/EditInsertDelete/ConfirmationOnDelete.aspx" title="Confirm On Delete" description="Prompt a user for confirmation when deleting a record." />
<siteMapNode url="~/EditInsertDelete/UserLevelAccess.aspx" title="Limit Capabilities Based on User" description="Learn how to limit the data modification functionality based on the user's role or permissions." />
</siteMapNode>
在更新了
Web.sitemap
后,花些時間通過瀏覽器訪問本教程站點。左邊的菜單里現在包含對應編輯、插入和刪除教程的項。
第二步: 添加并配置ObjectDataSource控件
因為GridView、DetailsView和FormView控件在數據修改功能和版面上都有所不同,就讓我們逐個研究。不過,與其讓這三個控件各自使用自己的ObjectDataSource,還不如讓我們僅創建一個ObjectDataSource讓這個三個控件的例子共用。
打開
Basics.aspx
頁面,從工具箱拖拽一個ObjectDataSource到設計器,從它的職能標記中點擊配置數據源鏈接。因為
ProductsBLL
類是唯一一個提供修改、插入和刪除方法的BLL類,配置該ObjectDataSource使用這個類。
在下一屏中,通過選擇適當的tab頁并從下拉列表中選擇方法,我們可以指定
ProductsBLL
類里的哪些方法被映射到ObjectDataSource的
Select()
、
Insert()
、
Update()
和
Delete()
方法。圖6,至今我們應該很熟悉,映射ObjectDataSource的
Select()
方法到
ProductsBLL
類的
GetProducts()
方法。
Insert()
、
Update()
和
Delete()
方法可以通過選擇上方的適當的tab頁進行配置。
圖7、8和9顯示ObjectDataSource的UPDATE、INSERT,和DELETE 的tab頁。配置它們從而
Insert()
、
Update()
和
Delete()
方法分別調用
ProductsBLL
類的
UpdateProduct
、
AddProduct
和
DeleteProduct
方法。
你也許已經注意到在UPDATE、INSERT和DELETE的tab頁里的下拉列表中已經選擇了各自的方法。這是由于我們使用了
DataObjectMethodAttribute
,它修飾了
ProducstBLL
類。例如,DeleteProduct方法是如下這樣子聲明的:
[System.ComponentModel.DataObjectMethodAttribute(System.ComponentModel.DataObjectMethodType.Delete, true)]
public bool DeleteProduct(int productID)
{
...
}
DataObjectMethodAttribute
指示每一個方法的目的–是否為了查詢、插入、更新或刪除–
是否它的默認值。如果你在創建BLL類的時候省略了這些屬性,現在你將需要手工從UPDATE、INSERT和DELETE的tab頁里手工選擇方法。
當確認已經適當的
ProductsBLL
方法映射到ObjectDataSource的
Insert()
、
Update()
和
Delete()
方法后,點擊完成結束此向導。
檢查ObjectDataSource的標記
在通過數據源配置向導完成了對ObjectDataSource的配置之后,到源視圖去檢查一下生成的聲明標記。
<asp:ObjectDataSource>
標簽列明了隱含的對象和需要調用的方法。另外,還有
DeleteParameters
、
UpdateParameters
和
InsertParameters
,它們映射
ProductsBLL
類的
AddProduct
、
UpdateProduct
和
DeleteProduct
方法的輸入參數:
<asp:ObjectDataSource ID="ObjectDataSource1" runat="server" DeleteMethod="DeleteProduct"
InsertMethod="AddProduct" OldValuesParameterFormatString="original_{0}" SelectMethod="GetProducts"
TypeName="ProductsBLL" UpdateMethod="UpdateProduct">
<DeleteParameters>
<asp:Parameter Name="productID" Type="Int32" />
</DeleteParameters>
<UpdateParameters>
<asp:Parameter Name="productName" Type="String" />
<asp:Parameter Name="supplierID" Type="Int32" />
<asp:Parameter Name="categoryID" Type="Int32" />
<asp:Parameter Name="quantityPerUnit" Type="String" />
<asp:Parameter Name="unitPrice" Type="Decimal" />
<asp:Parameter Name="unitsInStock" Type="Int16" />
<asp:Parameter Name="unitsOnOrder" Type="Int16" />
<asp:Parameter Name="reorderLevel" Type="Int16" />
<asp:Parameter Name="discontinued" Type="Boolean" />
<asp:Parameter Name="productID" Type="Int32" />
</UpdateParameters>
<InsertParameters>
<asp:Parameter Name="productName" Type="String" />
<asp:Parameter Name="supplierID" Type="Int32" />
<asp:Parameter Name="categoryID" Type="Int32" />
<asp:Parameter Name="quantityPerUnit" Type="String" />
<asp:Parameter Name="unitPrice" Type="Decimal" />
<asp:Parameter Name="unitsInStock" Type="Int16" />
<asp:Parameter Name="unitsOnOrder" Type="Int16" />
<asp:Parameter Name="reorderLevel" Type="Int16" />
<asp:Parameter Name="discontinued" Type="Boolean" />
</InsertParameters>
</asp:ObjectDataSource>
ObjectDataSource包含了對應它關聯的方法的每一個輸入參數的parameter,就像當ObjectDataSource被配置為調用預期一個輸入參數的查詢方法(例如
GetProductsByCategoryID(
categoryID
)
)時出現的
SelectParameter
s一欄。正如我們馬上即將看到的,這些
DeleteParameters
、
UpdateParameters
和
InsertParameters
的值在調用ObjectDataSource的
Insert()
、
Update()
或
Delete()
方法之前自動地通過GridView、DetailsView和FormView被設置。必要時這些值也可以通過編程設置,這在以后的章節里討論。
使用數據源配置向導來配置ObjectDataSource的另一個影響是Visual Studio設置了
OldValuesParameterFormatString
屬性為
original_{0}
。這個屬性值用來包含數據被編輯時的原始值,它在下面兩種情況下非常有用:
·
如果,當編輯一條記錄時,用戶可以修改主鍵的值。在這種情況下,新的主鍵的值和原始的主鍵值都需要提供,這樣具有這個原始主鍵值的數據庫記錄才可以被找到然后才能將它的值更新。
·
當使用開放式并發。開放式并發是為了保證同時操作的用戶不至于覆蓋另一個用戶所做更改的一種技巧,這也是后面的教程中的一節(
實現開放式并發
)。
這個
OldValuesParameterFormatString
屬性指明了隱含對象的更新和刪除方法中對應原始值的輸入參數的名稱。我們將在探討開發式并發的時候更詳細地討論這個屬性和它的目的。不過暫時我放下它,因為我們的BLL的方法并不需要這些原始的值因此我們刪除這個屬性,這一點很重要。如果讓
OldValuesParameterFormatString
屬性設置為除了默認值(
{0}
)以外的其它任何的值,都將在數據Web控件嘗試調用ObjectDataSource的
Update()
或
Delete()
方法時引發一個錯誤,因為ObjectDataSource將嘗試將這些原始值參數與
UpdateParameters
或
DeleteParameters
一起傳入。
如果對此不是十分清楚,別擔心,我們將在未來的章節中研究這個屬性和它的效用。暫時,一定要完全地從聲明語法中完全地刪除這個屬性或者將它設置為默認值(
{0}
)。
注意
:
如果你只是簡單地從設計視圖的屬性窗口刪除這個
OldValuesParameterFormatString
屬性的值,這個屬性依舊會存在于聲明語法中,不過被設置為一個空字符串。不幸地,這將依舊導致上面提到的同樣的問題。所以,從聲明語法里徹底地刪除這個屬性,或者從屬性窗口將其設置為默認值,
{0}
。
第三步: 添加一個數據Web服務器控件并配置它為數據更改服務
一般ObjectDataSOurce被添加到頁面并配置完成,我們可以添加一個數據Web服務器控件用來顯示數據并提供一個最終用戶修改數據的途徑。我們將分別看看GridView、DetailsView和FormView,因為這些數據Web服務器控件在它們的數據更改功能和配置上都有所不同。
正如我們將在本文剩下的部分里看到的,通過GridView、DetailsView和FormView控件添加一個非常基本的編輯、插入和刪除支持是真的非常簡單,只需要勾選上一對CheckBox。現實中提供這樣的功能有許多微妙之處和邊緣案例,這要比僅僅點幾下要棘手得多。但是,本教程里,只著眼于提供簡單的數據修改功能。以后的章節將研究在現實中不容置疑地出現的問題。
從GridView中刪除數據
首先,從工具箱拖拽一個GridView到設計器。然后,通過GridView的智能標記中從下拉列表中選擇從而綁定ObjectDataSource到該GridView。在這里GridView的聲明標記將是:
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="False" DataKeyNames="ProductID" DataSourceID="ObjectDataSource1" EnableViewState="False">
<Columns>
<asp:BoundField DataField="ProductID" HeaderText="ProductID" InsertVisible="False"
ReadOnly="True" SortExpression="ProductID" />
<asp:BoundField DataField="ProductName" HeaderText="ProductName" SortExpression="ProductName" />
<asp:BoundField DataField="SupplierID" HeaderText="SupplierID" SortExpression="SupplierID" />
<asp:BoundField DataField="CategoryID" HeaderText="CategoryID" SortExpression="CategoryID" />
<asp:BoundField DataField="QuantityPerUnit" HeaderText="QuantityPerUnit" SortExpression="QuantityPerUnit" />
<asp:BoundField DataField="UnitPrice" HeaderText="UnitPrice" SortExpression="UnitPrice" />
<asp:BoundField DataField="UnitsInStock" HeaderText="UnitsInStock" SortExpression="UnitsInStock" />
<asp:BoundField DataField="UnitsOnOrder" HeaderText="UnitsOnOrder" SortExpression="UnitsOnOrder" />
<asp:BoundField DataField="ReorderLevel" HeaderText="ReorderLevel" SortExpression="ReorderLevel" />
<asp:CheckBoxField DataField="Discontinued" HeaderText="Discontinued" SortExpression="Discontinued" />
<asp:BoundField DataField="CategoryName" HeaderText="CategoryName" ReadOnly="True"
SortExpression="CategoryName" />
<asp:BoundField DataField="SupplierName" HeaderText="SupplierName" ReadOnly="True"
SortExpression="SupplierName" />
</Columns>
</asp:GridView>
通過它的職能標記綁定GridView到ObjectDataSource有下面兩點的好處:
·
綁定列和CheckBox列被自動地添加,對應ObjectDataSource返回的每一個字段。而且,這些綁定列和CheckBox列的屬性已經被設置,基于隱含字段的元數據。例如
ProductID
、
CategoryName
和
SupplierName
列在
ProductsDataTable
里被標記為只讀,因此它們在編輯時也是不可更新的。為了實現這一點,這些綁定列的
ReadOnly
屬性設置為
true
。
·
DataKeyNames
屬性被賦值為隱含對象的主鍵。這是在使用GridView來編輯或刪除數據的要點,因為這個屬性象指出了標識唯一記錄的那個字段(或是一組字段)。如果要獲得更多的關于
DataKeyNames
屬性的信息,請回到
使用
GridView
和
DetailView
實現的主
/
從報表
一節。
雖然可以通過屬性窗口或者聲明語法將GridView綁定到ObjectDataSource,不過這需要你手工添加適當的綁定列和
DataKeyNames
標記。
GridView控件提供了對行編輯和刪除的內建的支持。配置一個GridView支持刪除需要添加一個刪除按鈕列。當最終用戶點擊某一特定行的刪除按鈕時,引發一次回傳并且GridView執行以下步驟:
1.
對ObjectDataSource的
DeleteParameters
賦值
2.
調用ObjectDataSource的
Delete()
方法,刪除指定的記錄
3.
通過調用它的
Select()
方法GridView重新綁定到ObjectDataSource
賦值到
DeleteParameters
的值是點擊刪除按鈕這一行的
DataKeyNames
字段的值。因此正確地設置GridView的
DataKeyNames
屬性是至關重要的。如果缺少了這個,
DeleteParameters
將在第1步被賦上一個
null
值,從而在第2步中將不會導致刪除任何記錄。
為了給GridView增加刪除功能,簡單地到它的職能標記里勾選上“啟用刪除”。
從智能標記中勾選啟用刪除會添加一個CommandField到GridView。這個CommandField在GridView中補充一個按鈕列,它履行一個或多個下屬任務:選中一行記錄、編輯一行記錄和刪除一行記錄。我們先前在
使用
GridView
和
DetailView
實現的主
/
從報表
一節的教程里也看到過了CommandField用作選中記錄時如何運作。
這個CommandFIeld包含了一些
Show
X
Button
屬性,它指示哪一系列的按鈕顯示在CommandField中。通過勾選啟用刪除,一個
ShowDeleteButton
屬性為
true
的CommandField被添加到GridView的列集合。
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="False" DataKeyNames="ProductID" DataSourceID="ObjectDataSource1" EnableViewState="False">
<Columns>
<asp:CommandField ShowDeleteButton="True" />
... BoundFields removed for brevity ...
</Columns>
</asp:GridView>
到這里,你可能還不能相信,我們已經完成了給這個GridView增加刪除支持!正如圖11顯示的,當我們通過瀏覽器訪問此頁面時,一列刪除按鈕已經出現。
如果你是從一開始就是自己創建本教程的程序,當測試這個頁面點擊刪除按鈕時將引發一個異常。繼續讀下去學習關于為什么會引發這些異常,還有如何修復它們。
注意
:
如果你是跟隨著下載的教程的程序,這些問題已經被解決。然而,我鼓勵你從頭到尾讀一遍下面列出的詳細資料來幫助你識別可能出現的問題和適宜的工作區。
如果,當嘗試刪除一個產品,你得到一個類似于“
ObjectDataSource 'ObjectDataSource1' could not find a non-generic method 'DeleteProduct' that has parameters: productID, original_ProductID
,”的異常,你可能忘記了從ObjectDataSource里刪除
OldValuesParameterFormatString
屬性。指定了
OldValuesParameterFormatString
屬性的話,該ObjectDataSource會試圖向
DeleteProduct
方法一并傳入
productID
和
original_ProductID
輸入參數,然而,
DeleteProduct
方法只能接受一個輸入參數,導致異常。刪除
OldValuesParameterFormatString
屬性(或設置它為
{0}
)指示ObjectDataSource不要試圖傳入這個原始值的輸入參數。
即使你已經刪除了
OldValuesParameterFormatString
屬性,當你嘗試刪除一個產品時依舊將得到一個異常:“
The DELETE statement conflicted with the REFERENCE constraint 'FK_Order_Details_Products'
.”。Northwind數據庫包含了一個在
Order Details
和
Products
表間的字段約束,表示如果一個產品在
Order Details
表里對應它有一條或多條記錄,那么該產品不能被刪除。因為Northwind數據庫里的每一個產品在
Order Details
表里都至少有一條記錄,所以我們不能刪除任何產品,除非我們從order details表里刪除這個產品的關聯記錄。
為了我們的教程,就讓我們刪除
Order Details
表里的所有記錄吧。在一個真實的應用程序中我們需要的是下面任一措施:
·
通過另外一個頁面管理order details信息
·
在
DeleteProduct
方法里增加包含刪除指定產品的訂單明細的邏輯
·
修改TableAdapter所使用的SQL語句,包含對指定產品的訂單明細的刪除
就讓我們從
Order Details
表里刪除所有記錄從而繞過字段間約束的問題。到
Visual Studio的服務器資源管理器,在
NORTHWND.MDF
節點上點擊鼠標右鍵,選擇“新建查詢”。然后,再查詢窗口執行下面的SQL語句:
DELETE FROM [Order Details]
在清空了
Order Details
表后,點擊刪除按鈕將會正確無誤地刪除這個產品。如果點擊了刪除按鈕但是沒有刪除該產品,檢查并確保GridView的
DataKeyNames
屬性設置為主鍵(
ProductID
)。
注意
:
當點擊刪除按鈕時引發一次回傳并刪了了該記錄。這是危險的,因為它很容易意外地錯誤點擊了別的行的刪除按鈕。以后的章節里我們將看看如何在刪除記錄時添加一個客戶端的確認詢問。
在GridView中編輯數據
跟刪除支持一起,GridView還提供了內建的對行編輯的支持。配置GrdiView支持編輯將添加一列編輯按鈕。從最終用戶的角度,點擊一行的編輯按鈕可使這一行變成可編輯的,它的單元格轉換成文本框并包含現有的值,并把編輯按鈕替換成保存和取消按鈕。在完成了他們期望的更改之后,最終用戶可以點擊保存按鈕提交這些修改,或者點擊取消按鈕放棄這些修改。在任意一種情況,點擊保存或者取消按鈕后GridView回到它編輯前的狀態。
站在我們頁面開發者的角度,當最終用戶點擊特定一行的編輯按鈕時,引發一次回傳并且GridView執行以下步驟:
1.
GridView的
EditItemIndex
屬性被賦值為當前點擊編輯按鈕的行的索引
2.
通過調用它的
Select()
方法,GridView重新綁定自己到ObjectDataSource
3.
與
EditItemIndex
相匹配的行呈現為編輯模式。在此模式下,編輯按鈕替換為保存和取消按鈕,并且那些
ReadOnly
屬性為False的綁定列呈現為TextBox服務器控件,這些TextBox的
Text
屬性被賦值為相應的數據字段的值。
到這里HTML標記被返回到瀏覽器,允許最終用戶可以修改行數據。當用戶點擊保存按鈕,再次發生一次回傳,并且GridView執行以下幾個步驟:
1.
ObjectDataSource的
UpdateParameters
的值被賦值為最終用戶在GridView的編輯界面輸入的值
2.
調用ObjectDataSource的
Update()
方法,更新指定的記錄
3.
通過調用它的
Select()
方法,GridView重新綁定自己到ObjectDataSource
在
DataKeyNames
屬性指定的主鍵的值在第1步中賦值到
UpdateParameters
,反之非主鍵的值來自當前編輯行的TextBox服務器控件。如果這一點遺漏了,那么
UpdateParameters
主鍵的值在第1步中將被賦上一個值,然后轉入第2步中將不會導致任何記錄的更新。
編輯功能可以簡單地通過勾選GridView的智能標記中的啟用編輯從而被激活。
勾選啟用編輯將添加一個CommandField(如果需要的話)并設置它的
ShowEditButton
屬性為
true
。如我們之前所看過的,CommandField包含一些
Show
X
Button
屬性,他們指出哪一系列的按鈕要顯示在CommandField里。在我們的例子里,勾選啟用編輯添加
ShowEditButton
屬性到現有的CommandField里:
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="False" DataKeyNames="ProductID" DataSourceID="ObjectDataSource1" EnableViewState="False">
<Columns>
<asp:CommandField ShowDeleteButton="True" ShowEditButton="True" />
... BoundFields removed for brevity ...
</Columns>
</asp:GridView>
就這樣就添加了根本的編輯支持。如圖16所示,編輯界面還比較粗糙–每一個非只讀的綁定列呈現為一個TextBox。這包括像
CategoryID
和
SupplierID
的字段,而它們是來自其它表的外鍵。
為了要求用戶直接編輯外鍵,這個編輯界面還缺少了以下途徑:
·
如果用戶輸入一個在數據庫中不存在的
CategoryID
或
SupplierID
,此更新將違反一個字段間的約束,引發一個異常。
·
這個編輯界面不包含任何數據驗證。如果你不提供一個必填的值(例如
ProductName
),或者在要求輸入數字的地方輸入一個字符串,將拋出一個異常。未來的章節里將研究如何在編輯的用戶界面中增加驗證控件(
給編輯和新增界面增加驗證控件
)。
·
通常,產品的所有非只讀字段都必須包含在GridView里。如果我們從GridView里剔除一列,比如說
UnitPrice
,當更新數據時GridView將不會設置
UnitPrice
UpdateParameters
的值,這將把該數據庫記錄的
UnitPrice
值更改為
NULL
值。類似地,如果一個必填的字段,例如
ProductName
,從GridView中被剔除了,那么這個更新將失敗,并出現一個上文中提及過的“
Column 'ProductName' does not allow nulls
”異常。
·
這個編輯界面遺留了許多必要的格式化的問題。
UnitPrice
顯示為四位小數。理想地
CategoryID
和
SupplierID
應該包含下拉列表(DropDownList),它列出系統中存在的類別和供應商。
我們不得不承認現在這還有許多缺點,但這些將在未來的章節里談及。
在DetailsView中插入、編輯和刪除數據
正如我們在之前的章節里看過的,DetailsView控件一次只顯示一條記錄,就像GridView一樣,它也允許對當前顯示的記錄進行編輯和刪除。不管是對最終用戶來說從DetailsView進行編輯和刪除的體驗,還是在ASP.NET這一面的工作流程,都跟GridView是一樣的。DetailsView和GridView不同的地方是,它還提供了內鍵的插入支持。
為了示范DetailsView的數據修改功能,首先,添加一個DetailsView控件到
Basics.aspx
頁面,放在現有的GridView的上方,并通過DetailsView的職能標記把它綁定到現有的ObjectDataSource。然后,清除DetailsView的
Height
和
Width
屬性,并從它的職能標記中勾選“啟用分頁”。為了啟用編輯、插入和刪除支持,只需要簡單地從它的職能標記里勾選上“啟用插入”、“啟用編輯”和“啟用刪除”。
與GridView一樣,添加編輯、插入或刪除支持會添加一個CommandField到該DetailsView,如下聲明語法所示:
<asp:DetailsView ID="DetailsView1" runat="server" AutoGenerateRows="False" DataKeyNames="ProductID"
DataSourceID="ObjectDataSource1" AllowPaging="True" EnableViewState="False">
<Fields>
<asp:BoundField DataField="ProductID" HeaderText="ProductID" InsertVisible="False"
ReadOnly="True" SortExpression="ProductID" />
<asp:BoundField DataField="ProductName" HeaderText="ProductName" SortExpression="ProductName" />
<asp:BoundField DataField="SupplierID" HeaderText="SupplierID" SortExpression="SupplierID" />
<asp:BoundField DataField="CategoryID" HeaderText="CategoryID" SortExpression="CategoryID" />
<asp:BoundField DataField="QuantityPerUnit" HeaderText="QuantityPerUnit" SortExpression="QuantityPerUnit" />
<asp:BoundField DataField="UnitPrice" HeaderText="UnitPrice" SortExpression="UnitPrice" />
<asp:BoundField DataField="UnitsInStock" HeaderText="UnitsInStock" SortExpression="UnitsInStock" />
<asp:BoundField DataField="UnitsOnOrder" HeaderText="UnitsOnOrder" SortExpression="UnitsOnOrder" />
<asp:BoundField DataField="ReorderLevel" HeaderText="ReorderLevel" SortExpression="ReorderLevel" />
<asp:CheckBoxField DataField="Discontinued" HeaderText="Discontinued" SortExpression="Discontinued" />
<asp:BoundField DataField="CategoryName" HeaderText="CategoryName" ReadOnly="True"
SortExpression="CategoryName" />
<asp:BoundField DataField="SupplierName" HeaderText="SupplierName" ReadOnly="True"
SortExpression="SupplierName" />
<asp:CommandField ShowDeleteButton="True" ShowEditButton="True" ShowInsertButton="True" />
</Fields>
</asp:DetailsView>
注意DetailsView的CommandField默認顯示在列集合的下方。因為DetailsView的字段是以行的方式呈現的,所以CommandField也表現為包含插入、編輯和刪除按鈕的一行,出現在DetailsView的下方。
點擊刪除按鈕就會開始與GridView相同的一系列的事件:一次回傳;隨之DetailsView基于
DataKeyNames
的值組成它的ObjectDataSOurce的
DeleteParameters
;最后以調用ObjectDataSource的
Delete()
方法結束,此方法從數據庫中刪除該產品的記錄。在DetailsView中編輯也以GridView同樣的方式運作。
為了插入數據,最終用戶面對的是一個“新建”按鈕,當點擊時,DetailsView呈現為“插入模式”。在“插入模式”下,新建按鈕被“插入”和“取消”按鈕取代,并且顯示那些
InsertVisible
屬性設置為
true
(默認)的綁定列。這些自增長標識的數據字段,例如
ProductID
字段,當通過職能標記綁定該DetailsView到數據源的時候讓它們的
InsertVisible
屬性設置為
false
。
當通過智能標記綁定數據源到DetailsView時,Visual Studio為自增長的字段設置其
InsertVisible
屬性為
false
。只讀的字段,像
CategoryName
和
SupplierName
,將顯示在“插入模式”下的用戶界面中,除非它們的
InsertVisible
屬性也明確地設置為
false
。稍稍花些時間把這兩個字段的
InsertVisible
屬性設置為
false
,通過DetailsView的聲明語法或者通過智能標記中的“編輯字段”鏈接。
在設置好
InsertVisible
屬性后,通過瀏覽器看看這個
Basics.aspx
頁面并點擊新建按鈕。圖20顯示的是添加一個新的飲料“Acme Tea”到我們的生產線時的DetailsView。
輸入Acme Tea的詳細信息并點擊插入按鈕后,隨之發生一次回傳并將這個新記錄添加到
Products
數據表。因為這個DetailsView是按照數據庫中的順序依次列出產品,所以我們必須翻到最后一頁才能看到這個新增加的產品。
注意:
DetailsView的
CurrentMode
屬性指示當前顯示的界面并可以被設置為下面幾個值之一:
Edit
、
Insert
或
ReadOnly
。
DefaultMode
屬性則指示DetailsView在完成一次編輯或插入之后顯示的模式,這在需要讓DetailsView保持編輯或插入模式不變時是很有用的。
DetailsView這個點擊插入和編輯的功能跟GridView有相同的局限性:用戶必須通過文本框輸入存在的
CategoryID
和
SupplierID
值;界面缺少任何驗證的邏輯;產品的所有不允許為
NULL
值或者沒有在數據庫中指定默認值的字段必須包含在插入界面里,等等。
在以后的章節里我們將會研究的擴展和提高GridView的編輯界面的技巧,同樣可以應用到DetailsView的編輯和插入界面。
使用FormView做一個更靈活的數據修改用戶界面
FormView控件提供內建的對插入、編輯和刪除數據的支持,不過因為它使用模版而不是列,它沒有地方讓我們添加像GridView和DetailsView控件提供給數據修改界面的綁定列和CommandField。取而代之的是,這個界面 – 收集新增一項或編輯現有項時用來收集用戶輸入的Web服務器控件,連同新增、編輯、刪除、插入、保存和取消按鈕 – 都必須手工添加到適當的模版里。幸運的是,Visual Studio將在通過它的職能標記的下拉列表綁定FormView到數據源時自動地創建需要的界面。
為了闡明這些技巧,首先,添加一個FormView控件到
Basics.aspx
頁面,并從FormView的職能標記,綁定它到已經存在的ObjectDataSource。這將為FormView生成一個
EditItemTemplate
、
InsertItemTemplate
和
ItemTemplate
,用TextBox服務器控件收集用戶的輸入并用Button服務器控件作為添加新增、編輯、刪除、插入、保存和取消按鈕。另外,FormView的
DataKeyNames
屬性被設置到ObjectDataSource所返回的對象的主鍵(
ProductID
)。最后,在FormView的職能標記中勾選“起用分頁”選項。
下面展示出FormView綁定到ObjectDataSource后它的
ItemTemplate
聲明標記。默認地,每一個除了布爾值以外的產品的字段都綁定到一個Label服務器控件的
Text
屬性,相應地布爾類型的字段(
Discontinued
)綁定到一個不可更改的CheckBox服務器控件的
Checked
屬性。為了讓新增、編輯和刪除按鈕點擊時能夠引發某個FormView行為,必要的工作是將它們的
CommandName
屬性的值分別設置為
New
、
Edit
和
Delete
。
<asp:FormView ID="FormView1" runat="server" DataKeyNames="ProductID" DataSourceID="ObjectDataSource1" AllowPaging="True" EnableViewState="False">
<EditItemTemplate>
...
</EditItemTemplate>
<InsertItemTemplate>
...
</InsertItemTemplate>
<ItemTemplate>
ProductID:
<asp:Label ID="ProductIDLabel" runat="server" Text='<%# Eval("ProductID") %>'></asp:Label><br />
ProductName:
<asp:Label ID="ProductNameLabel" runat="server" Text='<%# Bind("ProductName") %>'>
</asp:Label><br />
SupplierID:
<asp:Label ID="SupplierIDLabel" runat="server" Text='<%# Bind("SupplierID") %>'>
</asp:Label><br />
CategoryID:
<asp:Label ID="CategoryIDLabel" runat="server" Text='<%# Bind("CategoryID") %>'>
</asp:Label><br />
QuantityPerUnit:
<asp:Label ID="QuantityPerUnitLabel" runat="server" Text='<%# Bind("QuantityPerUnit") %>'>
</asp:Label><br />
UnitPrice:
<asp:Label ID="UnitPriceLabel" runat="server" Text='<%# Bind("UnitPrice") %>'></asp:Label><br />
UnitsInStock:
<asp:Label ID="UnitsInStockLabel" runat="server" Text='<%# Bind("UnitsInStock") %>'>
</asp:Label><br />
UnitsOnOrder:
<asp:Label ID="UnitsOnOrderLabel" runat="server" Text='<%# Bind("UnitsOnOrder") %>'>
</asp:Label><br />
ReorderLevel:
<asp:Label ID="ReorderLevelLabel" runat="server" Text='<%# Bind("ReorderLevel") %>'>
</asp:Label><br />
Discontinued:
<asp:CheckBox ID="DiscontinuedCheckBox" runat="server" Checked='<%# Bind("Discontinued") %>'
Enabled="false" /><br />
CategoryName:
<asp:Label ID="CategoryNameLabel" runat="server" Text='<%# Bind("CategoryName") %>'>
</asp:Label><br />
SupplierName:
<asp:Label ID="SupplierNameLabel" runat="server" Text='<%# Bind("SupplierName") %>'>
</asp:Label><br />
<asp:Link
發表評論
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索:z360901061

微信掃一掃加我為好友
QQ號聯系: 360901061
您的支持是博主寫作最大的動力,如果您喜歡我的文章,感覺我的文章對您有幫助,請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧,狠狠點擊下面給點支持吧,站長非常感激您!手機微信長按不能支付解決辦法:請將微信支付二維碼保存到相冊,切換到微信,然后點擊微信右上角掃一掃功能,選擇支付二維碼完成支付。
【本文對您有幫助就好】元

評論