通过

“DataGrid 属性”对话框 ->“列”

  • 项目

更新：2007 年 11 月

使用“DataGrid 属性”对话框的“列”选项卡可以执行以下操作：

  • 指定网格中显示的数据列。

  • 定义用于特定功能（例如编辑和选择项）的列。

  • 定义模板列。

  • 指定各个列的特定于列的信息，例如排序表达式和命令名。

  • 定义网格中每个列的标头和脚注、内容和数据绑定。

定义列之后，即可设置其属性。“列”选项卡上的可用选项取决于正在处理的 DataGrid 列的类型。

说明：

ASP.NET 2.0 版带有一个新的服务器控件 GridView，该控件的功能比 DataGrid 控件更丰富。有关更多信息，请参见 比较 GridView 和 DataGrid Web 服务器控件。

访问此对话框

  1. 在 Microsoft Visual Web Developer 中，打开或创建 .aspx 页。

  2. 在“源”视图中，将 DataGrid 控件添加到 <form> 元素中的页面。您的代码可能类似于：

    <form id="form1" runat="server">
    <div>
    <asp:DataGrid ID="DataGrid1" runat="server"></asp:DataGrid>
    </div>
</form>

  3. 切换到“设计”视图。

  4. 右击“DataGrid”控件，然后单击“显示智能标记”。

    “DataGrid 任务”窗口随即打开。

  5. 单击“属性生成器”。

    “DataGrid 属性”对话框随即打开。

  6. 单击“列”选项卡。

任务

用户界面元素

  • 在运行时自动创建列
    指定网格在运行时是否包含了所绑定的数据源的所有数据字段。无法移除这些列或设置其格式。

    可以添加列（同时包括数据绑定列和按钮）、超链接和模板列，这将在下面的“列列表”节中说明。所有添加的列都将显示在自动生成的列的左侧。

列列表

列列表用于指定网格中显示的列。可以添加数据源中的字段和各种类型的按钮。

若要添加列，请在“可用列”下面选择列的类型，然后单击“添加”按钮，将其添加到“选定的列”列表中。若要指定列在网格中的位置，请在“选定的列”列表中选择它，然后使用重新排序按钮移动它。若要从网格中移除列，请在“选定的列”列表中选择它，然后单击“删除”按钮。

  • 可用列
    列出网格可以显示的所有列，分为以下节点：

    • 绑定列   用于添加单个数据列，这些数据列来自在“常规”选项卡上选定的数据源中的那些可用列。

      如果选中了“在运行时自动创建列”，则显示该节点中的所有列。若要只显示部分列，请清除“在运行时自动创建列”，并添加要使用的数据字段。

    • 按钮列   用于添加将包含按钮（命令按钮或链接按钮）的列，用户可以单击这些按钮对单个项执行特定操作。展开“按钮列”节点，将“选择”、“删除”或“编辑”按钮添加到网格中。若要添加自定义按钮（如“添加到购物车”按钮），请选择“按钮列”节点，单击“添加”按钮，然后设置该自定义按钮的格式。

    • 超链接列   用于添加将要包含指向其他页的链接的列。超级链接列可以包含静态文本，或将数据列显示为超级链接。

    • 模板列   用于创建包含 HTML 文本与控件的任意组合的列。模板列使您可以包括除 DataGrid 控件中的按钮（如复选框）以外的控件。

  • 选定的列
    列出可以自定义的列。选定此列表中的某一列时，对话框中该列下面的选项会发生变化，以反映可以用于该列的自定义设置。

    如果选中“在运行时自动创建列”，则“选定的列”中会显示除了自动生成的列外另外显示的列。

列属性

  • 页眉文本
    在列的顶部显示的文本。页眉值可以设置为任何 HTML 文本（包括标记）。可以在“格式”选项卡上指定页眉的字体和颜色。

    为页眉指定的文本将成为“选定的列”列表中列的标识符。

    仅当在“常规”选项卡上选中“显示页眉”复选框后才会显示页眉。

  • 页脚文本
    在列的底部显示的文本。默认情况下，该文本为空白。页脚值可以设置为任何 HTML 文本（包括标记）。可以在“格式”选项卡上指定页眉的字体和颜色。

    仅当在“常规”选项卡上选中“显示页脚”复选框后才会显示页脚。

  • 页眉图像
    显示在列顶部的图像文件的 URL。如果同时指定了页眉文本和页眉图像，则页眉图像优先。

  • 排序表达式
    发生 SortCommand 事件时作为参数传递的字符串。通常，您会在 “常规”选项卡 上选择“允许排序”复选框，这将使列页眉呈现为 LinkButton 控件，单击该控件会引发 SortCommand 事件。

    对于绑定列，默认的排序表达式是与该列绑定的数据字段的名称。但是，您可以指定任何字符串。

  • 可见
    指示运行页时列是否默认为可见。如果清除此复选框，则可以定义一个列，并指定其绑定信息和格式设置信息，然后在运行时动态显示和隐藏该列。

BoundColumn 属性

