DataGrid 类

参考

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

数据绑定列表控件，此控件显示来自表中数据源中的项。 DataGrid 控件使你可以选择、排序以及编辑这些项。

public ref class DataGrid : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer

public class DataGrid : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer

type DataGrid = class
    inherit BaseDataList
    interface INamingContainer

Public Class DataGrid
Inherits BaseDataList
Implements INamingContainer

继承: Object

Control

WebControl

BaseDataList
DataGrid

实现: INamingContainer

示例

下面的代码示例演示如何使用 DataGrid 控件显示数据源中的项。

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="VB" runat="server">
     Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
 
  </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

下面的代码示例演示如何对 DataGrid 简单的购物车使用控件。

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="C#" runat="server">
 
      DataTable Cart;
      DataView CartView;
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
     
         if (Session["DG4_ShoppingCart"] == null) 
         {
            Cart = new DataTable();
            Cart.Columns.Add(new DataColumn("Item", typeof(string)));
            Cart.Columns.Add(new DataColumn("Price", typeof(string)));
            Session["DG4_ShoppingCart"] = Cart;
         }

         else 
         {
            Cart = (DataTable)Session["DG4_ShoppingCart"];
         }    

         CartView = new DataView(Cart);
         ShoppingCart.DataSource = CartView;
         ShoppingCart.DataBind();
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
      void Grid_CartCommand(Object sender, DataGridCommandEventArgs e) 
      {
     
         DataRow dr = Cart.NewRow();
         
         // e.Item is the table row where the command is raised.
         // For bound columns, the value is stored in the Text property of the TableCell.
         TableCell itemCell = e.Item.Cells[2];
         TableCell priceCell = e.Item.Cells[3];
         string item = itemCell.Text;
         string price = priceCell.Text;
          
         if (((Button)e.CommandSource).CommandName == "AddToCart") 
         {
            dr[0] = item;
            dr[1] = price;
            Cart.Rows.Add(dr);
         }

         else 
         {  

            // Remove from Cart.
         
            CartView.RowFilter = "Item='" + item + "'";
            if (CartView.Count > 0) 
            {     
               CartView.Delete(0);
            }
            CartView.RowFilter = "";
         }

         ShoppingCart.DataBind();
 
      }
 
 
   </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
   <h3>DataGrid Example</h3>
 
   <table cellpadding="5">
      <tr valign="top">
         <td>
 
            <b>Product List</b>
 
            <asp:DataGrid id="ItemsGrid"
                 BorderColor="black"
                 BorderWidth="1"
                 CellPadding="3"
                 AutoGenerateColumns="false"
                 OnItemCommand="Grid_CartCommand"
                 runat="server">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>
 
               <Columns>
 
                  <asp:ButtonColumn 
                       HeaderText="Add to cart" 
                       ButtonType="PushButton" 
                       Text="Add" 
                       CommandName="AddToCart" />
 
                  <asp:ButtonColumn 
                       HeaderText="Remove from cart" 
                       ButtonType="PushButton" 
                       Text="Remove" 
                       CommandName="RemoveFromCart" />
 
                  <asp:BoundColumn 
                       HeaderText="Item" 
                       DataField="StringValue"/>

                  <asp:BoundColumn 
                       HeaderText="Price" 
                       DataField="CurrencyValue" 
                       DataFormatString="{0:c}">

                     <ItemStyle HorizontalAlign="right">
                     </ItemStyle>

                  </asp:BoundColumn>   
 
               </Columns>
 
            </asp:DataGrid>
 
         </td>
         <td>
 
            <b>Shopping Cart</b>
 
            <asp:DataGrid id="ShoppingCart" 
                 runat="server"
                 BorderColor="black"
                 BorderWidth="1"
                 GridLines="Both"
                 ShowFooter="false"
                 CellPadding="3"
                 CellSpacing="0">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

            </asp:DataGrid> 
 
         </td>
      </tr>
 
   </table>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="VB" runat="server">
 
      Dim Cart As DataTable
      Dim CartView As DataView
      
        Function CreateDataSource() As ICollection
            Dim dt As New DataTable()
            Dim dr As DataRow
            
            dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
            dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
            dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
            
            Dim i As Integer
            For i = 0 To 8
                dr = dt.NewRow()
                
                dr(0) = i
                dr(1) = "Item " + i.ToString()
                dr(2) = 1.23 *(i + 1)
                
                dt.Rows.Add(dr)
            Next i
            
            Dim dv As New DataView(dt)
            Return dv
        End Function 'CreateDataSource


        Sub Page_Load(sender As Object, e As EventArgs)
            
            If Session("DG4_ShoppingCart") Is Nothing Then
                Cart = New DataTable()
                Cart.Columns.Add(New DataColumn("Item", GetType(String)))
                Cart.Columns.Add(New DataColumn("Price", GetType(String)))
                Session("DG4_ShoppingCart") = Cart
            
            Else
                Cart = CType(Session("DG4_ShoppingCart"), DataTable)
            End If
            
            CartView = New DataView(Cart)
            ShoppingCart.DataSource = CartView
            ShoppingCart.DataBind()
            
            If Not IsPostBack Then
                ' Load this data only once.
                ItemsGrid.DataSource = CreateDataSource()
                ItemsGrid.DataBind()
            End If
        End Sub 'Page_Load


        Sub Grid_CartCommand(sender As Object, e As DataGridCommandEventArgs)
            
            Dim dr As DataRow = Cart.NewRow()
            
            ' e.Item is the table row where the command is raised.
            ' For bound columns, the value is stored in the Text property of the TableCell.
            Dim itemCell As TableCell = e.Item.Cells(2)
            Dim priceCell As TableCell = e.Item.Cells(3)
            Dim item As String = itemCell.Text
            Dim price As String = priceCell.Text
            
            If CType(e.CommandSource, Button).CommandName = "AddToCart" Then
                dr(0) = item
                dr(1) = price
                Cart.Rows.Add(dr)
            
            Else 

                'Remove from Cart.
                CartView.RowFilter = "Item" + ChrW(61) + "'" + item + "'"
                If CartView.Count > 0 Then
                    CartView.Delete(0)
                End If
                CartView.RowFilter = ""
            End If
            
            ShoppingCart.DataBind()
        End Sub 'Grid_CartCommand 
   </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
   <h3>DataGrid Example</h3>
 
   <table cellpadding="5">
      <tr valign="top">
         <td>
 
            <b>Product List</b>
 
            <asp:DataGrid id="ItemsGrid"
                 BorderColor="black"
                 BorderWidth="1"
                 CellPadding="3"
                 AutoGenerateColumns="false"
                 OnItemCommand="Grid_CartCommand"
                 runat="server">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>
 
               <Columns>
 
                  <asp:ButtonColumn 
                       HeaderText="Add to cart" 
                       ButtonType="PushButton" 
                       Text="Add" 
                       CommandName="AddToCart" />
 
                  <asp:ButtonColumn 
                       HeaderText="Remove from cart" 
                       ButtonType="PushButton" 
                       Text="Remove" 
                       CommandName="RemoveFromCart" />
 
                  <asp:BoundColumn 
                       HeaderText="Item" 
                       DataField="StringValue"/>

                  <asp:BoundColumn 
                       HeaderText="Price" 
                       DataField="CurrencyValue" 
                       DataFormatString="{0:c}">

                     <ItemStyle HorizontalAlign="right">
                     </ItemStyle>

                  </asp:BoundColumn>   
 
               </Columns>
 
            </asp:DataGrid>
 
         </td>
         <td>
 
            <b>Shopping Cart</b>
 
            <asp:DataGrid id="ShoppingCart" 
                 runat="server"
                 BorderColor="black"
                 BorderWidth="1"
                 GridLines="Both"
                 ShowFooter="false"
                 CellPadding="3"
                 CellSpacing="0">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

            </asp:DataGrid> 
 
         </td>
      </tr>
 
   </table>
 
   </form>
 
