常见 Datagrid 错误

常见 Datagrid 错误

摘要：学习如何避免在使用 ASP.NET Datagrid 控件进行开发时可能发生的一些常见错误（本文包含一些指向英文站点的链接）。

Datagrid 控件是 Microsoft® ASP.NET 中功能最强、用途最广的 Web 控件之一，这一点已经得到了 ASP.NET 权威人士的认同。虽然 Datagrid 控件易于使用，但同样易于给使用者带来麻烦。以下是许多人所犯的一些错误，这些人包括从初学者到富有经验的 .NET 专家。您可以看到许多苦闷的使用者在 ASP.NET 新闻组和论坛就这些错误提出问题。遵循本文概述的相当简单的步骤，可以帮助您避免这些错误，并节约大量的开发时间。

可以使用 Datagrid 创建列表数据而没有使用 
我知道您不会再使用如下所示的代码，但 ASP.NET 领域中许多守旧的用户仍在继续使用它们：

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 输出进行特殊的控制，您也可以在用户界面上记录集的内容重复出现的情况下，使用某个数据 Web 控件。

忘记在 Page_Load 事件中检查 IsPostBack 
最常见的错误之一是忘记在数据绑定之前检查页面的 IsPostBack 条件。例如，Datagrid 处于“Edit”（编辑）模式时，忽略该项检查将导致已编辑的值被数据源中的原始值覆盖。然而，该规则至少有一个主要的例外，请参阅持续使用大型 ViewState。

以下是包含 IsPostBack 检查的一个典型 Page_Load 事件。BindGrid() 是一个例程，用于导入并设置 Datagrid 的数据源，并调用 DataBind() 方法。

Sub Page_Load 
If Not IsPostBack Then 
BindGrid() 
End If 
End Sub 
需要更大的灵活性时，仍坚持使用自动生成的列 
如果 Datagrid 所处的环境需要任何一种特殊格式，或是需要使用 Datagrid 中的其他任何 Web 控件，那么必须关闭 AutoGenerateColumns。将 AutoGenerateColumns 属性的设置保持为“True”（默认设置）的做法，仅在最简单的 Datagrid 方案中有效。但对几乎所有实际的应用程序，必须将该属性设置为“False”，并在 Datagrid 声明的 <columns></columns> 段中明确地指定列。Microsoft Visual Studio&reg; .NET 用户可以使用属性生成器以图形化的方式创建这些列。

注意：如果将 AutoGenerateColumns 的设置保持为“True”，并且在 Datagrid 的 <columns> 段中指定了列，那么最终将得到对列的重复设置。系统将首先显示特别声明的列，随后是所有自动生成的列。 
尝试仅使用控件 ID 来引用 Datagrid 项目中的控件 
许多人没有认识到，对于 Datagrid 的 TemplateColumn 下的 ItemTemplate 中的控件（例如带有“MyTextBox”ID 的 TextBox 控件），不能在后面的代码或是在 ASPX 页面的 <script> 段中用如下所示的代码来直接调用该控件：

Dim MyValue As String = MyTextBox.Text 
该代码将导致可怕的“名称‘MyTextBox’没有声明”错误。

因为 Datagrid 是由多个行（项目）组成的，所以数据源中的每一行实际都会有一个单独的“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”值，需要对适当的 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 执行操作 
End Sub