Freigeben über


DataGrid Klasse

Definition

Ein datengebundenes Listensteuerelement, das die Elemente aus einer Datenquelle in einer Tabelle anzeigt. Das DataGrid-Steuerelement ermöglicht Ihnen die Auswahl, Sortierung und Bearbeitung dieser Elemente.

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
Vererbung
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das DataGrid Steuerelement verwenden, um die Elemente in der Datenquelle anzuzeigen.

<%@ 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>

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das DataGrid Steuerelement für einen einfachen Warenkorb verwenden.

<%@ 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>

Im folgenden Codebeispiel wird veranschaulicht, wie sie den <td> vom DataGrid Steuerelement generierten Tags und <tr> dynamisch Attribute hinzufügen.


<%@ 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>

Hinweise

In diesem Thema:

Einführung

Verwenden Sie das DataGrid -Steuerelement, um die Felder einer Datenquelle als Spalten in einer Tabelle anzuzeigen. Jede Zeile im DataGrid Steuerelement stellt einen Datensatz in der Datenquelle dar. Das DataGrid Steuerelement unterstützt auswahl, bearbeiten, löschen, paging und sortieren.

Achtung

Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, die möglicherweise schädliche Clientskripts enthalten. Überprüfen Sie alle Informationen, die von einem Client auf ausführbare Skripts, SQL-Anweisungen oder anderen Code gesendet werden, bevor Sie sie in Ihrer Anwendung anzeigen. ASP.NET bietet eine Funktion zur Überprüfung von Eingabeanforderungen zum Blockieren von Skripts und HTML in Benutzereingaben. Validierungsserversteuerelemente werden auch bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax der Validierungsserversteuerung.

Unterschiedliche Spaltentypen bestimmen das Verhalten der Spalten im Steuerelement. In der folgenden Tabelle sind die verschiedenen Spaltentypen aufgeführt, die verwendet werden können.

Spaltentyp BESCHREIBUNG
BoundColumn Zeigt eine Spalte an, die an ein Feld in einer Datenquelle gebunden ist. Jedes Element im Feld wird als Text angezeigt. Dies ist der Standardspaltentyp des Steuerelements DataGrid .
ButtonColumn Zeigt eine Befehlsschaltfläche für jedes Element in der Spalte an. Dadurch können Sie eine Spalte mit benutzerdefinierten Schaltflächensteuerelementen erstellen, z Add . B. oder Remove Schaltflächen.
EditCommandColumn Zeigt eine Spalte an, die Bearbeitungsbefehle für jedes Element in der Spalte enthält.
HyperLinkColumn Zeigt den Inhalt jedes Elements in der Spalte als Link an. Der Inhalt der Spalte kann an ein Feld in einer Datenquelle oder an statischen Text gebunden werden.
TemplateColumn Zeigt jedes Element in der Spalte nach einer angegebenen Vorlage an. Dadurch können Sie benutzerdefinierte Steuerelemente in der Spalte bereitstellen.

Standardmäßig ist die AutoGenerateColumns -Eigenschaft auf truefestgelegt, wodurch ein BoundColumn Objekt für jedes Feld in der Datenquelle erstellt wird. Jedes Feld wird dann als Spalte im Steuerelement in der DataGrid Reihenfolge gerendert, in der jedes Feld in der Datenquelle angezeigt wird.

Sie können auch manuell steuern, welche Spalten im DataGrid Steuerelement angezeigt werden, indem Sie die AutoGenerateColumns -Eigenschaft auf false festlegen und dann die Spalten auflisten, die Sie zwischen den öffnenden und schließenden <Columns> Tags einschließen möchten. Die angegebenen Spalten werden der Columns Auflistung in der aufgeführten Reihenfolge hinzugefügt. Dadurch können Sie die Spalten im DataGrid Steuerelement programmgesteuert steuern.

Hinweis

Die Reihenfolge, in der die Spalten im DataGrid Steuerelement angezeigt werden, wird durch die Reihenfolge gesteuert, in der die Spalten in der Columns Auflistung angezeigt werden. Obwohl Sie die Reihenfolge der Spalten programmgesteuert ändern können, indem Sie die Columns Auflistung bearbeiten, ist es einfacher, die Spalten in der gewünschten Anzeigereihenfolge aufzulisten.

