DetailsView.AutoGenerateRows Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob Zeilenfelder für jedes Feld in der Datenquelle automatisch generiert und in einem DetailsView-Steuerelement angezeigt werden, oder legt diesen Wert fest.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

Eigenschaftswert

true, um automatisch generierte, gebundene Zeilenfelder für die einzelnen Felder in der Datenquelle anzuzeigen, andernfalls false.true to display automatically generated bound row fields for each field in the data source; otherwise, false. Der Standardwert lautet true.The default is true.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateRows-Eigenschaft verwendet wird, um automatisch gebundene Zeilen Felder für jedes Feld in der Datenquelle zu erstellen.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>

Hinweise

Jede Daten Zeile im DetailsView Steuerelement wird durch ein Zeilen Feld dargestellt.Each data row in the DetailsView control is represented by a row field. Wenn die AutoGenerateRows-Eigenschaft auf truefestgelegt ist, wird für jedes Feld in der Datenquelle ein automatisch generiertes gebundenes Zeilen Feld erstellt.When the AutoGenerateRows property is set to true, an automatically generated bound row field is created for each field in the data source. Jedes Feld wird dann als Text in der Reihenfolge angezeigt, in der die einzelnen Felder in der Datenquelle angezeigt werden.Each field is then displayed in a row as text, in the order in which each field appears in the data source.

Hinweis

Automatisch generierte gebundene Zeilen Felder werden der Fields Auflistung nicht hinzugefügt.Automatically generated bound row fields are not added to the Fields collection.

Das automatische Erstellen der Zeilen bietet eine schnelle und einfache Möglichkeit, jedes Feld im Datensatz anzuzeigen.Automatically generating the rows provides a quick and easy way to display every field in the record. Wenn Sie jedoch die erweiterten Funktionen des DetailsView-Steuer Elements verwenden möchten, müssen Sie die Zeilen Felder, die in das DetailsView Steuerelement eingeschlossen werden sollen, explizit deklarieren.However, to make use of the DetailsView control's advanced capabilities you must explicitly declare the row fields to include in the DetailsView control. Weitere Informationen finden Sie unter Fields.For more information, see Fields.

Hinweis

Explizit deklarierte Zeilen Felder können in Kombination mit automatisch generierten Zeilen Feldern verwendet werden.Explicitly declared row fields can be used in combination with automatically generated row fields. Wenn beide verwendet werden, werden explizit deklarierte Zeilen Felder zuerst gerendert, gefolgt von den automatisch generierten Zeilen Feldern.When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields.

Der Wert von AutoGenerateRows wird im Ansichts Zustand gespeichert.The value of AutoGenerateRows is stored in view state.

Gilt für:

Siehe auch