DetailsView.AutoGenerateRows DetailsView.AutoGenerateRows DetailsView.AutoGenerateRows DetailsView.AutoGenerateRows Property

Definizione

Ottiene o imposta un valore che indica se i campi riga di ogni campo dell'origine dati vengono generati automaticamente e visualizzati in un controllo DetailsView.Gets or sets a value indicating whether row fields for each field in the data source are automatically generated and displayed in a DetailsView control.

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

Valore della proprietà

true per visualizzare campi riga associati generati automaticamente per ogni campo dell'origine dati; in caso contrario, false.true to display automatically generated bound row fields for each field in the data source; otherwise, false. Il valore predefinito è true.The default is true.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato AutoGenerateRows come utilizzare la proprietà per creare automaticamente campi riga associati per ogni campo dell'origine dati.The following code example demonstrates how to use the AutoGenerateRows property to automatically create bound row fields for each field in the data source.


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

<!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" >
  <head runat="server">
    <title>DetailsView AutoGenerateRows Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateRows Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!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" >
  <head runat="server">
    <title>DetailsView AutoGenerateRows Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateRows Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Commenti

Ogni riga di dati nel DetailsView controllo è rappresentata da un campo di riga.Each data row in the DetailsView control is represented by a row field. Quando la AutoGenerateRows proprietà è impostata su true, viene creato un campo di riga associato generato automaticamente per ogni campo dell'origine dati.When the AutoGenerateRows property is set to true, an automatically generated bound row field is created for each field in the data source. Ogni campo viene quindi visualizzato in una riga come testo, nell'ordine in cui ogni campo viene visualizzato nell'origine dati.Each field is then displayed in a row as text, in the order in which each field appears in the data source.

Nota

I Fields campi riga associati generati automaticamente non vengono aggiunti alla raccolta.Automatically generated bound row fields are not added to the Fields collection.

La generazione automatica delle righe consente di visualizzare in modo semplice e rapido ogni campo del record.Automatically generating the rows provides a quick and easy way to display every field in the record. Tuttavia, per sfruttare le DetailsView funzionalità avanzate del controllo, è necessario dichiarare DetailsView in modo esplicito i campi riga da includere nel controllo.However, to make use of the DetailsView control's advanced capabilities you must explicitly declare the row fields to include in the DetailsView control. Per ulteriori informazioni, vedere Fields.For more information, see Fields.

Nota

I campi riga dichiarati in modo esplicito possono essere utilizzati in combinazione con i campi riga generati automaticamente.Explicitly declared row fields can be used in combination with automatically generated row fields. Quando vengono utilizzati entrambi, viene eseguito prima il rendering dei campi riga dichiarati in modo esplicito, seguiti dai campi riga generati automaticamente.When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields.

Il valore di AutoGenerateRows viene archiviato nello stato di visualizzazione.The value of AutoGenerateRows is stored in view state.

Si applica a

Vedi anche