DetailsView.AutoGenerateRows Propriété

Définition

Obtient ou définit une valeur indiquant si les champs de ligne de chaque champ de la source de données sont automatiquement générés et affichés dans un contrôle 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

Valeur de propriété

Boolean

true pour afficher automatiquement les champs de ligne liés générés pour chaque champ dans la source de données ; sinon, false.true to display automatically generated bound row fields for each field in the data source; otherwise, false. La valeur par défaut est true.The default is true.

Exemples

L’exemple de code suivant montre comment utiliser la AutoGenerateRows propriété pour créer automatiquement des champs de ligne liés pour chaque champ de la source de données.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>

Remarques

Chaque ligne de données dans le DetailsView contrôle est représentée par un champ de ligne.Each data row in the DetailsView control is represented by a row field. Lorsque la AutoGenerateRows propriété a la valeur true , un champ de ligne lié généré automatiquement est créé pour chaque champ de la source de données.When the AutoGenerateRows property is set to true, an automatically generated bound row field is created for each field in the data source. Chaque champ est ensuite affiché dans une ligne sous forme de texte, dans l’ordre dans lequel chaque champ apparaît dans la source de données.Each field is then displayed in a row as text, in the order in which each field appears in the data source.

Notes

Les champs de ligne liés générés automatiquement ne sont pas ajoutés à la Fields collection.Automatically generated bound row fields are not added to the Fields collection.

La génération automatique des lignes offre un moyen simple et rapide d’afficher tous les champs de l’enregistrement.Automatically generating the rows provides a quick and easy way to display every field in the record. Toutefois, pour utiliser les DetailsView fonctionnalités avancées du contrôle, vous devez déclarer explicitement les champs de ligne à inclure dans le DetailsView contrôle.However, to make use of the DetailsView control's advanced capabilities you must explicitly declare the row fields to include in the DetailsView control. Pour plus d'informations, consultez Fields.For more information, see Fields.

Notes

Les champs de ligne déclarés explicitement peuvent être utilisés en combinaison avec les champs de ligne générés automatiquement.Explicitly declared row fields can be used in combination with automatically generated row fields. Quand les deux sont utilisés, les champs de ligne déclarés explicitement sont restitués en premier, suivis des champs de ligne générés automatiquement.When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields.

La valeur de AutoGenerateRows est stockée dans l’état d’affichage.The value of AutoGenerateRows is stored in view state.

S’applique à

Voir aussi