</body>
</html>

下面的代码示例演示如何将属性<td>动态添加到控件生成的 DataGrid 和 <tr> 标记。


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">
 
   ICollection CreateDataSource() 
   {
      DataTable dt = new DataTable();
      DataRow dr;
 
      dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
      dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
      dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
      for (int i = 0; i < 5; i++) 
      {
         dr = dt.NewRow();
 
         dr[0] = i;
         dr[1] = "Item " + i.ToString();
         dr[2] = 1.23 * (i+1);
 
         dt.Rows.Add(dr);
      }
 
      DataView dv = new DataView(dt);
      return dv;
   }
 
   void Page_Load(Object sender, EventArgs e) 
   {
 
      if (!IsPostBack) 
      {
         // Load this data only once.
         ItemsGrid.DataSource = CreateDataSource();
         ItemsGrid.DataBind();
      }
 
   }
 
   void Item_Bound(Object sender, DataGridItemEventArgs e) 
   {

      ListItemType itemType = (ListItemType)e.Item.ItemType;

      if ((itemType != ListItemType.Header) &&
          (itemType != ListItemType.Footer) &&
          (itemType != ListItemType.Separator))
      {

         // Get the IntegerValue cell from the grid's column collection.
         TableCell intCell = (TableCell)e.Item.Controls[0];

         // Add attributes to the cell.
         intCell.Attributes.Add("id", "intCell" + e.Item.ItemIndex.ToString());
         intCell.Attributes.Add("OnClick", 
                                "Update_intCell" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");

         // Add attributes to the row.
         e.Item.Attributes.Add("id", "row" + e.Item.ItemIndex.ToString());
         e.Item.Attributes.Add("OnDblClick", 
                                "Update_row" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");
         
      }
 
   }
 
</script>

<script type="text/vbscript">

   sub Update_intCell0 
      Alert "You Selected Cell 0."
   end sub

   sub Update_intCell1 
      Alert "You Selected Cell 1."
   end sub

   sub Update_intCell2 
      Alert "You Selected Cell 2."
   end sub

   sub Update_intCell3 
      Alert "You Selected Cell 3."
   end sub

   sub Update_intCell4 
      Alert "You Selected Cell 4."
   end sub

   sub UpDate_row0 
      Alert "You selected the row 0."
   end sub

   sub UpDate_row1 
      Alert "You selected the row 1."
   end sub

   sub UpDate_row2 
      Alert "You selected the row 2."
   end sub

   sub UpDate_row3 
      Alert "You selected the row 3."
   end sub

   sub UpDate_row4 
      Alert "You selected the row 4."
   end sub   

</script>
 
<head runat="server">
    <title>
            Adding Attributes to the <td> and <tr> </title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>
            Adding Attributes to the <td> and <tr> <br />
            Tags of a DataGrid Control
      </h3>
 
      <asp:DataGrid id="ItemsGrid" runat="server"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           ShowFooter="true"
           OnItemDataBound="Item_Bound"
           AutoGenerateColumns="false">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <FooterStyle BackColor="#00aaaa">
         </FooterStyle>

         <Columns>

            <asp:BoundColumn HeaderText="Number" 
                 DataField="IntegerValue">

               <ItemStyle BackColor="yellow">
               </ItemStyle>
 
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Item" 
                 DataField="StringValue"/>

            <asp:BoundColumn 
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="right">
               </ItemStyle>
   
            </asp:BoundColumn>

         </Columns>
   
      </asp:DataGrid>

      <br /><br />

      Click on one of the cells in the <b>Number</b> column to select the cell.

      <br /><br />

      Double click on a row to select a row.   
 
   </form>
 
</body>
</html>


<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">
 
   Function CreateDataSource() As ICollection 
   
      Dim dt As DataTable = New DataTable()
      Dim dr As DataRow
      Dim i As Integer
      Dim dv As DataView
 
      dt.Columns.Add(New DataColumn("IntegerValue", GetType(Integer)))
      dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
      dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
 
      For i = 0 to 4 

         dr = dt.NewRow()
 
         dr(0) = i
         dr(1) = "Item " + i.ToString()
         dr(2) = 1.23 * (i+1)
 
         dt.Rows.Add(dr)
      
      Next i
 
      dv = New DataView(dt)
      CreateDataSource = dv
   
   End Function
 
   Sub Page_Load(sender As Object, e As EventArgs) 
 
      If Not IsPostBack 
  
         ' Load this data only once.
         ItemsGrid.DataSource = CreateDataSource()
         ItemsGrid.DataBind()
      
      End If 
 
   End Sub
 
   Sub Item_Bound(sender As Object, e As DataGridItemEventArgs) 

      Dim itemType As ListItemType 
      Dim intCell As TableCell

      itemType = CType(e.Item.ItemType, ListItemType)

      If (itemType <> ListItemType.Header) And _
         (itemType <> ListItemType.Footer) And _
         (itemType <> ListItemType.Separator) Then

         ' Get the IntegerValue cell from the grid's column collection.
         intCell = CType(e.Item.Controls(0), TableCell)

         ' Add attributes to the cell.
         intCell.Attributes.Add("id", "intCell" + e.Item.ItemIndex.ToString())
         intCell.Attributes.Add("OnClick", _
                                "Update_intCell" + _
                                e.Item.ItemIndex.ToString() + _
                                "()")
          
         ' Add attributes to the row.
         e.Item.Attributes.Add("id", "row" + e.Item.ItemIndex.ToString())
         e.Item.Attributes.Add("OnDblClick", _
                                "Update_row" + _
                                e.Item.ItemIndex.ToString() + _
                                "()")

      End If
 
   End Sub
 
</script>

<script type="text/vbscript">

   sub Update_intCell0 
      Alert "You Selected Cell 0."
   end sub

   sub Update_intCell1 
      Alert "You Selected Cell 1."
   end sub

   sub Update_intCell2 
      Alert "You Selected Cell 2."
   end sub

   sub Update_intCell3 
      Alert "You Selected Cell 3."
   end sub

   sub Update_intCell4 
      Alert "You Selected Cell 4."
   end sub

   sub UpDate_row0 
      Alert "You selected the row 0."
   end sub

   sub UpDate_row1 
      Alert "You selected the row 1."
   end sub

   sub UpDate_row2 
      Alert "You selected the row 2."
   end sub

   sub UpDate_row3 
      Alert "You selected the row 3."
   end sub

   sub UpDate_row4 
      Alert "You selected the row 4."
   end sub   

</script>
 
<head runat="server">
    <title>

            Adding Attributes to the <td> and <tr> </title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>

            Adding Attributes to the <td> and <tr> <br />
            Tags of a DataGrid Control

      </h3>
 
      <asp:DataGrid id="ItemsGrid" runat="server"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           ShowFooter="true"
           OnItemDataBound="Item_Bound"
           AutoGenerateColumns="false">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <FooterStyle BackColor="#00aaaa">
         </FooterStyle>

         <Columns>

            <asp:BoundColumn HeaderText="Number" 
                 DataField="IntegerValue">

               <ItemStyle BackColor="yellow">
               </ItemStyle>
 
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Item" 
                 DataField="StringValue"/>

            <asp:BoundColumn 
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="right">
               </ItemStyle>
   
            </asp:BoundColumn>

         </Columns>
   
      </asp:DataGrid>

      <br /><br />

      Click on one of the cells in the <b>Number</b> column to select the cell.

      <br /><br />

      Double click on a row to select a row.   
 
   </form>
 
</body>
</html>


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataGrid control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         // Load sample data only once when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsGrid.DataSource = CreateDataSource();
            ItemsGrid.DataBind();
         }

      }

      void Button_Click(Object sender, EventArgs e) 
      {

         // Count the number of selected items in the DataGrid control.
         int count = 0;

         // Display the selected times.
         Message.Text = "You Selected: <br />";

         // Iterate through each item (row) in the DataGrid control and 
         // determine whether it is selected.
         foreach (DataGridItem item in ItemsGrid.Items)
         {

            DetermineSelection(item, ref count);        

         }

         // If no items are selected, display the appropriate message.
         if (count == 0)
         {

            Message.Text = "No items selected";

         }

      }

      void DetermineSelection(DataGridItem item, ref int count)
      {

         // Retrieve the SelectCheckBox CheckBox control from the specified 
         // item (row) in the DataGrid control.
         CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox");

         // If the item is selected, display the appropriate message and 
         // increment the count of selected items.
         if (selection != null)
         {

           if (selection.Checked)
           {
              Message.Text += "- " + item.Cells[1].Text + "<br />";
              count++;
           }

         }    

      }

   </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="False"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn DataField="IntegerValue" 
                 HeaderText="Item"/>

            <asp:BoundColumn DataField="StringValue" 
                 HeaderText="Description"/>

            <asp:BoundColumn DataField="CurrencyValue" 
                 HeaderText="Price"
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="Right">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:TemplateColumn HeaderText="Select Item">

               <ItemTemplate>

                  <asp:CheckBox id="SelectCheckBox"
                       Text="Add to Cart"
                       Checked="False"
                       runat="server"/>

               </ItemTemplate>

            </asp:TemplateColumn>
 
         </Columns> 
 
      </asp:DataGrid>

      <br /><br />

      <asp:Button id="SubmitButton"
           Text="Submit"
           OnClick = "Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label id="Message"
           runat="server"/>
 
   </form>
 
