DataGrid.AutoGenerateColumns Proprietà

Definizione

Ottiene o imposta un valore che indica se gli oggetti BoundColumn sono creati e visualizzati automaticamente nel controllo DataGrid per ciascun campo nell'origine dati.

public:
 virtual property bool AutoGenerateColumns { bool get(); void set(bool value); };
public virtual bool AutoGenerateColumns { get; set; }
member this.AutoGenerateColumns : bool with get, set
Public Overridable Property AutoGenerateColumns As Boolean

Valore della proprietà

Boolean

true se gli oggetti BoundColumn sono creati e visualizzati automaticamente, altrimenti false. Il valore predefinito è true.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la AutoGenerateColumns proprietà per creare automaticamente un BoundColumn oggetto per ogni campo nell'origine dati.

<%@ 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) 
         {
            // Need to load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>DataGrid AutoGenerateColumns Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid AutoGenerateColumns 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
            ' Need to load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
 
   </script>
 
<head runat="server">
    <title>DataGrid AutoGenerateColumns Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid AutoGenerateColumns 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>

Commenti

Usare questa proprietà per creare automaticamente un BoundColumn oggetto per ogni campo nell'origine dati. Ogni campo viene quindi sottoposto a rendering come colonna nel controllo nell'ordine DataGrid in cui i campi vengono visualizzati nell'origine dati.

Non tutti i tipi di dati possono essere associati al DataGrid controllo. Se un campo contiene un tipo di dati non supportato, non viene creata una colonna per tale campo. Se l'origine dati contiene solo una colonna con un tipo di dati non supportato, viene generata un'eccezione. Nella tabella seguente vengono illustrati i tipi di dati che possono essere associati al controllo.

Tipo di dati Descrizione
Primitive Tipo di dati primitivo, ad System.Int32esempio , DoubleChar, e così via. Per un elenco completo, vedere Type.IsPrimitive.
string Un oggetto System.String.
Datetime Un oggetto System.DateTime.
Decimal Un oggetto System.Decimal.

Nota

Le colonne dichiarate in modo esplicito possono essere usate insieme alle colonne generate automaticamente. Quando si usano entrambe le colonne dichiarate in modo esplicito, verrà eseguito il rendering per primo, seguito dalle colonne generate automaticamente. Le colonne generate automaticamente non vengono aggiunte alla Columns raccolta.

Si applica a

Vedi anche