.NET Framework 类库 GridView 类

"SelectedValue")> _
Public Class GridView
Inherits CompositeDataBoundControl
Implements IPostBackContainer, IPostBackEventHandler, ICallbackContainer, ICallbackEventHandler

Dim instance As GridView

[ControlValuePropertyAttribute("SelectedValue")] 
public class GridView : CompositeDataBoundControl, IPostBackContainer, IPostBackEventHandler, ICallbackContainer, 
ICallbackEventHandler

[ControlValuePropertyAttribute(L"SelectedValue")] 
public ref class GridView : public CompositeDataBoundControl, IPostBackContainer, IPostBackEventHandler, ICallbackContainer, 
ICallbackEventHandler

/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public class GridView extends CompositeDataBoundControl implements IPostBackContainer, IPostBackEventHandler, 
ICallbackContainer, ICallbackEventHandler

ControlValuePropertyAttribute("SelectedValue") 
public class GridView extends CompositeDataBoundControl implements IPostBackContainer, IPostBackEventHandler, 
ICallbackContainer, ICallbackEventHandler

GridView 控件中的每一列由一个 DataControlField 对象表示。默认情况下，AutoGenerateColumns 属性被设置为 true，为数据源中的每一个字段创建一个 AutoGeneratedField 对象。每个字段然后作为 GridView 控件中的列呈现，其顺序同于每一字段在数据源中出现的顺序。

通过将 AutoGenerateColumns 属性设置为 false，然后定义您自己的列字段集合，您也可以手动控制哪些列字段将显示在 GridView 控件中。不同的列字段类型决定控件中各列的行为。下表列出了可以使用的不同列字段类型。

若要以声明方式定义列字段集合，请首先在 GridView 控件的开始和结束标记之间添加 开始和结束标记。接着，列出您想包含在 开始和结束标记之间的列字段。指定的列将以所列出的顺序添加到 Columns 集合中。Columns 集合存储该控件中的所有列字段，并允许您以编程方式管理 GridView 控件中的列字段。

显式声明的列字段可与自动生成的列字段结合在一起显示。两者同时使用时，先呈现显式声明的列字段，再呈现自动生成的列字段。

注意
自动生成的列字段不会添加到 Columns 集合中。

GridView 控件可绑定到数据源控件（如 SqlDataSource、ObjectDataSource 等等）,以及实现 System.Collections.IEnumerable 接口的任何数据源（如 System.Data.DataView、System.Collections.ArrayList 或 System.Collections.Hashtable）。使用以下方法之一将 GridView 控件绑定到适当的数据源类型：

• 若要绑定到某个数据源控件，请将 GridView 控件的 DataSourceID 属性设置为该数据源控件的 ID 值。GridView 控件自动绑定到指定的数据源控件，并且可利用该数据源控件的功能来执行排序、更新、删除和分页功能。这是绑定到数据的首选方法。

• 若要绑定到某个实现 System.Collections.IEnumerable 接口的数据源，请以编程方式将 GridView 控件的 DataSource 属性设置为该数据源，然后调用 DataBind 方法。当使用此方法时，GridView 控件不提供内置的排序、更新、删除和分页功能。需要使用适当的事件提供此功能。

有关数据绑定的更多信息，请参见 通过 ASP.NET 访问数据。

注意
此控件可用来显示用户输入，而该输入可能包含恶意的客户端脚本。在应用程序中显示从客户端发送来的任何信息之前，请检查它们是否包含可执行脚本、SQL 语句或其他代码。只要有可能，强烈建议在这些值显示在此控件中之前对它们进行 HTML 编码（默认情况下，BoundField 类会对值进行 HTML 编码）。ASP.NET 提供输入请求验证功能以阻止用户输入中的脚本和 HTML。还提供验证服务器控件以判断用户输入。有关更多信息，请参见 验证控件介绍。

GridView 控件提供了很多内置功能，这些功能使得用户可以对控件中的项进行排序、更新、删除、选择和分页。当 GridView 控件绑定到某个数据源控件时，GridView 控件可利用该数据源控件的功能并提供自动排序、更新和删除功能。

注意
GridView 控件可为其他类型的数据源提供对排序、更新和删除的支持；但是，您必须提供一个适当的事件处理程序，其中包含对这些操作的实现。

排序允许用户通过单击某个特定列的标题来根据该列排序 GridView 控件中的项。若要启用排序，请将 AllowSorting 属性设置为 true。

当单击 ButtonField 或 TemplateField 列字段中命令名分别为“Edit”、“Delete”和“Select”的按钮时，自动更新、删除和选择功能启用。如果 AutoGenerateEditButton、AutoGenerateDeleteButton 或 AutoGenerateSelectButton 属性分别设置为 true 时，GridView 控件可自动添加带有“编辑”、“删除”或“选择”按钮的 CommandField 列字段。

注意
GridView 控件不直接支持将记录插入数据源。但是，通过将 GridView 控件与 DetailsView 或 FormView 控件结合使用则可以插入记录。有关更多信息，请分别参见 DetailsView 或 FormView。

GridView 控件可自动将数据源中的所有记录分成多页，而不是同时显示这些记录。若要启用分页，请将 AllowPaging 属性设置为 true。

您可以通过设置 GridView 控件的不同部分的样式属性自定义该控件的外观。下表列出了不同的样式属性。

也可以显示或隐藏控件的不同部分。下表列出控制显示或隐藏哪些部分的属性。

GridView 控件提供多个您可以对其进行编程的事件。这使您可以在每次发生事件时都运行一个自定义例程。下表列出了 GridView 控件支持的事件。

默认情况下为此控件呈现的标记可能不符合 Web 内容辅助功能准则 1.0 (WCAG) 中优先级为 1 的准则等辅助功能标准。有关此控件的辅助功能支持的详细信息，请参见 ASP.NET 控件和辅助功能。

Visual Basic

复制代码

<%@ Page language="VB" %>


"server">
GridView Example
"CustomersGridView" 
datasourceid="CustomersSource" 
autogeneratecolumns="true"
emptydatatext="No data available." 
allowpaging="true" 
runat="server">                





"CustomersSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
runat="server"/>

C#

复制代码

<%@ Page language="C#" %>


"server">
GridView Example
"CustomersGridView" 
datasourceid="CustomersSource" 
autogeneratecolumns="true"
emptydatatext="No data available." 
allowpaging="true" 
runat="server">                





"CustomersSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
runat="server"/>

Visual Basic

复制代码

<%@ Page language="VB" %>


"server">
GridView Edit Example




"CustomersGridView" 
datasourceid="CustomersSqlDataSource" 
autogeneratecolumns="true"
autogeneratedeletebutton="true"
autogenerateeditbutton="true"
datakeynames="CustomerID"  
runat="server">





"CustomersSqlDataSource"  
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
deletecommand="Delete from Customers where CustomerID = @CustomerID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">

C#

复制代码

<%@ Page language="C#" %>


"server">
GridView Edit Example




"CustomersGridView" 
datasourceid="CustomersSqlDataSource" 
autogeneratecolumns="true"
autogeneratedeletebutton="true"
autogenerateeditbutton="true"
datakeynames="CustomerID"  
runat="server">





"CustomersSqlDataSource"  
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
deletecommand="Delete from Customers where CustomerID = @CustomerID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">

参考

其他资源