</body>
</html>


<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">
 
       Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataGrid control.
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(string)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(double)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 to 8 
        
            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Item " & i.ToString()
            dr(2) = 1.23 * (i + 1)
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object, e As EventArgs) 
 
         ' Load sample data only once when the page is first loaded.
         If Not IsPostBack Then 
  
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()

         End If

      End Sub

      Sub Button_Click(sender As Object, e As EventArgs) 

         ' Count the number of selected items in the DataGrid control.
         Dim count As Integer = 0

         ' Display the selected items.
         Message.Text = "You Selected: <br />"

         ' Iterate through each item (row) in the DataGrid control 
         ' and determine whether it is selected.
         Dim item As DataGridItem
 
         For Each item In ItemsGrid.Items

            DetermineSelection(item, count)        

         Next

         ' If no items are selected, display the appropriate message.
         If count = 0 Then

            Message.Text = "No items selected"

         End If

      End Sub

      Sub DetermineSelection(item As DataGridItem, ByRef count As Integer)

         ' Retrieve the SelectCheckBox CheckBox control from the specified  
         ' item (row) in the DataGrid control.
         Dim selection As CheckBox = CType(item.FindControl("SelectCheckBox"), CheckBox)

         ' If the item is selected, display the appropriate message and 
         ' increment the count of selected items.
         If Not selection Is Nothing Then

           If selection.Checked Then
           
              Message.Text &= "- " & item.Cells(1).Text & "<br />"
              count = count + 1
           
           End If

         End If    

      End Sub

   </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="False"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn DataField="IntegerValue" 
                 HeaderText="Item"/>

            <asp:BoundColumn DataField="StringValue" 
                 HeaderText="Description"/>

            <asp:BoundColumn DataField="CurrencyValue" 
                 HeaderText="Price"
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="Right">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:TemplateColumn HeaderText="Select Item">

               <ItemTemplate>

                  <asp:CheckBox id="SelectCheckBox"
                       Text="Add to Cart"
                       Checked="False"
                       runat="server"/>

               </ItemTemplate>

            </asp:TemplateColumn>
 
         </Columns> 
 
      </asp:DataGrid>

      <br /><br />

      <asp:Button id="SubmitButton"
           Text="Submit"
           OnClick = "Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label id="Message"
           runat="server"/>
 
   </form>
 
</body>
</html>

注解

本主题内容：

介绍
辅助功能
声明性语法

注意

在使用 DataGrid 控件之前，请考虑改用 GridView 控件。 .NET FrameworkGridView版本 2.0 中引入的控件是控件的DataGrid后续版本。

介绍

