DetailsView.AutoGenerateRows Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

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

Boolean

true, um automatisch generierte, gebundene Zeilenfelder für die einzelnen Felder in der Datenquelle anzuzeigen, andernfalls false. Der Standardwert ist true.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateRows -Eigenschaft verwendet wird, um automatisch gebundene Zeilenfelder für jedes Feld in der Datenquelle zu erstellen.


<%@ 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 Datenzeile im DetailsView Steuerelement wird durch ein Zeilenfeld dargestellt. Wenn die AutoGenerateRows -Eigenschaft auf truefestgelegt ist, wird für jedes Feld in der Datenquelle ein automatisch generiertes gebundenes Zeilenfeld erstellt. Jedes Feld wird dann in einer Zeile als Text in der Reihenfolge angezeigt, in der jedes Feld in der Datenquelle angezeigt wird.

Hinweis

Automatisch generierte gebundene Zeilenfelder werden der Fields Auflistung nicht hinzugefügt.

Das automatische Generieren der Zeilen bietet eine schnelle und einfache Möglichkeit, alle Felder im Datensatz anzuzeigen. Um jedoch die DetailsView erweiterten Funktionen des Steuerelements nutzen zu können, müssen Sie die Zeilenfelder explizit deklarieren, die in das DetailsView Steuerelement eingeschlossen werden sollen. Weitere Informationen finden Sie unter Fields.

Hinweis

Explizit deklarierte Zeilenfelder können in Kombination mit automatisch generierten Zeilenfeldern verwendet werden. Wenn beide verwendet werden, werden explizit deklarierte Zeilenfelder zuerst gerendert, gefolgt von den automatisch generierten Zeilenfeldern.

Der Wert von AutoGenerateRows wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen