ASP.NET中Datagrid經(jīng)常見出錯
發(fā)表時間:2024-02-02 來源:明輝站整理相關軟件相關文章人氣:
[摘要]摘要:學習如何避免在使用 ASP.NET Datagrid 控件進行開發(fā)時可能發(fā)生的一些常見錯誤。 Datagrid 控件是 Microsoft? ASP.NET 中功能最強、用途最廣的 Web 控件之一,這一點已經(jīng)得到了 ASP.NET 權威人士的認同。雖然 Datagrid 控件易于使用,...
摘要:學習如何避免在使用 ASP.NET Datagrid 控件進行開發(fā)時可能發(fā)生的一些常見錯誤。
Datagrid 控件是 Microsoft? ASP.NET 中功能最強、用途最廣的 Web 控件之一,這一點已經(jīng)得到了 ASP.NET 權威人士的認同。雖然 Datagrid 控件易于使用,但同樣易于給使用者帶來麻煩。以下是許多人所犯的一些錯誤,這些人包括從初學者到富有經(jīng)驗的 .NET 專家。您可以看到許多苦悶的使用者在 ASP.NET 新聞組和論壇就這些錯誤提出問題。遵循本文概述的相當簡單的步驟,可以幫助您避免這些錯誤,并節(jié)約大量的開發(fā)時間。
可以使用 Datagrid 創(chuàng)建列表數(shù)據(jù)而沒有使用 我知道您不會再使用如下所示的代碼,但 ASP.NET 領域中許多守舊的用戶仍在繼續(xù)使用它們:
Response.Write("<table>")
While MyDataReader.Read()
Response.Write("<tr>")
Response.Write("<td>")
Response.Write(MyDataReader(0))
Response.Write("</td>")
Response.Write("</tr>")
Loop
Response.Write("</table>")
可以對以上代碼進行簡化,使其僅為:
<asp:datagrid runat="server" datasource="MyDataReader"/>
并調用 .DataBind() 方法。即使需要對HTML輸出進行特殊的控制,您也可以在用戶界面上記錄集的內容重復出現(xiàn)的情況下,使用某個數(shù)據(jù) Web 控件。
忘記在 Page_Load 事件中檢查 IsPostBack 最常見的錯誤之一是忘記在數(shù)據(jù)綁定之前檢查頁面的 IsPostBack 條件。例如,Datagrid 處于“Edit”(編輯)模式時,忽略該項檢查將導致已編輯的值被數(shù)據(jù)源中的原始值覆蓋。然而,該規(guī)則至少有一個主要的例外,請參閱持續(xù)使用大型 ViewState。
以下是包含 IsPostBack 檢查的一個典型 Page_Load 事件。BindGrid() 是一個例程,用于導入并設置 Datagrid 的數(shù)據(jù)源,并調用 DataBind() 方法。
Sub Page_Load
If Not IsPostBack Then
BindGrid()
End If
End Sub
需要更大的靈活性時,仍堅持使用自動生成的列 如果 Datagrid 所處的環(huán)境需要任何一種特殊格式,或是需要使用 Datagrid 中的其他任何 Web 控件,那么必須關閉 AutoGenerateColumns。將 AutoGenerateColumns 屬性的設置保持為“True”(默認設置)的做法,僅在最簡單的 Datagrid 方案中有效。但對幾乎所有實際的應用程序,必須將該屬性設置為“False”,并在 Datagrid 聲明的 <columns></columns> 段中明確地指定列。Microsoft Visual Studio? .NET 用戶可以使用屬性生成器以圖形化的方式創(chuàng)建這些列。
注意:如果將 AutoGenerateColumns 的設置保持為“True”,并且在 Datagrid 的 <columns> 段中指定了列,那么最終將得到對列的重復設置。系統(tǒng)將首先顯示特別聲明的列,隨后是所有自動生成的列。
[page_break]
嘗試僅使用控件 ID 來引用 Datagrid 項目中的控件
許多人沒有認識到,對于 Datagrid 的 TemplateColumn 下的 ItemTemplate 中的控件(例如帶有“MyTextBox”ID 的 TextBox 控件),不能在后面的代碼或是在 ASPX 頁面的 <script> 段中用如下所示的代碼來直接調用該控件:
Dim MyValue As String = MyTextBox.Text
該代碼將導致可怕的“名稱‘MyTextBox’沒有聲明”錯誤。
因為 Datagrid 是由多個行(項目)組成的,所以數(shù)據(jù)源中的每一行實際都會有一個單獨的“MyTextBox”實例。ASP.NET 在每個控件的 ID 前面加上該控件層次結構中每個命名容器的 ID,這樣 Textbox 將具有唯一的 ID,與頁面中所有其他控件的 ID 都不相同。例如,如果 MyTextBox 處于 DataGrid1 中,那么生成的 ID 將是 DataGrid1:_ctl2:MyTextBox!癬ctl2”代表 MyTextBox 所處的當前行。頁面中其他 MyTextBox 實例的 ID 可能是 DataGrid1:_ctl3:MyTextBox、DataGrid1:_ctl4:MyTextBox 等等。要檢索需要查找的“MyTextBox”值,需要對適當?shù)?DataGridItem 調用 FindControl 方法。該 DataGridItem 用作 TextBox 的父命名容器。
HTML:
<asp:Datagrid runat="server" id="Datagrid1">
<Columns>
<asp:TemplateColumn>
<ItemTemplate>
<asp:TextBox runat="server" id="MyTextBox"/>
</ItemTemplate>
</asp:TemplateColumn>
</Columns>
代碼:
Sub DataGrid1_UpdateCommand(sender As Object, e As DataGridCommandEventArgs)
Dim MyValue As String = CType(e.Item.FindControl("MyTextBox"), TextBox).Text
'對 MyValue 執(zhí)行操作
End Sub
對 FindControl 調用的結果調用 CType,將會把返回值由 Object 類型強制轉換成 TextBox 類型,以訪問 .Text 屬性。
忘記在每個 Datagrid 事件中執(zhí)行 .DataBind() 調用,從而導致回發(fā)
一個常見的問題是:“當我點擊 Datagrid 某一行中的 Edit(編輯)鏈接時,頁面回發(fā),且不包含任何數(shù)據(jù)。這是什么錯誤?”問題在于數(shù)據(jù)僅在頁面第一次被調用時綁定到網(wǎng)格。在每個 Datagrid 事件(Edit、Update、Cancel、Page 或 Sort)中,請確保設置了 Datagrid 的 Datasource 屬性(除非已經(jīng)在 <asp:Datagrid> 聲明中通過聲明的方式進行了設置),并對 Datagrid 調用了 DataBind() 方法。
運行時不必要地在 Datagrid 中動態(tài)創(chuàng)建 Datagrid 控件或列
在某些業(yè)務和技術方案中,在運行時創(chuàng)建 ASP.NET 控件是必要的,也是完全合適的。例如,有時需要在選擇其他頁面選項后,才能在運行時確定用戶界面;蚴且獎(chuàng)建一個復合服務器控件,其中的每個子控件都需要動態(tài)創(chuàng)建,因為無法以聲明的方式創(chuàng)建這些子控件。如果遇到這些情況,請注意,提交頁面時不要保留這些動態(tài)控件。必須在頁面生命周期的早期,在每次回發(fā)時重新創(chuàng)建動態(tài)控件(例如在 Page_Init 事件中)。警言:創(chuàng)建控件要早,創(chuàng)建控件要勤。有關如何動態(tài)創(chuàng)建控件的詳細信息,請參閱 Microsoft Knowledge Base 文章 HOW TO:Dynamically Create Controls in ASP.NET with Visual Basic .NET。
然而,如果 Datagrid 應用程序中不是一定需要動態(tài)創(chuàng)建控件,請避免使用該技術,以免遇到麻煩。盡管可能創(chuàng)建動態(tài) Datagrid,但它們會引發(fā)各種事件,這通常都會令人頭疼。換句話說,不要動態(tài)創(chuàng)建控件,以避免因為創(chuàng)建控件使 ASPX 文件變得散亂。
[page_break]
持續(xù)使用大型 ViewState
Datagrid 控件會在頁面中添加大量的 ViewState,這一點令人討厭,因為這會導致呈現(xiàn)給用戶的頁面的總體大小急劇增加。要使頁面大小不增加,最簡單的方法是無論對整個頁面,還是單獨對某些特定的控件,都禁用 ViewState。例如,如果頁面不產生回發(fā),那么對整個頁面禁用 ViewState 是安全的。否則,請對兩次回發(fā)之間狀態(tài)信息不會發(fā)生更改的各個控件禁用 ViewState,或者對不需要隱藏字段來跟蹤自身狀態(tài)的那些控件禁用 ViewState。
對 Datagrid 控件或包含 Datagrid 的頁面禁用 ViewState 時,如果 Datagrid 會啟動回發(fā)事件,那么需要執(zhí)行一些特殊的步驟。首先,必須在每次回發(fā)時在 Page_Load 中重新綁定 Datagrid。這有違常規(guī)做法(以及上述第二個問題中的描述)。但如果禁用 ViewState,該步驟是必需的,這樣在執(zhí)行 Page_Load 后可以正確地引發(fā)其他 Datagrid 事件。如果要處理以下 Datagrid 事件中的任何一部分(或全部),那么還需要在 ViewState 中手動存儲一些 Datagrid 屬性。例如,在禁用了 ViewState 的 Datagrid 中進行編輯時,只要是在 Page_Load 中第一次綁定 Datagrid 之前重新存儲 EditItemIndex,且 Datagrid 處于編輯模式,那么只需將 EditItemIndex 儲存到 ViewState 就夠了。
表 1:Datagrid 事件與 ViewState 的依賴關系
事件 | 是否依賴于 ViewState? | 要存儲在 ViewState 中的字段 |
ItemCreated | | 無 |
ItemDataBound | | 無 |
SortCommand | 是 | SortExpression |
EditCommand | 是 | EditItemIndex |
PageIndexChanged | 是 | CurrentPageIndex |
SelectedIndexChanged | | 無 |
清單 1:啟用編輯、排序和分頁,但禁用 ViewState 的 Datagrid 的示例代碼。
Sub Page_Load
If Not ViewState("EditItemIndex") Is Nothing Then
Datagrid1.EditItemIndex = ViewState("EditItemIndex")
End If
If Not ViewState("CurrentPageIndex") Is Nothing Then
Datagrid1.CurrentPageIndex = ViewState("CurrentPageIndex")
End If
BindGrid()
End Sub
Sub BindGrid()
Dim DV As DataView
DV = GetDataSource()
DV.Sort = ViewState("SortExpression")
Datagrid1.DataSource = DV
Datagrid1.DataBind()
End Sub
Sub Datagrid1_SortCommand(s As Object, e As DataGridSortCommandEventArgs)
ViewState("SortExpression") = e.SortExpression
BindGrid()
End Sub
Sub Datagrid1_EditCommand(s As Object, e As DatagridCommandEventArgs)
Datagrid1.EditItemIndex = e.Item.ItemIndex
ViewState("EditItemIndex") = e.Item.ItemIndex
BindGrid()
End Sub
Sub Datagrid1_PageIndexChanged(s as Object, e As DataGridPageChangedEventArgs)
Datagrid1.CurrentPageIndex = e.NewPageIndex
ViewState("CurrentPageIndex") = e.NewPageIndex
BindGrid()
End Sub
使用 ItemDataBound 或 ItemCreated 事件時,忘記檢查適當?shù)?ListItemType
Datagrid 控件對每個數(shù)據(jù)行引發(fā)兩個事件。首次將每行添加到 Datagrid 時將引發(fā) ItemCreated 事件,將數(shù)據(jù)綁定到每行時將引發(fā) ItemDataBound 事件。添加單元格到 Datagrid 的表格輸出時,這些事件可以用于控制每個單元格的外觀或內容。例如,可以基于數(shù)值的范圍修改單元格的背景顏色。但關鍵是要記住,這些事件的引發(fā)針對的是所有 Datagrid 項目類型,包括頁眉、頁腳和分頁程序項目。如果執(zhí)行 ItemDataBound 事件期間,沒有在引用項目的數(shù)據(jù)之前仔細檢查項目類型,第一個項目(通常是標題行)就將發(fā)生錯誤。如果 Datagrid 啟用了分頁,且將其設置為在頂端顯示,那么第一個項目就會成為分頁程序項目。以下示例代碼顯示如何在引用項目數(shù)據(jù)之前進行正確的 ListItemType 檢查。不要忘了 AlternatingItem!
Sub DataGrid1_ItemDataBound(source As Object,e As DataGridItemEventArgs)
If (e.Item.ItemType = ListItemType.Item Or e.Item.ItemType = ListItemType.AlternatingItem) Then
If e.Item.DataItem("ForumDate") < DateTime.Today Then
e.Item.Cells(1).BackColor =System.Drawing.Color.FromName("#ffccff")
End If
End If
End Sub
需要對生成的 HTML 有更多的控制時,過多地使用了 Datagrid(Repeater 也許是更好的選擇) 如果懶散的程序員喜歡 Datagrid 控件(因為 Datagrid 控件為他們完成了很多工作),那么有著極強控制欲的程序員必定喜歡 Repeater 控件。如果需要或希望完全控制創(chuàng)建的所有 HTML,請使用 Repeater 控件,它能幫助您完成該任務。Repeater 控件在性能上也略占優(yōu)勢,因為它不像 Datagrid 控件的所有內置功能那樣占用系統(tǒng)資源。也可以考慮使用折衷的 DataList 控件,它具備編輯和排序功能,同時還具有在一行內重復顯示記錄的功能。