Explizit deklarierte Spalten können in Verbindung mit automatisch generierten Spalten angezeigt werden. Bei Verwendung beider werden explizit deklarierte Spalten zuerst gerendert, gefolgt von den automatisch generierten Spalten.

Hinweis

Automatisch generierte Spalten werden der Columns Auflistung nicht hinzugefügt.

Die Darstellung des DataGrid Steuerelements kann angepasst werden, indem die Stileigenschaften für die verschiedenen Teile des Steuerelements festgelegt werden. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgeführt.

Style-Eigenschaft BESCHREIBUNG
AlternatingItemStyle Gibt den Stil für wechselnde Elemente im Steuerelement an DataGrid .
EditItemStyle Gibt den Stil für das Element an, das DataGrid im Steuerelement bearbeitet wird.
FooterStyle Gibt die Formatvorlage für den Fußzeilenabschnitt im Steuerelement an DataGrid .
HeaderStyle Gibt die Formatvorlage für den Headerabschnitt im Steuerelement an DataGrid .
ItemStyle Gibt den Stil für die Elemente im Steuerelement an DataGrid .
PagerStyle Gibt die Formatvorlage für den Seitenauswahlabschnitt des Steuerelements DataGrid an.
SelectedItemStyle Gibt die Formatvorlage für das ausgewählte Element im Steuerelement an DataGrid .

Sie können auch verschiedene Teile des Steuerelements ein- oder ausblenden. In der folgenden Tabelle sind die Eigenschaften aufgeführt, die steuern, welche Teile angezeigt oder ausgeblendet werden.

Eigenschaft BESCHREIBUNG
ShowFooter Zeigt den Fußzeilenabschnitt des Steuerelements an oder blendet diese DataGrid aus.
ShowHeader Zeigt den Headerabschnitt des Steuerelements an oder blendet diese DataGrid aus.

Sie können die Darstellung des DataGrid Steuerelements steuern, indem Sie programmgesteuert Attribute zu den Tags und <tr> hinzufügen, die <td> vom Steuerelement im Browser gerendert werden. Attribute können programmgesteuert hinzugefügt werden, indem Code im Ereignishandler für das OnItemCreated Ereignis oder OnItemDataBound bereitgestellt wird.

Um dem <td> Tag ein Attribut hinzuzufügen, rufen Sie zuerst das TableCell Objekt ab, das die Zelle im DataGrid Steuerelement darstellt, dem Sie das Attribut hinzufügen möchten. Die Control.Controls Auflistung für die Item -Eigenschaft des -Objekts, das DataGridItemEventArgs an den Ereignishandler übergeben wird, kann verwendet werden, um das gewünschte TableCell Objekt abzurufen. Anschließend können Sie die AttributeCollection.Add -Methode der Attributes -Auflistung für das TableCell -Objekt verwenden, um dem <td> Tag Attribute hinzuzufügen.

Um dem <tr> Tag ein Attribut hinzuzufügen, rufen Sie zuerst das DataGridItem Objekt ab, das die Zeile im DataGrid Steuerelement darstellt, dem Sie das Attribut hinzufügen möchten. Die Item -Eigenschaft des -Objekts, das DataGridItemEventArgs an den Ereignishandler übergeben wird, kann verwendet werden, um das gewünschte DataGridItem Objekt abzurufen. Anschließend können Sie die AttributeCollection.Add -Methode der Attributes -Auflistung für das DataGridItem -Objekt verwenden, um dem <tr> Tag Attribute hinzuzufügen.

Zugriff

Weitere Informationen zur Verwendung dieses Steuerelement so konfigurieren, dass sie Markup generiert, das Accessibility Standards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und ASP.NET-Steuerelemente und Barrierefreiheit.

Deklarative Syntax

<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>

Konstruktoren

DataGrid()

Initialisiert eine neue Instanz der DataGrid-Klasse.

Felder

CancelCommandName

Stellt den Namen des Cancel-Befehls dar. Dieses Feld ist schreibgeschützt.

DeleteCommandName

Stellt den Namen des Delete-Befehls dar. Dieses Feld ist schreibgeschützt.

EditCommandName

Stellt den Namen des Edit-Befehls dar. Dieses Feld ist schreibgeschützt.