如果选择“可用列”中的“绑定列”然后单击箭头按钮将其移至“选定的列”，将显示“BoundColumn 属性”下的选项。

  • 数据字段
    绑定与该列的数据字段的名称。只读。

  • 数据格式设置表达式
    .NET Framework 格式设置表达式，它在数据显示在列中之前先应用于数据。此表达式由可选静态文本和用以下格式表示的格式说明符组成：

    {0:format specifier}

    冒号 (:) 前面的数字是参数索引，它指示列中要格式化的数据元素；因此，通常用它来指示第一个（且唯一的）元素。冒号后面是格式说明符，它由一个或多个字母组成，指示如何设置数据的格式。可以使用的格式说明符取决于要格式化的数据类型：日期、数字或其他类型。下表显示了不同数据类型的格式设置表达式的示例。有关格式设置表达式的更多信息，请参见格式化类型。

    格式设置表达式

    应用于此数据类型

    说明

    Price: {0:C}

    numeric/decimal

    显示字符串“Price:”，后跟以货币格式表示的数字。货币格式取决于通过 @ Page 指令或 Web.config 文件中的 culture 属性指定的区域性设置。

    {0:D4}

    integer（不能和小数一起使用。）

    在由零填充的四个字符宽的字段中显示整数。

    {0:N2}%

    numeric

    显示精确到小数点后两位的数字，后跟字符串“%”。

    {0:000.0}

    numeric/decimal

    四舍五入到小数点后一位的数字。不到三位的数字用零填充。

    {0:D}

    date/datetime

    长日期格式（“Thursday, August 06, 1996”）。日期格式取决于页或 Web.config 文件的区域性设置。

    {0:d}

    date/datetime

    短日期格式（“12/31/99”）。

    {0:yy-MM-dd}

    date/datetime

    用数字的年－月－日表示的日期（96-08-06）。

  • 只读
    指示当此列处于编辑模式时，此列中的数据是否显示在可编辑的控件中。

ButtonColumn 属性

如果选择“可用列”中的“按钮列”并单击箭头按钮将其移至“选定的列”，将显示“ButtonColumn 属性”下的选项。

  • 文本
    如果网格中每一项的按钮都显示相同的文本，那么这将是这些按钮的文本（标题）。例如，如果要定义一个对网格中的每一项都显示单词“Select”的按钮，则应当设置“文本”属性。如果设置了“文本字段”属性，它将重写此属性。

  • 命令名
    用户单击按钮时与 ItemCommand 事件一起传递的字符串。

  • 文本字段
    将用作按钮标题的源的数据源字段。如果同时设置了此属性和“文本”属性，“文本字段”属性优先。

  • 按钮类型
    呈现的按钮类型 —“LinkButton”或“PushButton”。默认为 LinkButton 控件。

  • 文本格式字符串
    在显示按钮标题之前应用于该按钮标题的 .NET Framework 格式设置表达式。如果使用“文本字段”属性设置按钮标题，但数据的格式不适合于显示，则可以使用此属性。有关详细信息，请参见上面的“BoundColumn 属性”。

EditCommandColumn 属性

如果在“选定的列”中选定了一个“编辑”按钮列，将显示“EditButtonColumn 属性”下的选项。

  • 编辑文本
    在“编辑”按钮的表面上显示的字符串。

  • 取消文本
    在“取消”按钮的表面上显示的字符串。

  • 更新文本
    在“更新”按钮的表面上显示的字符串。

  • 按钮类型
    呈现的按钮类型 —“LinkButton”或“PushButton”。默认为 LinkButton 控件。

HyperLinkColumn 属性

如果选择“可用列”中的“超链接列”并单击箭头按钮将其移至“选定的列”，将显示“HyperLinkColumn 属性”下的选项。

  • 文本
    如果网格中每一项的链接都有相同的文本，则该属性为此超级链接的文本。

  • URL
    跳转目标页的 URL。如果设置了“URL 字段”，它将重写此属性。

  • 文本字段
    要用作超级链接文本的源的数据源字段。

  • URL 字段
    DataSource 中的对象的字段或属性，它提供跳转至的页面的 URL。此属性将重写“URL”设置。

  • 文本格式字符串
    在显示超链接之前应用于超链接的 .NET Framework 格式设置说明符。如果使用“文本字段”属性设置超链接文本，但数据的格式不适合于显示，则可以使用此属性。有关详细信息，请参见上面的“BoundColumn 属性”。

  • URL 格式字符串
    指定如何设置 URL 格式的表达式。该表达式可以包含 .NET Framework 格式设置表达式。例如，可能使用以下 URL 格式：

    images/Title-{0}.gif

    此格式可能产生以下 URL：

    images/Title-1.gif

    有关详细信息，请参见上面的“BoundColumn 属性”。

  • 目标
    显示该按钮列的窗口。输入运行时存在的窗口的名称，或从预定义的标准窗口标识符列表中选择。

  • 将此列转换为模板列
    重新创建选定列以用作模板，模板是 HTML 文本和控件的组合。使用此属性可以非常精确地指定列的外观。

请参见

概念

比较 GridView 和 DataGrid Web 服务器控件