DataGrid使用控件将数据源的字段显示为表中的列。控件中的 DataGrid 每一行都表示数据源中的一条记录。控件 DataGrid 支持选择、编辑、删除、分页和排序。

注意

此控件可用于显示用户输入，其中可能包括恶意客户端脚本。在应用程序中显示之前，请检查从客户端发送的任何信息，以获取可执行脚本、SQL 语句或其他代码。 ASP.NET 提供了输入请求验证功能，用于阻止用户输入中的脚本和 HTML。还提供了验证服务器控件来评估用户输入。有关详细信息，请参阅验证服务器控件语法。

不同的列类型决定了控件中列的行为。下表列出了可以使用的不同列类型。

列类型	说明
BoundColumn	显示绑定到数据源中字段的列。它将字段中的每一项显示为文本。这是控件的默认列类型 DataGrid 。
ButtonColumn	显示列中每个项的命令按钮。这允许你创建一列自定义按钮控件，如 `Add` 或 `Remove` 按钮。
EditCommandColumn	显示包含列中每个项的编辑命令的列。
HyperLinkColumn	将列中每个项的内容显示为超链接。列的内容可以绑定到数据源或静态文本中的字段。
TemplateColumn	显示指定模板后面的列中的每一项。这允许你在列中提供自定义控件。

默认情况下， AutoGenerateColumns 属性设置为 true，这会为数据源中的每个字段创建一个 BoundColumn 对象。然后，每个字段将按照每个字段在 DataGrid 数据源中的显示顺序呈现为控件中的列。

还可以手动控制控件中显示的DataGrid列，方法是将属性false设置为 AutoGenerateColumns ，然后列出要在开始标记和结束<Columns>标记之间包括的列。指定的列将按列出的顺序添加到 Columns 集合中。这使你可以以编程方式控制控件中的 DataGrid 列。

注意

列在控件中的 DataGrid 显示顺序由列在集合中的 Columns 显示顺序控制。虽然可以通过操作 Columns 集合以编程方式更改列的顺序，但以所需的显示顺序列出列会更容易。

显式声明的列可以与自动生成的列一起显示。同时使用这两个列时，将首先呈现显式声明的列，然后呈现自动生成的列。

注意

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

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

Style 属性	说明
AlternatingItemStyle	指定控件中交替项的 DataGrid 样式。
EditItemStyle	指定控件中正在编辑的项的 DataGrid 样式。
FooterStyle	指定控件中页脚节的 DataGrid 样式。
HeaderStyle	指定控件中标题节的 DataGrid 样式。
ItemStyle	指定控件中项的 DataGrid 样式。
PagerStyle	指定控件的页面选择部分的 DataGrid 样式。
SelectedItemStyle	指定控件中选定项的 DataGrid 样式。

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

属性	说明
ShowFooter	显示或隐藏控件的 DataGrid 页脚部分。
ShowHeader	显示或隐藏控件的 DataGrid 标头部分。

可以通过以编程方式将属性添加到 <td> 浏览器上的控件呈现的和 <tr> 标记，来控制控件的外观DataGrid。通过在或 OnItemDataBound 事件的事件处理程序OnItemCreated中提供代码，可以编程方式添加属性。

若要向 <td> 标记添加属性，请首先获取 TableCell 对象，该对象表示要向其添加特性的 DataGrid 控件中的单元格。 Control.Controls传递到事件处理程序中的 DataGridItemEventArgs 对象的属性的集合Item可用于获取所需的 TableCell 对象。然后AttributeCollection.Add，可以使用对象的集合TableCell的方法Attributes向标记添加属性<td>。

若要将属性添加到 <tr> 标记，请首先获取 DataGridItem 对象，该对象表示要向其添加特性的 DataGrid 控件中的行。 Item传入事件处理程序的 DataGridItemEventArgs 对象的属性可用于获取所需的 DataGridItem 对象。然后AttributeCollection.Add，可以使用对象的集合DataGridItem的方法Attributes向标记添加属性<tr>。

可访问性

有关如何配置此控件以便生成符合辅助功能标准的标记的信息，请参阅 Visual Studio 中的辅助功能和 ASP.NET 和 ASP.NET 控件和辅助功能。

声明性语法

<asp:DataGrid  
    AccessKey="string"  
    AllowCustomPaging="True|False"  
    AllowPaging="True|False"  
    AllowSorting="True|False"  
    AutoGenerateColumns="True|False"  
    BackColor="color name|#dddddd"  
    BackImageUrl="uri"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    Caption="string"  
    CaptionAlign="NotSet|Top|Bottom|Left|Right"  
    CellPadding="integer"  
    CellSpacing="integer"  
    CssClass="string"  
    DataKeyField="string"  
    DataMember="string"  
    DataSource="string"  
    DataSourceID="string"  
    EditItemIndex="integer"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    Font-Bold="True|False"  
    Font-Italic="True|False"  
    Font-Names="string"  
    Font-Overline="True|False"  
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|  
        Large|X-Large|XX-Large"  
    Font-Strikeout="True|False"  
    Font-Underline="True|False"  
    ForeColor="color name|#dddddd"  
    GridLines="None|Horizontal|Vertical|Both"  
    Height="size"  
    HorizontalAlign="NotSet|Left|Center|Right|Justify"  
    ID="string"  
    OnCancelCommand="CancelCommand event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleteCommand="DeleteCommand event handler"  
    OnDisposed="Disposed event handler"  
    OnEditCommand="EditCommand event handler"  
    OnInit="Init event handler"  
    OnItemCommand="ItemCommand event handler"  
    OnItemCreated="ItemCreated event handler"  
    OnItemDataBound="ItemDataBound event handler"  
    OnLoad="Load event handler"  
    OnPageIndexChanged="PageIndexChanged event handler"  
    OnPreRender="PreRender event handler"  
    OnSelectedIndexChanged="SelectedIndexChanged event handler"  
    OnSortCommand="SortCommand event handler"  
    OnUnload="Unload event handler"  
    OnUpdateCommand="UpdateCommand event handler"  
    PageSize="integer"  
    runat="server"  
    SelectedIndex="integer"  
    ShowFooter="True|False"  
    ShowHeader="True|False"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    ToolTip="string"  
    UseAccessibleHeader="True|False"  
    Visible="True|False"  
    Width="size"  
>  
        <AlternatingItemStyle />  
        <Columns>  
                <asp:BoundColumn  
                    DataField="string"  
                    DataFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    ReadOnly="True|False"  
                    SortExpression="string"  
                    Visible="True|False"  
>  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:BoundColumn>  
                <asp:ButtonColumn  
                    ButtonType="LinkButton|PushButton"  
                    CausesValidation="True|False"  
                    CommandName="string"  
                    DataTextField="string"  
                    DataTextFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    SortExpression="string"  
                    Text="string"  
                    ValidationGroup="string"  
                    Visible="True|False"  
>  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:ButtonColumn>  
                <asp:EditCommandColumn  
                    ButtonType="LinkButton|PushButton"  
                    CancelText="string"  
                    CausesValidation="True|False"  
                    EditText="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    SortExpression="string"  
                    UpdateText="string"  
                    ValidationGroup="string"  
                    Visible="True|False"  
>  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:EditCommandColumn>  
                <asp:HyperLinkColumn  
                    DataNavigateUrlField="string"  
                    DataNavigateUrlFormatString="string"  
                    DataTextField="string"  
                    DataTextFormatString="string"  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    NavigateUrl="uri"  
                    SortExpression="string"  
                    Target="string|_blank|_parent|_search|_self|_top"  
                    Text="string"  
                    Visible="True|False"  
>  
                        <FooterStyle />  
                        <HeaderStyle />  
                        <ItemStyle />  
                </asp:HyperLinkColumn>  
                <asp:TemplateColumn  
                    FooterText="string"  
                    HeaderImageUrl="uri"  
                    HeaderText="string"  
                    SortExpression="string"  
                    Visible="True|False"  
>  
                            <FooterStyle />  
                            <HeaderStyle />  
                            <ItemStyle />  
                        <EditItemTemplate>  
                            <!-- child controls -->  
                        </EditItemTemplate>  
                        <FooterTemplate>  
                            <!-- child controls -->  
                        </FooterTemplate>  
                        <HeaderTemplate>  
                            <!-- child controls -->  
                        </HeaderTemplate>  
                        <ItemTemplate>  
                            <!-- child controls -->  
                        </ItemTemplate>  
                </asp:TemplateColumn>  
        </Columns>  
        <EditItemStyle />  
        <FooterStyle />  
        <HeaderStyle />  
        <ItemStyle />  
        <PagerStyle  
            BackColor="color name|#dddddd"  
            BorderColor="color name|#dddddd"  
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|  
                Groove|Ridge|Inset|Outset"  
            BorderWidth="size"  
            CssClass="string"  
            Font-Bold="True|False"  
            Font-Italic="True|False"  
            Font-Names="string"  
            Font-Overline="True|False"  
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|  
                Medium|Large|X-Large|XX-Large"  
            Font-Strikeout="True|False"  
            Font-Underline="True|False"  
            ForeColor="color name|#dddddd"  
            Height="size"  
            HorizontalAlign="NotSet|Left|Center|Right|Justify"  
            Mode="NextPrev|NumericPages"  
            NextPageText="string"  
            OnDisposed="Disposed event handler"  
            PageButtonCount="integer"  
            Position="Bottom|Top|TopAndBottom"  
            PrevPageText="string"  
            VerticalAlign="NotSet|Top|Middle|Bottom"  
            Visible="True|False"  
            Width="size"  
            Wrap="True|False"  
        />  
        <SelectedItemStyle />  
</asp:DataGrid>

构造函数

DataGrid()

初始化 DataGrid 类的新实例。

字段

CancelCommandName	表示 `Cancel` 命令名。此字段为只读。
DeleteCommandName	表示 Delete 命令名。此字段为只读。
EditCommandName	表示 Edit 命令名。此字段为只读。
NextPageCommandArgument	表示 Next 命令参数。此字段为只读。
PageCommandName	表示 Page 命令名。此字段为只读。
PrevPageCommandArgument	表示 Prev 命令参数。此字段为只读。
SelectCommandName	表示 Select 命令名。此字段为只读。
SortCommandName	表示 Sort 命令名。此字段为只读。
UpdateCommandName	表示 Update 命令名。此字段为只读。

属性

