DetailsView.AutoGenerateRows Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si les champs de ligne de chaque champ de la source de données sont automatiquement générés et affichés dans un contrôle 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
Valeur de propriété
true
pour afficher automatiquement les champs de ligne liés générés pour chaque champ dans la source de données ; sinon, false
. La valeur par défaut est true
.
Exemples
L’exemple de code suivant montre comment utiliser la AutoGenerateRows propriété pour créer automatiquement des champs de ligne liés pour chaque champ de la source de données.
<%@ 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>
Remarques
Chaque ligne de données du DetailsView contrôle est représentée par un champ de ligne. Lorsque la AutoGenerateRows propriété est définie true
sur , un champ de ligne lié généré automatiquement est créé pour chaque champ de la source de données. Chaque champ est ensuite affiché dans une ligne sous forme de texte, dans l’ordre dans lequel chaque champ apparaît dans la source de données.
Notes
Les champs de ligne liés générés automatiquement ne sont pas ajoutés à la Fields collection.
La génération automatique des lignes offre un moyen rapide et facile d’afficher chaque champ de l’enregistrement. Toutefois, pour utiliser les DetailsView fonctionnalités avancées du contrôle, vous devez déclarer explicitement les champs de ligne à inclure dans le DetailsView contrôle. Pour plus d'informations, consultez Fields.
Notes
Les champs de ligne déclarés explicitement peuvent être utilisés en combinaison avec des champs de ligne générés automatiquement. Lorsque les deux sont utilisés, les champs de ligne déclarés explicitement sont affichés en premier, suivis des champs de ligne générés automatiquement.
La valeur est AutoGenerateRows stockée dans l’état d’affichage.