DetailsView.AutoGenerateRows Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, позволяющее определить, создаются ли поля строк для каждого источника данных и отображаются ли они автоматически в элементе управления DetailsView.
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
.
Примеры
В следующем примере кода показано, как использовать свойство для автоматического AutoGenerateRows создания привязанных полей строк для каждого поля в источнике данных.
<%@ 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 управления представлена полем строки. Если свойству AutoGenerateRows присвоено значение true
, для каждого поля в источнике данных создается автоматически созданное связанное поле строки. Затем каждое поле отображается в строке в виде текста в том порядке, в котором каждое поле отображается в источнике данных.
Примечание
Автоматически созданные привязанные поля строк не добавляются в коллекцию Fields .
Автоматическое создание строк обеспечивает быстрый и простой способ отображения каждого поля в записи. Однако для использования расширенных возможностей DetailsView элемента управления необходимо явно объявить поля строк для включения в DetailsView элемент управления. Для получения дополнительной информации см. Fields.
Примечание
Явно объявленные поля строк можно использовать в сочетании с автоматически созданными полями строк. При использовании обоих полей сначала отрисовываются явно объявленные поля строк, за которыми следуют автоматически созданные поля строк.
Значение AutoGenerateRows сохраняется в состоянии представления.