AccessKey	获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl)
Adapter	获取控件的浏览器特定适配器。 (继承自 Control)
AllowCustomPaging	获取或设置指示是否启用自定义分页的值。
AllowPaging	获取或设置指示是否启用分页的值。
AllowSorting	获取或设置指示是否启用排序的值。
AlternatingItemStyle	获取 DataGrid 控件中交替项的样式属性。
AppRelativeTemplateSourceDirectory	获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control)
Attributes	获取与控件的特性不对应的任意特性（只用于呈现）的集合。 (继承自 WebControl)
AutoGenerateColumns	获取或设置一个值，该值指示是否为数据源中的每一字段自动创建 BoundColumn 对象并在 DataGrid 控件中显示这些对象。
BackColor	获取或设置 Web 服务器控件的背景色。 (继承自 WebControl)
BackImageUrl	获取或设置要在 DataGrid 控件的背景中显示的图像的 URL。
BindingContainer	获取包含该控件的数据绑定的控件。 (继承自 Control)
BorderColor	获取或设置 Web 控件的边框颜色。 (继承自 WebControl)
BorderStyle	获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl)
BorderWidth	获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl)
Caption	获取或设置要在控件中的 HTML 标题元素中呈现的文本。提供此属性的目的是使辅助技术设备的用户更易于访问控件。 (继承自 BaseDataList)
CaptionAlign	获取或设置控件中的 HTML 标题元素的水平或垂直位置。提供此属性的目的是使辅助技术设备的用户更易于访问控件。 (继承自 BaseDataList)
CellPadding	获取或设置单元格的内容和单元格的边框之间的空间量。 (继承自 BaseDataList)
CellSpacing	获取或设置单元格间的空间量。 (继承自 BaseDataList)
ChildControlsCreated	获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control)
ClientID	获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control)
ClientIDMode	获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control)
ClientIDSeparator	获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control)
Columns	获取表示 DataGrid 控件的各列的对象的集合。
Context	为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control)
Controls	获取 ControlCollection 对象，它包含数据列表控件中的子控件的集合。 (继承自 BaseDataList)
ControlStyle	获取 Web 服务器控件的样式。此属性主要由控件开发人员使用。 (继承自 WebControl)
ControlStyleCreated	获取一个值，该值指示是否已为 Style 属性创建了 ControlStyle 对象。此属性主要由控件开发人员使用。 (继承自 WebControl)
CssClass	获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。 (继承自 WebControl)
CurrentPageIndex	获取或设置当前显示页的索引。
DataItemContainer	如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control)
DataKeyField	获取或设置由 DataSource 属性指定的数据源中的键字段。 (继承自 BaseDataList)
DataKeys	获取 DataKeyCollection 对象，它存储数据列表控件中每个记录的键值。 (继承自 BaseDataList)
DataKeysArray	获取 ArrayList 对象，它包含数据列表控件中每个记录的键值。 (继承自 BaseDataList)
DataKeysContainer	如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control)
DataMember	获取或设置多成员数据源中要绑定到数据列表控件的特定数据成员。 (继承自 BaseDataList)
DataSource	获取或设置源，该源包含用于填充控件中的项的值列表。 (继承自 BaseDataList)
DataSourceID	获取或设置数据源控件的 ID 属性，数据列表控件应使用它来检索其数据源。 (继承自 BaseDataList)
DesignMode	获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control)
EditItemIndex	获取或设置 DataGrid 控件中要编辑的项的索引。
EditItemStyle	获取在 DataGrid 控件中选定来进行编辑的项的样式属性。
Enabled	获取或设置一个值，该值指示是否启用 Web 服务器控件。 (继承自 WebControl)
EnableTheming	获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 WebControl)
EnableViewState	获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control)
Events	获取控件的事件处理程序委托列表。此属性为只读。 (继承自 Control)
Font	获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl)
FooterStyle	获取 DataGrid 控件中页脚部分的样式属性。
ForeColor	获取或设置 Web 服务器控件的前景色（通常是文本颜色）。 (继承自 WebControl)
GridLines	获取或设置一个值，该值指定是否显示数据列表控件的单元格之间的边框。 (继承自 BaseDataList)
HasAttributes	获取一个值，该值指示控件是否具有特性集。 (继承自 WebControl)
HasChildViewState	获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control)
HeaderStyle	获取 DataGrid 控件中页眉部分的样式属性。
Height	获取或设置 Web 服务器控件的高度。 (继承自 WebControl)
HorizontalAlign	获取或设置数据列表控件在其容器内的水平对齐方式。 (继承自 BaseDataList)
ID	获取或设置分配给服务器控件的编程标识符。 (继承自 Control)
IdSeparator	获取用于分隔控件标识符的字符。 (继承自 Control)
Initialized	获取一个值，该值指示控件是否已经初始化。 (继承自 BaseDataList)
IsBoundUsingDataSourceID	获取指示是否设置 DataSourceID 属性的值。 (继承自 BaseDataList)
IsChildControlStateCleared	获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control)
IsEnabled	获取一个值，该值指示是否启用控件。 (继承自 WebControl)
IsTrackingViewState	获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control)
IsViewStateEnabled	获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control)
Items	获取表示 DataGridItem 控件中单独项的 DataGrid 对象的集合。
ItemStyle	获取 DataGrid 控件中各项的样式属性。
LoadViewStateByID	获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control)
NamingContainer	获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control)
Page	获取对包含服务器控件的 Page 实例的引用。 (继承自 Control)
PageCount	获取显示 DataGrid 控件中各项所需的总页数。
PagerStyle	获取 DataGrid 控件的分页部分的样式属性。
PageSize	获取或设置要在 DataGrid 控件的单页上显示的项数。
Parent	获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control)
RenderingCompatibility	获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control)
RequiresDataBinding	获取或设置一个值，该值指示数据列表控件是否需要绑定到其指定的数据源。 (继承自 BaseDataList)
SelectArguments	获取数据绑定控件从数据源控件检索数据时使用的 DataSourceSelectArguments 对象。 (继承自 BaseDataList)
SelectedIndex	获取或设置 DataGrid 控件中的选定项的索引。
SelectedItem	获取表示 DataGridItem 控件中选定项的 DataGrid 对象。
SelectedItemStyle	获取 DataGrid 控件中当前选定项的样式属性。
ShowFooter	获取或设置一个值，该值指示页脚是否在 DataGrid 控件中显示。
ShowHeader	获取或设置一个值，该值指示是否在 DataGrid 控件中显示页眉。
Site	获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control)
SkinID	获取或设置要应用于控件的外观。 (继承自 WebControl)
Style	获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl)
SupportsDisabledAttribute	获取一个值，该值指示在控件的 `disabled` 属性为 IsEnabled 时，控件是否应将呈现的 HTML 元素的 `false` 特性设置为 "disabled"。 (继承自 BaseDataList)
TabIndex	获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl)
TagKey	获取 DataGrid 控件的 HtmlTextWriterTag 值。
TagKey	获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。此属性主要由控件开发人员使用。 (继承自 WebControl)
TagName	获取控件标记的名称。此属性主要由控件开发人员使用。 (继承自 WebControl)
TemplateControl	获取或设置对包含该控件的模板的引用。 (继承自 Control)
TemplateSourceDirectory	获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control)
ToolTip	获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl)
UniqueID	获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control)
UseAccessibleHeader	获取或设置一个值，该值指示数据列表控件是否以可访问的格式呈现其标头。提供此属性的目的是使辅助技术设备的用户更易于访问控件。 (继承自 BaseDataList)
ValidateRequestMode	获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control)
ViewState	获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control)
ViewStateIgnoresCase	获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control)
ViewStateMode	获取或设置此控件的视图状态模式。 (继承自 Control)
VirtualItemCount	获取或设置在使用自定义分页时 DataGrid 控件中的实际项数。
Visible	获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control)
Width	获取或设置 Web 服务器控件的宽度。 (继承自 WebControl)

方法

