DetailsView.AutoGenerateRows Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si se generan automáticamente campos de fila para cada campo del origen de datos y se muestran en un control 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
Valor de propiedad
Es true
para mostrar los campos de fila enlazados generados automáticamente para cada campo del origen de datos; de lo contrario, es false
. De manera predeterminada, es true
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la AutoGenerateRows propiedad para crear automáticamente campos de fila enlazados para cada campo del origen de datos.
<%@ 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>
Comentarios
Cada fila de datos del DetailsView control se representa mediante un campo de fila. Cuando la AutoGenerateRows propiedad se establece true
en , se crea un campo de fila enlazado generado automáticamente para cada campo del origen de datos. A continuación, cada campo se muestra en una fila como texto, en el orden en que cada campo aparece en el origen de datos.
Nota
Los campos de fila enlazados generados automáticamente no se agregan a la Fields colección.
La generación automática de las filas proporciona una manera rápida y sencilla de mostrar todos los campos del registro. Sin embargo, para usar las DetailsView funcionalidades avanzadas del control, debe declarar explícitamente los campos de fila que se incluirán en el DetailsView control. Para obtener más información, vea Fields.
Nota
Los campos de fila declarados explícitamente se pueden usar en combinación con campos de fila generados automáticamente. Cuando se usan ambos, los campos de fila declarados explícitamente se representan primero, seguidos de los campos de fila generados automáticamente.
El valor de AutoGenerateRows se almacena en estado de vista.