NextPageCommandArgument

Stellt das Argument des Next-Befehls dar. Dieses Feld ist schreibgeschützt.

PageCommandName

Stellt den Namen des Page-Befehls dar. Dieses Feld ist schreibgeschützt.

PrevPageCommandArgument

Stellt das Argument des Prev-Befehls dar. Dieses Feld ist schreibgeschützt.

SelectCommandName

Stellt den Namen des Select-Befehls dar. Dieses Feld ist schreibgeschützt.

SortCommandName

Stellt den Namen des Sort-Befehls dar. Dieses Feld ist schreibgeschützt.

UpdateCommandName

Stellt den Namen des Update-Befehls dar. Dieses Feld ist schreibgeschützt.

Eigenschaften

AccessKey

Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest.

(Geerbt von WebControl)
Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
AllowCustomPaging

Ruft einen Wert ab, der angibt, ob die benutzerdefinierte Paginierung aktiviert ist, oder legt diesen fest.

AllowPaging

Ruft einen Wert ab, der angibt, ob die Paginierung aktiviert ist, oder legt diesen fest.

AllowSorting

Ruft einen Wert ab, der angibt, ob das Sortieren aktiviert ist, oder legt diesen fest.

AlternatingItemStyle

Ruft die Stileigenschaften für abwechselnde Elemente im DataGrid-Steuerelement ab.

AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.

(Geerbt von Control)
Attributes

Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen.

(Geerbt von WebControl)
AutoGenerateColumns

Ruft einen Wert ab, der angibt, ob BoundColumn-Objekte im DataGrid-Steuerelement für jedes Feld in der Datenquelle automatisch erstellt und angezeigt werden, oder legt diesen fest.

BackColor

Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BackImageUrl

Ruft die URL eines Bildes ab, das im Hintergrund des DataGrid-Steuerelements angezeigt werden soll, oder legt diese fest.

BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.

(Geerbt von Control)
BorderColor

Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BorderStyle

Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BorderWidth

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
Caption

Ruft den Text ab, der in einem HTML-Beschriftungselement im Steuerelement gerendert werden soll, oder legt diesen Text fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.

(Geerbt von BaseDataList)
CaptionAlign

Ruft die horizontale oder die vertikale Position des HTML-Beschriftungselements in einem Steuerelement ab oder legt diese fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.

(Geerbt von BaseDataList)
CellPadding

Ruft den Abstand zwischen dem Inhalt einer Zelle und ihrem Rahmen ab oder legt diesen fest.

(Geerbt von BaseDataList)
CellSpacing

Ruft den Abstand zwischen den Zellen ab oder legt diesen fest.

(Geerbt von BaseDataList)
ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.

(Geerbt von Control)
ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.

(Geerbt von Control)
Columns

Ruft eine Auflistung von Objekten ab, die die Spalten des DataGrid-Steuerelements darstellen.

Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das eine Auflistung von untergeordneten Steuerelementen eines Datenauflistungssteuerelements enthält.

(Geerbt von BaseDataList)
ControlStyle

Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ControlStyleCreated

Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CssClass

Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest.

(Geerbt von WebControl)
CurrentPageIndex

Ruft den Index der derzeit angezeigten Seite ab oder legt diesen fest.

DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.

(Geerbt von Control)
DataKeyField

Ruft das Schlüsselfeld in der Datenquelle ab, die von der DataSource-Eigenschaft angegeben wurde, oder legt dieses fest.

(Geerbt von BaseDataList)
DataKeys

Ruft ein DataKeyCollection-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement gespeichert sind.

(Geerbt von BaseDataList)
DataKeysArray

Ruft ein ArrayList-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement enthalten sind.

(Geerbt von BaseDataList)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.

(Geerbt von Control)
DataMember

Ruft in einer Datenquelle mit mehreren Membern einen bestimmten Datenmember ab, der an ein Datenauflistungssteuerelement gebunden werden soll, oder legt diesen fest.

(Geerbt von BaseDataList)
DataSource

Ruft die Quelle mit einer Werteliste ab, die zum Auffüllen der Elemente im Steuerelement verwendet wird, oder legt diese fest.

(Geerbt von BaseDataList)
DataSourceID