AddAttributesToRender(HtmlTextWriter)	将需要呈现的 HTML 特性和样式添加到指定的 HtmlTextWriterTag 中。此方法主要由控件开发人员使用。 (继承自 WebControl)
AddedControl(Control, Int32)	在子控件添加到 Control 对象的 Controls 集合后调用。 (继承自 Control)
AddParsedSubObject(Object)	通知服务器控件某个元素（XML 或 HTML）已经过语法分析，并将该元素添加到服务器控件的 ControlCollection 集合。 (继承自 BaseDataList)
ApplyStyle(Style)	将指定样式的所有非空白元素复制到 Web 控件，覆盖控件的所有现有的样式元素。此方法主要由控件开发人员使用。 (继承自 WebControl)
ApplyStyleSheetSkin(Page)	将页样式表中定义的样式属性应用到控件。 (继承自 Control)
BeginRenderTracing(TextWriter, Object)	开始输出数据的设计时追踪。 (继承自 Control)
BuildProfileTree(String, Boolean)	收集有关服务器控件的信息并将该信息发送到 Trace 属性，在启用页的跟踪功能时将显示该属性。 (继承自 Control)
ClearCachedClientID()	将缓存的 ClientID 值设置为 `null`。 (继承自 Control)
ClearChildControlState()	删除服务器控件的子控件的控件状态信息。 (继承自 Control)
ClearChildState()	删除服务器控件的所有子控件的视图状态和控件状态信息。 (继承自 Control)
ClearChildViewState()	删除服务器控件的所有子控件的视图状态信息。 (继承自 Control)
ClearEffectiveClientIDMode()	将当前控件实例和任何子控件的 ClientIDMode 属性设置为 Inherit。 (继承自 Control)
CopyBaseAttributes(WebControl)	将 Style 对象未封装的属性从指定的 Web 服务器控件复制到从中调用此方法的 Web 服务器控件。此方法主要由控件开发人员使用。 (继承自 WebControl)
CreateChildControls()	使用视图状态创建子控件。 (继承自 BaseDataList)
CreateColumnSet(PagedDataSource, Boolean)	创建一组列，用于生成控件层次结构。 AutoGenerateColumns 为 true 时，将创建列来匹配数据源，并将列追加到 Columns 集合中定义的那组列。
CreateControlCollection()	创建一个新 ControlCollection 对象来保存服务器控件的子控件（包括文本控件和服务器控件）。 (继承自 Control)
CreateControlHierarchy(Boolean)	创建用于呈现 DataGrid 的控件层次结构。
CreateControlStyle()	创建新控件样式。
CreateDataSourceSelectArguments()	如果未指定参数，则创建由数据绑定控件使用的默认 DataSourceSelectArguments 对象。 (继承自 BaseDataList)
CreateItem(Int32, Int32, ListItemType)	创建一个 DataGridItem 对象。
DataBind()	将控件及其所有子控件绑定到指定的数据源。 (继承自 BaseDataList)
DataBind(Boolean)	将数据源绑定到调用的服务器控件及其所有子控件，同时可以选择引发 DataBinding 事件。 (继承自 Control)
DataBindChildren()	将数据源绑定到服务器控件的子控件。 (继承自 Control)
Dispose()	使服务器控件得以在从内存中释放之前执行最后的清理操作。 (继承自 Control)
EndRenderTracing(TextWriter, Object)	结束输出数据的设计时追踪。 (继承自 Control)
EnsureChildControls()	确定服务器控件是否包含子控件。如果不包含，则创建子控件。 (继承自 Control)
EnsureDataBound()	验证数据列表控件是否需要数据绑定，并验证在调用 DataBind() 方法前是否指定了有效的数据源控件。 (继承自 BaseDataList)
EnsureID()	为尚未分配标识符的控件创建标识符。 (继承自 Control)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
FindControl(String)	在当前的命名容器中搜索带指定 `id` 参数的服务器控件。 (继承自 Control)
FindControl(String, Int32)	使用指定的 `id` 和 `pathOffset` 参数（该参数有助于搜索）中指定的整数在当前命名容器中搜索服务器控件。不应重写此版本的 FindControl 方法。 (继承自 Control)
Focus()	为控件设置输入焦点。 (继承自 Control)
GetData()	返回一个实现了 IEnumerable 的对象，表示数据源。 (继承自 BaseDataList)
GetDesignModeState()	获取控件的设计时数据。 (继承自 Control)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetRouteUrl(Object)	获取与一组路由参数对应的 URL。 (继承自 Control)
GetRouteUrl(RouteValueDictionary)	获取与一组路由参数对应的 URL。 (继承自 Control)
GetRouteUrl(String, Object)	获取与一组路由参数以及某个路由名称对应的 URL。 (继承自 Control)
GetRouteUrl(String, RouteValueDictionary)	获取与一组路由参数以及某个路由名称对应的 URL。 (继承自 Control)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetUniqueIDRelativeTo(Control)	返回指定控件的 UniqueID 属性的前缀部分。 (继承自 Control)
HasControls()	确定服务器控件是否包含任何子控件。 (继承自 Control)
HasEvents()	返回一个值，该值指示是否为控件或任何子控件注册事件。 (继承自 Control)
InitializeItem(DataGridItem, DataGridColumn[])	初始化指定的 DataGridItem 对象。
InitializePager(DataGridItem, Int32, PagedDataSource)	创建包含分页 UI 的 DataGridItem 对象。
IsLiteralContent()	确定服务器控件是否只包含文字内容。 (继承自 Control)
LoadControlState(Object)	从 SaveControlState() 方法保存的上一个页请求还原控件状态信息。 (继承自 Control)
LoadViewState(Object)	加载 DataGrid 的保存状态。
MapPathSecure(String)	检索虚拟路径（绝对的或相对的）映射到的物理路径。 (继承自 Control)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MergeStyle(Style)	将指定样式的所有非空白元素复制到 Web 控件，但不覆盖该控件现有的任何样式元素。此方法主要由控件开发人员使用。 (继承自 WebControl)
OnBubbleEvent(Object, EventArgs)	沿该页的 UI 服务器控件层次结构向上传递由容器内某个控件引发的事件。
OnCancelCommand(DataGridCommandEventArgs)	引发 CancelCommand 事件。这使你可以为事件提供自定义处理程序。
OnDataBinding(EventArgs)	引发 DataBinding 控件的 BaseDataList 事件。 (继承自 BaseDataList)
OnDataPropertyChanged()	在某一基础数据源标识属性更改时调用，以将数据绑定控件重新绑定到其数据。 (继承自 BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)	引发 DataSourceViewChanged 事件。 (继承自 BaseDataList)
OnDeleteCommand(DataGridCommandEventArgs)	引发 DeleteCommand 事件。这使你可以为事件提供自定义处理程序。
OnEditCommand(DataGridCommandEventArgs)	引发 EditCommand 事件。这使你可以为事件提供自定义处理程序。
OnInit(EventArgs)	为 Init 控件引发 BaseDataList 事件。 (继承自 BaseDataList)
OnItemCommand(DataGridCommandEventArgs)	引发 ItemCommand 事件。这使你可以为事件提供自定义处理程序。
OnItemCreated(DataGridItemEventArgs)	引发 ItemCreated 事件。这使你可以为事件提供自定义处理程序。
OnItemDataBound(DataGridItemEventArgs)	引发 ItemDataBound 事件。这使你可以为事件提供自定义处理程序。
OnLoad(EventArgs)	引发 Load 事件。 (继承自 BaseDataList)
OnPageIndexChanged(DataGridPageChangedEventArgs)	引发 PageIndexChanged 事件。这使你可以为事件提供自定义处理程序。
OnPreRender(EventArgs)	引发 PreRender 事件。 (继承自 BaseDataList)
OnSelectedIndexChanged(EventArgs)	引发 SelectedIndexChanged 控件的 BaseDataList 事件。 (继承自 BaseDataList)
OnSortCommand(DataGridSortCommandEventArgs)	引发 SortCommand 事件。这使你可以为事件提供自定义处理程序。
OnUnload(EventArgs)	引发 Unload 事件。 (继承自 Control)
OnUpdateCommand(DataGridCommandEventArgs)	引发 UpdateCommand 事件。这使你可以为事件提供自定义处理程序。
OpenFile(String)	获取用于读取文件的 Stream。 (继承自 Control)
PrepareControlHierarchy()	为此 DataGrid 控件设置控件层次结构。
RaiseBubbleEvent(Object, EventArgs)	将所有事件源及其信息分配给控件的父级。 (继承自 Control)
RemovedControl(Control)	从 Control 对象的 Controls 集合移除子控件后调用。 (继承自 Control)
Render(HtmlTextWriter)	将控件呈现给指定的 HTML 编写器。 (继承自 BaseDataList)
RenderBeginTag(HtmlTextWriter)	将控件的 HTML 开始标记呈现到指定的编写器中。此方法主要由控件开发人员使用。 (继承自 WebControl)
RenderChildren(HtmlTextWriter)	将服务器控件子级的内容输出到提供的 HtmlTextWriter 对象，该对象可写入要在客户端上呈现的内容。 (继承自 Control)
RenderContents(HtmlTextWriter)	将控件的内容呈现到指定的编写器中。此方法主要由控件开发人员使用。 (继承自 WebControl)
RenderControl(HtmlTextWriter)	将服务器控件内容输出到所提供的 HtmlTextWriter 对象，如果启用了跟踪，则还将存储有关该控件的跟踪信息。 (继承自 Control)
RenderControl(HtmlTextWriter, ControlAdapter)	使用提供的 HtmlTextWriter 对象将服务器控件内容输出到提供的 ControlAdapter 对象。 (继承自 Control)
RenderEndTag(HtmlTextWriter)	将控件的 HTML 结束标记呈现到指定的编写器中。此方法主要由控件开发人员使用。 (继承自 WebControl)
ResolveAdapter()	获取负责呈现指定控件的控件适配器。 (继承自 Control)
ResolveClientUrl(String)	获取浏览器可以使用的 URL。 (继承自 Control)
ResolveUrl(String)	将 URL 转换为在请求客户端可用的 URL。 (继承自 Control)
SaveControlState()	保存将页面回发到服务器之后发生的所有服务器控件状态更改。 (继承自 Control)
SaveViewState()	保存 DataGrid 的当前状态。
SetDesignModeState(IDictionary)	为控件设置设计时数据。 (继承自 Control)
SetRenderMethodDelegate(RenderMethod)	分配事件处理程序委托，以将服务器控件及其内容呈现到父控件中。 (继承自 Control)
SetTraceData(Object, Object)	使用跟踪数据键和跟踪数据值，为呈现数据的设计时追踪设置跟踪数据。 (继承自 Control)
SetTraceData(Object, Object, Object)	使用跟踪对象、跟踪数据键和跟踪数据值，为呈现数据的设计时追踪设置跟踪数据。 (继承自 Control)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TrackViewState()	标记开始跟踪的起始点，并将对控件所做的更改作为控件视图状态的一部分进行保存。

