DetailsView.AutoGenerateRows Свойство

Определение

Возвращает или задает значение, позволяющее определить, создаются ли поля строк для каждого источника данных и отображаются ли они автоматически в элементе управления 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

Значение свойства

Значение true для автоматического создания привязанных полей строк для каждого поля в источнике данных; в противном случае — значение false.true to display automatically generated bound row fields for each field in the data source; otherwise, false. Значение по умолчанию — true.The default is true.

Примеры

В следующем примере кода показано, как использовать AutoGenerateRows свойство для автоматического создания привязанных полей строк для каждого поля в источнике данных.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>

Комментарии

Каждая строка данных в DetailsView элементе управления представляется полем строки.Each data row in the DetailsView control is represented by a row field. Если свойство имеет trueзначение, автоматически созданное привязанное поле строки создается для каждого поля в источнике данных. AutoGenerateRowsWhen the AutoGenerateRows property is set to true, an automatically generated bound row field is created for each field in the data source. Каждое поле затем отображается в строке в виде текста в том порядке, в котором каждое поле отображается в источнике данных.Each field is then displayed in a row as text, in the order in which each field appears in the data source.

Примечание

Автоматически созданные поля привязанных строк не добавляются в Fields коллекцию.Automatically generated bound row fields are not added to the Fields collection.

Автоматическое создание строк предоставляет быстрый и простой способ отобразить каждое поле в записи.Automatically generating the rows provides a quick and easy way to display every field in the record. Однако, чтобы использовать DetailsView расширенные возможности элемента управления, необходимо явно объявить поля строк для включения DetailsView в элемент управления.However, to make use of the DetailsView control's advanced capabilities you must explicitly declare the row fields to include in the DetailsView control. Для получения дополнительной информации см. Fields.For more information, see Fields.

Примечание

Явно объявленные поля строк можно использовать в сочетании с автоматически создаваемыми полями строк.Explicitly declared row fields can be used in combination with automatically generated row fields. При использовании обоих типов сначала выводятся явно объявленные поля строк, за которыми следуют автоматически созданные поля строк.When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields.

Значение AutoGenerateRows хранится в состоянии представления.The value of AutoGenerateRows is stored in view state.

Применяется к

Дополнительно