Ruft die ID-Eigenschaft des Datenquellen-Steuerelements ab, von dem das Datenauflistungssteuerelement seine Datenquelle abrufen soll, oder legt diese Eigenschaft fest.

(Geerbt von BaseDataList)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.

(Geerbt von Control)
EditItemIndex

Ruft den Index eines Elements im zu bearbeitenden DataGrid-Steuerelement ab oder legt diesen fest.

EditItemStyle

Ruft die Stileigenschaften für das zur Bearbeitung im DataGrid-Steuerelement ausgewählte Element ab.

Enabled

Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest.

(Geerbt von WebControl)
EnableTheming

Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest.

(Geerbt von WebControl)
EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Control)
Font

Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind.

(Geerbt von WebControl)
FooterStyle

Ruft die Stileigenschaften des Footerzeilenbereichs im DataGrid-Steuerelement ab.

ForeColor

Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest.

(Geerbt von WebControl)
GridLines

Ruft einen Wert ab, der angibt, ob der Rahmen zwischen den Zellen eines Datenauflistungssteuerelements angezeigt wird, oder legt diesen fest.

(Geerbt von BaseDataList)
HasAttributes

Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden.

(Geerbt von WebControl)
HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.

(Geerbt von Control)
HeaderStyle

Ruft die Stileigenschaften des Headerzeilenbereichs im DataGrid-Steuerelement ab.

Height

Ruft die Höhe des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
HorizontalAlign

Ruft die horizontale Ausrichtung eines Datenauflistungssteuerelements in dessen Container ab oder legt diese fest.

(Geerbt von BaseDataList)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.

(Geerbt von Control)
Initialized

Ruft einen Wert ab, der angibt, ob das Steuerelement initialisiert wurde.

(Geerbt von BaseDataList)
IsBoundUsingDataSourceID

Ruft einen Wert ab, der angibt, ob die DataSourceID-Eigenschaft festgelegt ist.

(Geerbt von BaseDataList)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.

(Geerbt von Control)
IsEnabled

Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist.

(Geerbt von WebControl)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.

(Geerbt von Control)
Items

Ruft eine Auflistung der DataGridItem-Objekte ab, die die einzelnen Elemente im DataGrid-Steuerelement darstellen.

ItemStyle

Ruft die Stileigenschaften für die Elemente im DataGrid-Steuerelement ab.

LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.

(Geerbt von Control)
NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.

(Geerbt von Control)
Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.

(Geerbt von Control)
PageCount

Ruft die Anzahl der für die Anzeige der Elemente im DataGrid-Steuerelement insgesamt benötigten Seiten ab.

PagerStyle

Ruft die Stileigenschaften für den Paginierungsbereich des DataGrid-Steuerelements ab.

PageSize

Ruft die Anzahl der Elemente ab, die auf einer einzelnen Seite des DataGrid-Steuerelements angezeigt werden sollen, oder legt diese fest.

Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.

(Geerbt von Control)
RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.

(Geerbt von Control)
RequiresDataBinding

Ruft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement an seine angegebene Datenquelle gebunden werden muss, oder legt diesen fest.

(Geerbt von BaseDataList)
SelectArguments

Ruft ein DataSourceSelectArguments-Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellen-Steuerelement verwendet wird.

(Geerbt von BaseDataList)
SelectedIndex

Ruft den Index des ausgewählten Elements im DataGrid-Steuerelement ab oder legt diesen fest.

SelectedItem

Ruft ein DataGridItem-Objekt ab, das das im DataGrid-Steuerelement ausgewählte Element darstellt.

SelectedItemStyle

Ruft die Stileigenschaften für das derzeit im DataGrid-Steuerelement ausgewählte Element ab.

ShowFooter

Ruft einen Wert ab, der angibt, ob die Footerzeile im DataGrid-Steuerelement angezeigt wird, oder legt diesen fest.

ShowHeader

Ruft einen Wert ab, der angibt, ob die Headerzeile im DataGrid-Steuerelement angezeigt wird, oder legt diesen fest.

Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.

(Geerbt von Control)
SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.

(Geerbt von WebControl)
Style

Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden.

(Geerbt von WebControl)
SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist.

(Geerbt von BaseDataList)
TabIndex

Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.

(Geerbt von WebControl)
TagKey

Ruft den HtmlTextWriterTag-Wert für das DataGrid-Steuerelement ab.

TagKey

Ruft den HtmlTextWriterTag-Wert ab, der diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
TagName

Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.

(Geerbt von Control)
ToolTip

Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest.

(Geerbt von WebControl)
UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.

(Geerbt von Control)
UseAccessibleHeader

Ruft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement den zugehörigen Header in einem barrierefreien Format rendert, oder legt diesen Wert fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.

(Geerbt von BaseDataList)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.

(Geerbt von Control)
VirtualItemCount

Ruft bei Verwendung von benutzerdefiniertem Paging die virtuelle Anzahl von Elementen im DataGrid-Steuerelement ab oder legt diese fest.

Visible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.

(Geerbt von Control)
Width

Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest.

(Geerbt von WebControl)

Methoden

AddAttributesToRender(HtmlTextWriter)

Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert wurde, und fügt das Element der ControlCollection-Auflistung des Serversteuerelements hinzu.

(Geerbt von BaseDataList)
ApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.

(Geerbt von Control)
CopyBaseAttributes(WebControl)

Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CreateChildControls()

Erstellt ein untergeordnetes Steuerelement unter Verwendung des Ansichtszustands.

(Geerbt von BaseDataList)
CreateColumnSet(PagedDataSource, Boolean)

Erstellt den Satz von Spalten, der zum Erstellen der Steuerelementhierarchie verwendet werden soll. Wenn AutoGenerateColumns auf true festgelegt ist, werden die Spalten gemäß der Datenquelle erstellt und an den in der Columns-Auflistung definierten Spaltensatz angehängt.

CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.

(Geerbt von Control)
CreateControlHierarchy(Boolean)

Erstellt die Steuerelementhierarchie, die für das Rendering von DataGrid verwendet wird.

CreateControlStyle()

Erstellt einen neuen Steuerelementstil.

CreateDataSourceSelectArguments()

Erstellt ein vom datengebundenen Steuerelement verwendetes DataSourceSelectArguments-Standardobjekt, wenn keine Argumente angegeben wurden.

(Geerbt von BaseDataList)
CreateItem(Int32, Int32, ListItemType)

Erstellt ein DataGridItem-Objekt.

DataBind()

Bindet das Steuerelement und alle seine untergeordneten Steuerelemente an die angegebene Datenquelle.

(Geerbt von BaseDataList)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

(Geerbt von Control)
EnsureDataBound()

Überprüft vor dem Aufrufen der DataBind()-Methode, ob für das Datenauflistungssteuerelement eine Datenbindung erforderlich ist und ob ein gültiges Datenquellen-Steuerelement angegeben wurde.

(Geerbt von BaseDataList)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.

(Geerbt von Control)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.

(Geerbt von Control)
GetData()

Gibt ein durch IEnumerable implementiertes Objekt zurück, das die Datenquelle darstellt.

(Geerbt von BaseDataList)
GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.

(Geerbt von Control)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.

(Geerbt von Control)
HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.

(Geerbt von Control)
InitializeItem(DataGridItem, DataGridColumn[])

Initialisiert das angegebene DataGridItem-Objekt.

InitializePager(DataGridItem, Int32, PagedDataSource)

Erstellt ein DataGridItem-Objekt, das die Pagingbenutzeroberfläche enthält.

IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.

(Geerbt von Control)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.

(Geerbt von Control)
LoadViewState(Object)

Lädt einen gespeicherten Zustand von DataGrid.

MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MergeStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
OnBubbleEvent(Object, EventArgs)

Bewegt das von einem Steuerelement im Container ausgelöste Ereignis in der Hierarchie der UI-Serversteuerelemente der Seite nach oben.

OnCancelCommand(DataGridCommandEventArgs)

Löst das CancelCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis eines BaseDataList-Steuerelements aus.

(Geerbt von BaseDataList)
OnDataPropertyChanged()

Wird aufgerufen, wenn eine der Identifikationseigenschaften der Basisdatenquelle geändert wird, um das datengebundene Steuerelement erneut an seine Daten zu binden.

(Geerbt von BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)

Löst das DataSourceViewChanged-Ereignis aus.

(Geerbt von BaseDataList)
OnDeleteCommand(DataGridCommandEventArgs)

Löst das DeleteCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnEditCommand(DataGridCommandEventArgs)