事件

CancelCommand	对 DataGrid 控件中的某项单击 `Cancel` 按钮时发生。
DataBinding	当服务器控件绑定到数据源时发生。 (继承自 Control)
DeleteCommand	对 DataGrid 控件中的某个项单击“删除”按钮时发生。
Disposed	当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control)
EditCommand	对 DataGrid 控件中的某个项单击“编辑”按钮时发生。
Init	当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control)
ItemCommand	当单击 DataGrid 控件中的任一按钮时发生。
ItemCreated	当在 DataGrid 控件中创建项时在服务器上发生。
ItemDataBound	在项被数据绑定到 DataGrid 控件后发生。
Load	当服务器控件加载到 Page 对象中时发生。 (继承自 Control)
PageIndexChanged	当单击页选择元素之一时发生。
PreRender	在加载 Control 对象之后、呈现之前发生。 (继承自 Control)
SelectedIndexChanged	在两次服务器发送之间，在数据列表控件中选择了不同的项时发生。 (继承自 BaseDataList)
SortCommand	对列进行排序时发生。
Unload	当服务器控件从内存中卸载时发生。 (继承自 Control)
UpdateCommand	对 DataGrid 控件中的某个项单击“更新”按钮时发生。

显式接口实现

IAttributeAccessor.GetAttribute(String)	获取具有指定名称的 Web 控件的特性。 (继承自 WebControl)
IAttributeAccessor.SetAttribute(String, String)	将 Web 控件的特性设置为指定的名称和值。 (继承自 WebControl)
IControlBuilderAccessor.ControlBuilder	有关此成员的说明，请参见 ControlBuilder。 (继承自 Control)
IControlDesignerAccessor.GetDesignModeState()	有关此成员的说明，请参见 GetDesignModeState()。 (继承自 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	有关此成员的说明，请参见 SetDesignModeState(IDictionary)。 (继承自 Control)
IControlDesignerAccessor.SetOwnerControl(Control)	有关此成员的说明，请参见 SetOwnerControl(Control)。 (继承自 Control)
IControlDesignerAccessor.UserData	有关此成员的说明，请参见 UserData。 (继承自 Control)
IDataBindingsAccessor.DataBindings	有关此成员的说明，请参见 DataBindings。 (继承自 Control)
IDataBindingsAccessor.HasDataBindings	有关此成员的说明，请参见 HasDataBindings。 (继承自 Control)
IExpressionsAccessor.Expressions	有关此成员的说明，请参见 Expressions。 (继承自 Control)
IExpressionsAccessor.HasExpressions	有关此成员的说明，请参见 HasExpressions。 (继承自 Control)
IParserAccessor.AddParsedSubObject(Object)	有关此成员的说明，请参见 AddParsedSubObject(Object)。 (继承自 Control)

扩展方法

FindDataSourceControl(Control)	返回与指定控件的数据控件关联的数据源。
FindFieldTemplate(Control, String)	返回指定控件的命名容器中指定列的字段模板。
FindMetaTable(Control)	返回包含数据控件的元表对象。
GetDefaultValues(INamingContainer)	为指定数据控件获取默认值的集合。
GetMetaTable(INamingContainer)	为指定数据控件获取表元数据。
SetMetaTable(INamingContainer, MetaTable)	为指定数据控件设置表元数据。
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	为指定数据控件设置表元数据和默认值映射。
SetMetaTable(INamingContainer, MetaTable, Object)	为指定数据控件设置表元数据和默认值映射。
TryGetMetaTable(INamingContainer, MetaTable)	确定表元数据是否可用。
EnableDynamicData(INamingContainer, Type)	为指定数据控件启用动态数据行为。
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	为指定数据控件启用动态数据行为。
EnableDynamicData(INamingContainer, Type, Object)	为指定数据控件启用动态数据行为。

适用于