C# ASP.NET GridView 获取单元格与模板列值的几种方法

沈知远

发布时间：2026-10-15 | 1人浏览过

原创

在C# ASP.NET WebForms开发中，经常需要在后台代码中获取GridView控件内用户输入或显示的数据。根据列的类型不同（是普通绑定列还是模板列），获取值的方式有所区别。本文将详细说明如何使用C#代码安全、准确地提取GridView中的文本值和自定义控件内容。

1. 准备环境：GridView基本结构

在实际应用中，我们通常会在aspx页面定义一个GridView控件。为了演示取值逻辑，假设我们的GridView包含ID、名称以及一个供用户输入的模板列。以下是一个典型的配置示例：

<asp:GridView ID="GridViewlb" runat="server" AutoGenerateColumns="False"
    DataKeyNames="id" PageSize="26" AllowPaging="True">
    <Columns>
        <asp:BoundField DataField="id" HeaderText="编号" />
        <asp:BoundField DataField="name" HeaderText="名称" />
        <!-- 模板列：包含一个TextBox用于输入 -->
        <asp:TemplateField HeaderText="备注">
            <ItemTemplate>
                <asp:TextBox ID="txtRemark" runat="server" >
            </ItemTemplate>
        </asp:TemplateField>
    </Columns>
</asp:GridView>

2. 操作核心：区分列类型获取值

第1步：非模板列（BoundField）取值

如果你的列是直接绑定数据库字段的 BoundField，或者不包含复杂控件，可以直接通过行（Row）和单元格（Cell）的索引来获取文本。

入口/前提：确保已经选定了具体的行（Row）。
动作：访问该行的指定列单元格。
参数说明：注意列索引从0开始。
代码实现：

// 假设获取第0行，第1列（名称列）的值
string str = this.GridViewlb.Rows[0].Cells[1].Text.Trim();

完成判断：变量 str 即为该单元格显示的纯文本内容。

第2步：模板列（TemplateField）中包含TextBox取值

当列中包含服务器控件（如 TextBox、DropDownList 等）时，直接读 Cells[n].Text 可能无法获取到用户最新输入的内容，或者内容为空。必须使用 FindControl 方法找到控件实例。

入口/前提：确定所在的行号（RowIndex）。
动作：遍历该行，查找指定ID的控件，并进行类型转换。
重要参数：GridViewRow.FindControl("控件ID") 返回的是 Control 基类对象。
完整代码示例：

// 获取某一行（例如第 i 行）中 ID 为 "txtRemark" 的 TextBox 的值
protected void GetValueFromTemplate(int rowIndex)
{
    // 1. 获取对应的行
    GridViewRow row = this.GridViewlb.Rows[rowIndex];

    // 2. 通过 FindControl 寻找 TextBox 控件
    // 注意：必须将返回的 Control 转换为 TextBox 类型
    TextBox txtBox = (TextBox)row.FindControl("txtRemark");

    // 3. 判空检查（防止找不到控件导致异常）
    if (txtBox != null)
    {
        string value = txtBox.Text.Trim();
        // 此处可以使用 value 进行后续逻辑处理
    }
}

第3步：通过选中行获取当前值（常用场景）

在用户点击按钮触发事件时，往往需要获取当前点击行或选中行的数据。可以使用 SelectedIndexChanged 事件或按钮命令事件。

protected void btnSubmit_Click(object sender, EventArgs e)
{
    // 方式A：如果使用的是 RowCommand，可以通过 e.CommandArgument 获取行索引
    // 方式B：简单遍历所有可见行
    foreach (GridViewRow row in this.GridViewlb.Rows)
    {
        // 跳过页脚等非数据行
        if (row.RowType == DataControlRowType.DataRow)
        {
            TextBox tb = (TextBox)row.FindControl("txtRemark");
            if (tb != null && !string.IsNullOrEmpty(tb.Text))
            {
                Console.WriteLine($"第 {row.RowIndex} 行数据为: {tb.Text}");
            }
        }
    }
}

3. 避坑指南与常见问题

常见错误 1：Cast exception（类型转换失败）

在使用 (TextBox)FindControl() 时，如果 FindControl 没找到名为 “textBox1” 的控件，会返回 null，强制转换不会报错，但访问 .Text 会报 NullReferenceException。务必先判空。

常见错误 2：异步更新导致的取不到值

如果GridView位于UpdatePanel中且开启了部分更新，确保在提交前页面状态已同步。通常在Button Click事件中，只要不是回滚了ViewState，都能正常获取。TextBox 的值在 PostBack 后会自动维护。

4. 总结

在C# WebForms开发中，获取GridView值是基础但关键的操作。请记住核心原则：非模板列直接读 Cells.Text，模板列用 FindControl 找控件。在处理模板列时，一定要做好空值检查，以防止因控件缺失引发的运行时错误。以上就是C# GridView 获取单元格及控件值的详细内容，更多关于 ASP.NET 数据绑定优化的资料请关注本站其它相关文章！