Löst das EditCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnInit(EventArgs)

Löst das Init-Ereignis für das BaseDataList-Steuerelement aus.

(Geerbt von BaseDataList)
OnItemCommand(DataGridCommandEventArgs)

Löst das ItemCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnItemCreated(DataGridItemEventArgs)

Löst das ItemCreated-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnItemDataBound(DataGridItemEventArgs)

Löst das ItemDataBound-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnLoad(EventArgs)

Löst das Load-Ereignis aus.

(Geerbt von BaseDataList)
OnPageIndexChanged(DataGridPageChangedEventArgs)

Löst das PageIndexChanged-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.

(Geerbt von BaseDataList)
OnSelectedIndexChanged(EventArgs)

Löst das SelectedIndexChanged-Ereignis eines BaseDataList-Steuerelements aus.

(Geerbt von BaseDataList)
OnSortCommand(DataGridSortCommandEventArgs)

Löst das SortCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OnUnload(EventArgs)

Löst das Unload-Ereignis aus.

(Geerbt von Control)
OnUpdateCommand(DataGridCommandEventArgs)

Löst das UpdateCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.

OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.

(Geerbt von Control)
PrepareControlHierarchy()

Richtet die Steuerelementhierarchie für dieses DataGrid-Steuerelement ein.

RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.

(Geerbt von Control)
RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.

(Geerbt von Control)
Render(HtmlTextWriter)

Rendert das Steuerelement im angegebenen HTML-Writer.

(Geerbt von BaseDataList)
RenderBeginTag(HtmlTextWriter)

Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt.

(Geerbt von Control)
RenderContents(HtmlTextWriter)

Rendert den Inhalt des Steuerelements im angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.

(Geerbt von Control)
RenderEndTag(HtmlTextWriter)

Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

(Geerbt von Control)
SaveViewState()

Speichert den aktuellen Zustand von DataGrid.

SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Markiert den Anfangspunkt, an dem mit dem Verfolgen und Speichern von Änderungen am Steuerelement im Rahmen des Ansichtszustands des Steuerelements begonnen wird.

Ereignisse

CancelCommand

Tritt ein, wenn auf die Schaltfläche Cancel für ein Element im DataGrid-Steuerelement geklickt wird.

DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.

(Geerbt von Control)
DeleteCommand

Tritt ein, wenn für ein Element im DataGrid-Steuerelement auf die Schaltfläche Löschen geklickt wird.

Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.

(Geerbt von Control)
EditCommand

Tritt ein, wenn für ein Element im DataGrid-Steuerelement auf die Schaltfläche Bearbeiten geklickt wird.

Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.

(Geerbt von Control)
ItemCommand

Tritt ein, wenn auf eine beliebige Schaltfläche im DataGrid-Steuerelement geklickt wird.

ItemCreated

Tritt auf dem Server ein, wenn im DataGrid-Steuerelement ein Element erstellt wird.

ItemDataBound

Tritt ein, nachdem ein Element an das DataGrid-Steuerelement datengebunden wurde.

Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.

(Geerbt von Control)
PageIndexChanged

Tritt ein, wenn auf eines der Seitenauswahlelemente geklickt wird.

PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.

(Geerbt von Control)
SelectedIndexChanged

Tritt ein, wenn in einem Datenauflistungssteuerelement zwischen Übermittlungen zum Server ein anderes Element ausgewählt wird.

(Geerbt von BaseDataList)
SortCommand

Tritt beim Sortieren einer Spalte ein.

Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.

(Geerbt von Control)
UpdateCommand

Tritt ein, wenn auf die Schaltfläche Update für ein Element im DataGrid-Steuerelement geklickt wird.

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String)

Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.

(Geerbt von WebControl)
IAttributeAccessor.SetAttribute(String, String)

Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest.

(Geerbt von WebControl)
IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).

(Geerbt von Control)

Erweiterungsmethoden

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.

GetDefaultValues(INamingContainer)

Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab.

GetMetaTable(INamingContainer)

Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab.

SetMetaTable(INamingContainer, MetaTable)

Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable, Object)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.

TryGetMetaTable(INamingContainer, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.

EnableDynamicData(INamingContainer, Type)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

EnableDynamicData(INamingContainer, Type, Object)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

Gilt für:

Weitere Informationen