GridView.AutoGenerateColumns 属性
public virtual bool AutoGenerateColumns { get; set; }
属性值
true 表示为数据源中的每个字段自动创建绑定字段;否则为 false。默认为 true。
当 AutoGenerateColumns 属性设置为 true 时,为数据源中的每个字段自动创建一个 AutoGeneratedField 对象。然后每一字段作为 GridView 控件中的一列显示,其顺序是数据源中字段出现的顺序。此选项提供了一种显示数据源中各字段的便捷方法;但是,您只能有限地控制自动生成的列字段的显示方式或行为方式。
注意 |
---|
自动生成的绑定列字段不会添加到 Columns 集合中。 |
通过将 AutoGenerateColumns 属性设置为 false,然后创建自定义的 Columns 集合,您可以手动定义列字段,而不是让 GridView 控件自动生成列字段。除了绑定列字段外,您还可以显示按钮列字段、复选框列字段、命令字段、超链接列字段、图像字段或基于您自己的自定义模板的列字段。有关更多信息,请参见 Columns。
注意 |
---|
显式声明的列字段可与自动生成的列字段结合使用。两者同时使用时,先呈现显式声明的列字段,再呈现自动生成的列字段。 |
<%@ Page language="C#" %>
<html>
<body>
<form runat="server">
<h3>GridView Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
emptydatatext="No data available."
allowpaging="true"
runat="server">
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>