DetailsView Classe
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.
Affiche les valeurs d’un enregistrement unique d’une source de données dans une table, où chaque ligne de données représente un champ de l’enregistrement. Le contrôle DetailsView vous permet de modifier, de supprimer et d’insérer des enregistrements.
public ref class DetailsView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IPostBackContainer
public ref class DetailsView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IDataBoundItemControl, System::Web::UI::WebControls::IFieldControl, System::Web::UI::WebControls::IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DetailsView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DetailsView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IDataBoundItemControl, System.Web.UI.WebControls.IFieldControl, System.Web.UI.WebControls.IPostBackContainer
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DetailsView = class
inherit CompositeDataBoundControl
interface IDataItemContainer
interface INamingContainer
interface ICallbackContainer
interface ICallbackEventHandler
interface IPostBackEventHandler
interface IPostBackContainer
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DetailsView = class
inherit CompositeDataBoundControl
interface IDataItemContainer
interface INamingContainer
interface ICallbackContainer
interface ICallbackEventHandler
interface IPostBackEventHandler
interface IPostBackContainer
interface IDataBoundItemControl
interface IDataBoundControl
interface IFieldControl
Public Class DetailsView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataItemContainer, IPostBackContainer, IPostBackEventHandler
Public Class DetailsView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataBoundItemControl, IDataItemContainer, IFieldControl, IPostBackContainer, IPostBackEventHandler
- Héritage
- Attributs
- Implémente
Exemples
L’exemple de code suivant montre comment utiliser un DetailsView contrôle en combinaison avec un GridView contrôle pour un scénario maître-détail simple. Il affiche les détails d’un élément sélectionné dans le GridView contrôle.
<%@ 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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<table>
<tr>
<td>
<asp:GridView ID="GridView1" runat="server"
AutoGenerateColumns="False" DataSourceID="Customers"
DataKeyNames="CustomerID">
<Columns>
<asp:CommandField ShowSelectButton="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
</Columns>
</asp:GridView>
</td>
<td valign="top">
<asp:DetailsView ID="DetailsView1" runat="server"
AutoGenerateRows="True" DataKeyNames="CustomerID"
DataSourceID="Details" Height="50px" Width="301px">
</asp:DetailsView>
</td>
</tr>
</table>
<asp:SqlDataSource ID="Details" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
<SelectParameters>
<asp:ControlParameter ControlID="GridView1" Name="CustomerID"
PropertyName="SelectedValue"
Type="String" />
</SelectParameters>
</asp:SqlDataSource>
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
</asp:SqlDataSource>
</div>
</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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<table>
<tr>
<td>
<asp:GridView ID="GridView1" runat="server"
AutoGenerateColumns="False" DataSourceID="Customers"
DataKeyNames="CustomerID">
<Columns>
<asp:CommandField ShowSelectButton="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
</Columns>
</asp:GridView>
</td>
<td valign="top">
<asp:DetailsView ID="DetailsView1" runat="server"
AutoGenerateRows="True" DataKeyNames="CustomerID"
DataSourceID="Details" Height="50px" Width="301px">
</asp:DetailsView>
</td>
</tr>
</table>
<asp:SqlDataSource ID="Details" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
<SelectParameters>
<asp:ControlParameter ControlID="GridView1" Name="CustomerID"
PropertyName="SelectedValue"
Type="String" />
</SelectParameters>
</asp:SqlDataSource>
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
</asp:SqlDataSource>
</div>
</form>
</body>
</html>
L’exemple de code suivant montre comment utiliser le DetailsView contrôle pour ajouter, supprimer et modifier des enregistrements.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomerDetail_ItemInserted(object sender,
DetailsViewInsertedEventArgs e)
{
// Refresh the GridView control after a new record is inserted
// in the DetailsView control.
CustomersView.DataBind();
}
void CustomerDetail_ItemInserting(object sender,
DetailsViewInsertEventArgs e)
{
// Iterate though the values entered by the user and HTML encode
// the values. This helps prevent malicious values from being
// stored in the data source.
for (int i = 0; i < e.Values.Count; i++)
{
if (e.Values[i] != null)
{
e.Values[i] = Server.HtmlEncode(e.Values[i].ToString());
}
}
}
void CustomerDetail_ItemUpdated(object sender,
DetailsViewUpdatedEventArgs e)
{
// Refresh the GridView control after a new record is updated
// in the DetailsView control.
CustomersView.DataBind();
}
void CustomerDetail_ItemUpdating(object sender,
DetailsViewUpdateEventArgs e)
{
// Iterate though the values entered by the user and HTML encode
// the values. This helps prevent malicious values from being
// stored in the data source.
for (int i = 0; i < e.NewValues.Count; i++)
{
if (e.NewValues[i] != null)
{
e.NewValues[i] = Server.HtmlEncode(e.NewValues[i].ToString());
}
}
}
void CustomerDetail_ItemDeleted(object sender,
DetailsViewDeletedEventArgs e)
{
// Refresh the GridView control after a new record is updated
// in the DetailsView control.
CustomersView.DataBind();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>
DetailsView Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>
DetailsView Example</h3>
<table cellspacing="10">
<tr>
<td>
<!-- Use a GridView control in combination with -->
<!-- a DetailsView control to display master-detail -->
<!-- information. When the user selects a store from -->
<!-- GridView control, the customers//s detailed -->
<!-- information is displayed in the DetailsView -->
<!-- control. -->
<asp:GridView ID="CustomersView" DataSourceID="Customers"
AutoGenerateColumns="False"
DataKeyNames="CustomerID" runat="server">
<HeaderStyle BackColor="Blue" ForeColor="White" />
<Columns>
<asp:CommandField ShowSelectButton="True" />
<asp:BoundField DataField="ContactName"
HeaderText="ContactName" />
<asp:BoundField DataField="CompanyName"
HeaderText="CompanyName" />
</Columns>
</asp:GridView>
</td>
<td valign="top">
<asp:DetailsView ID="CustomerDetail"
DataSourceID="Details" AutoGenerateRows="false"
AutoGenerateInsertButton="true"
AutoGenerateEditButton="true"
AutoGenerateDeleteButton="true"
EmptyDataText="No records."
DataKeyNames="CustomerID" GridLines="Both"
OnItemInserted="CustomerDetail_ItemInserted"
OnItemInserting="CustomerDetail_ItemInserting"
OnItemUpdated="CustomerDetail_ItemUpdated"
OnItemUpdating="CustomerDetail_ItemUpdating"
OnItemDeleted="CustomerDetail_ItemDeleted"
runat="server">
<HeaderStyle BackColor="Navy" ForeColor="White" />
<RowStyle BackColor="White" />
<AlternatingRowStyle BackColor="LightGray" />
<EditRowStyle BackColor="LightCyan" />
<Fields>
<asp:BoundField DataField="CustomerID" HeaderText="CustomerID" ReadOnly="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
<asp:BoundField DataField="Address" HeaderText="Address" />
<asp:BoundField DataField="City" HeaderText="City" />
<asp:BoundField DataField="Region" HeaderText="Region" />
<asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
<asp:BoundField DataField="Country" HeaderText="Country" />
<asp:BoundField DataField="Phone" HeaderText="Phone" />
<asp:BoundField DataField="Fax" HeaderText="Fax" />
</Fields>
</asp:DetailsView>
</td>
</tr>
</table>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<!-- It is strongly recommended that each data-bound -->
<!-- control uses a separate data source control. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID]
FROM [Customers]">
</asp:SqlDataSource>
<!-- Add a filter to the data source control for the -->
<!-- DetailsView control to display the details of the -->
<!-- store selected in the GridView control. -->
<asp:SqlDataSource ID="Details"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
runat="server"
SelectCommand="SELECT * FROM [Customers]
WHERE ([CustomerID] = @CustomerID)"
DeleteCommand="DELETE FROM [Customers]
WHERE [CustomerID] = @CustomerID"
InsertCommand="INSERT INTO [Customers] ([CustomerID],
[CompanyName], [ContactName], [ContactTitle], [Address],
[City], [Region], [PostalCode], [Country], [Phone], [Fax])
VALUES (@CustomerID, @CompanyName, @ContactName, @ContactTitle,
@Address, @City, @Region, @PostalCode, @Country, @Phone, @Fax)"
UpdateCommand="UPDATE [Customers] SET [CompanyName] = @CompanyName,
[ContactName] = @ContactName, [ContactTitle] = @ContactTitle,
[Address] = @Address, [City] = @City, [Region] = @Region,
[PostalCode] = @PostalCode, [Country] = @Country,
[Phone] = @Phone, [Fax] = @Fax
WHERE [CustomerID] = @CustomerID">
<SelectParameters>
<asp:ControlParameter ControlID="CustomersView"
Name="CustomerID" PropertyName="SelectedValue"
Type="String" />
</SelectParameters>
<DeleteParameters>
<asp:Parameter Name="CustomerID" Type="String" />
</DeleteParameters>
<UpdateParameters>
<asp:Parameter Name="CompanyName" Type="String" />
<asp:Parameter Name="ContactName" Type="String" />
<asp:Parameter Name="ContactTitle" Type="String" />
<asp:Parameter Name="Address" Type="String" />
<asp:Parameter Name="City" Type="String" />
<asp:Parameter Name="Region" Type="String" />
<asp:Parameter Name="PostalCode" Type="String" />
<asp:Parameter Name="Country" Type="String" />
<asp:Parameter Name="Phone" Type="String" />
<asp:Parameter Name="Fax" Type="String" />
<asp:Parameter Name="CustomerID" Type="String" />
</UpdateParameters>
<InsertParameters>
<asp:Parameter Name="CustomerID" Type="String" />
<asp:Parameter Name="CompanyName" Type="String" />
<asp:Parameter Name="ContactName" Type="String" />
<asp:Parameter Name="ContactTitle" Type="String" />
<asp:Parameter Name="Address" Type="String" />
<asp:Parameter Name="City" Type="String" />
<asp:Parameter Name="Region" Type="String" />
<asp:Parameter Name="PostalCode" Type="String" />
<asp:Parameter Name="Country" Type="String" />
<asp:Parameter Name="Phone" Type="String" />
<asp:Parameter Name="Fax" Type="String" />
</InsertParameters>
</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">
<script runat="server">
Sub CustomerDetail_ItemInserted(ByVal sender As Object, _
ByVal e As DetailsViewInsertedEventArgs)
' Refresh the GridView control after a new record is inserted in
' the DetailsView control.
CustomersView.DataBind()
End Sub
Sub CustomerDetail_ItemInserting(ByVal sender As Object, _
ByVal e As DetailsViewInsertEventArgs)
' Iterate though the values entered by the user and HTML encode
' the values. This helps prevent malicious values from being
' stored in the data source.
For i As Integer = 0 To e.Values.Count - 1
If e.Values(i) IsNot Nothing Then
e.Values(i) = Server.HtmlEncode(e.Values(i).ToString())
End If
Next
End Sub
Sub CustomerDetail_ItemUpdated(ByVal sender As Object, _
ByVal e As DetailsViewUpdatedEventArgs)
' Refresh the GridView control after a new record is updated
' in the DetailsView control.
CustomersView.DataBind()
End Sub
Sub CustomerDetail_ItemUpdating(ByVal sender As Object, _
ByVal e As DetailsViewUpdateEventArgs)
' Iterate though the values entered by the user and HTML encode
' the values. This helps prevent malicious values from being
' stored in the data source.
For i As Integer = 0 To e.NewValues.Count - 1
If e.NewValues(i) IsNot Nothing Then
e.NewValues(i) = Server.HtmlEncode(e.NewValues(i).ToString())
End If
Next
End Sub
Sub CustomerDetail_ItemDeleted(ByVal sender As Object, _
ByVal e As DetailsViewDeletedEventArgs)
' Refresh the GridView control after a new record is updated
' in the DetailsView control.
CustomersView.DataBind()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView Example</h3>
<table cellspacing="10">
<tr>
<td>
<!-- Use a GridView control in combination with -->
<!-- a DetailsView control to display master-detail -->
<!-- information. When the user selects a store from -->
<!-- GridView control, the customers's detailed -->
<!-- information is displayed in the DetailsView -->
<!-- control. -->
<asp:GridView ID="CustomersView" DataSourceID="Customers"
AutoGenerateColumns="False"
DataKeyNames="CustomerID" runat="server">
<HeaderStyle BackColor="Blue" ForeColor="White" />
<Columns>
<asp:CommandField ShowSelectButton="True" />
<asp:BoundField DataField="ContactName"
HeaderText="ContactName" />
<asp:BoundField DataField="CompanyName"
HeaderText="CompanyName" />
</Columns>
</asp:GridView>
</td>
<td valign="top">
<asp:DetailsView ID="CustomerDetail" DataSourceID="Details"
AutoGenerateRows="false"
AutoGenerateInsertButton="true"
AutoGenerateEditButton="true"
AutoGenerateDeleteButton="true"
EmptyDataText="No records."
DataKeyNames="CustomerID" GridLines="Both"
OnItemInserted="CustomerDetail_ItemInserted"
OnItemInserting="CustomerDetail_ItemInserting"
OnItemUpdated="CustomerDetail_ItemUpdated"
OnItemUpdating="CustomerDetail_ItemUpdating"
OnItemDeleted="CustomerDetail_ItemDeleted"
runat="server">
<HeaderStyle BackColor="Navy" ForeColor="White" />
<RowStyle BackColor="White" />
<AlternatingRowStyle BackColor="LightGray" />
<EditRowStyle BackColor="LightCyan" />
<Fields>
<asp:BoundField DataField="CustomerID" HeaderText="CustomerID"
ReadOnly="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
<asp:BoundField DataField="Address" HeaderText="Address" />
<asp:BoundField DataField="City" HeaderText="City" />
<asp:BoundField DataField="Region" HeaderText="Region" />
<asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
<asp:BoundField DataField="Country" HeaderText="Country" />
<asp:BoundField DataField="Phone" HeaderText="Phone" />
<asp:BoundField DataField="Fax" HeaderText="Fax" />
</Fields>
</asp:DetailsView>
</td>
</tr>
</table>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<!-- It is strongly recommended that each data-bound -->
<!-- control uses a separate data source control. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID]
FROM [Customers]">
</asp:SqlDataSource>
<!-- Add a filter to the data source control for the -->
<!-- DetailsView control to display the details of the -->
<!-- store selected in the GridView control. -->
<asp:SqlDataSource ID="Details"
ConnectionString=
"<%$ ConnectionStrings:NorthwindConnectionString %>"
runat="server"
SelectCommand="SELECT * FROM [Customers]
WHERE ([CustomerID] = @CustomerID)"
DeleteCommand="DELETE FROM [Customers]
WHERE [CustomerID] = @CustomerID"
InsertCommand="INSERT INTO [Customers] ([CustomerID],
[CompanyName], [ContactName], [ContactTitle], [Address],
[City], [Region], [PostalCode], [Country], [Phone], [Fax])
VALUES (@CustomerID, @CompanyName, @ContactName,
@ContactTitle, @Address, @City, @Region, @PostalCode,
@Country, @Phone, @Fax)"
UpdateCommand="UPDATE [Customers] SET
[CompanyName] = @CompanyName,
[ContactName] = @ContactName, [ContactTitle] = @ContactTitle,
[Address] = @Address, [City] = @City, [Region] = @Region,
[PostalCode] = @PostalCode, [Country] = @Country,
[Phone] = @Phone, [Fax] = @Fax
WHERE [CustomerID] = @CustomerID">
<SelectParameters>
<asp:ControlParameter ControlID="CustomersView"
Name="CustomerID" PropertyName="SelectedValue"
Type="String" />
</SelectParameters>
<DeleteParameters>
<asp:Parameter Name="CustomerID" Type="String" />
</DeleteParameters>
<UpdateParameters>
<asp:Parameter Name="CompanyName" Type="String" />
<asp:Parameter Name="ContactName" Type="String" />
<asp:Parameter Name="ContactTitle" Type="String" />
<asp:Parameter Name="Address" Type="String" />
<asp:Parameter Name="City" Type="String" />
<asp:Parameter Name="Region" Type="String" />
<asp:Parameter Name="PostalCode" Type="String" />
<asp:Parameter Name="Country" Type="String" />
<asp:Parameter Name="Phone" Type="String" />
<asp:Parameter Name="Fax" Type="String" />
<asp:Parameter Name="CustomerID" Type="String" />
</UpdateParameters>
<InsertParameters>
<asp:Parameter Name="CustomerID" Type="String" />
<asp:Parameter Name="CompanyName" Type="String" />
<asp:Parameter Name="ContactName" Type="String" />
<asp:Parameter Name="ContactTitle" Type="String" />
<asp:Parameter Name="Address" Type="String" />
<asp:Parameter Name="City" Type="String" />
<asp:Parameter Name="Region" Type="String" />
<asp:Parameter Name="PostalCode" Type="String" />
<asp:Parameter Name="Country" Type="String" />
<asp:Parameter Name="Phone" Type="String" />
<asp:Parameter Name="Fax" Type="String" />
</InsertParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
L’exemple de code suivant montre comment ajouter de manière déclarative des champs de ligne au DetailsView contrôle.
<%@ 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>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<table cellspacing="10">
<tr>
<td>
<!-- Use a GridView control in combination with -->
<!-- a DetailsView control to display master-detail -->
<!-- information. When the user selects a store from -->
<!-- GridView control, the store's detailed -->
<!-- information is displayed in the DetailsView -->
<!-- control. -->
<asp:GridView ID="GridView1" runat="server"
DataSourceID="Customers" AutoGenerateColumns="False"
DataKeyNames="CustomerID">
<Columns>
<asp:CommandField ShowSelectButton="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
</Columns>
</asp:GridView>
</td>
<td valign="top">
<asp:DetailsView ID="DetailsView" runat="server"
DataSourceID="Details" AutoGenerateRows="false"
DataKeyNames="CustomerID" >
<HeaderStyle BackColor="Navy" ForeColor="White" />
<Fields>
<asp:BoundField DataField="CustomerID" HeaderText="CustomerID"
ReadOnly="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
<asp:BoundField DataField="City" HeaderText="City" />
<asp:BoundField DataField="Region" HeaderText="Region" />
<asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
<asp:BoundField DataField="Country" HeaderText="Country" />
</Fields>
</asp:DetailsView>
</td>
</tr>
</table>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<!-- It is strongly recommended that each data-bound -->
<!-- control uses a separate data source control. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
</asp:SqlDataSource>
<!-- Add a filter to the data source control for the -->
<!-- DetailsView control to display the details of the -->
<!-- store selected in the GridView control. -->
<asp:SqlDataSource ID="Details" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
<SelectParameters>
<asp:ControlParameter ControlID="GridView1" Name="CustomerID"
PropertyName="SelectedValue"
Type="String" />
</SelectParameters>
</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>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<table cellspacing="10">
<tr>
<td>
<!-- Use a GridView control in combination with -->
<!-- a DetailsView control to display master-detail -->
<!-- information. When the user selects a store from -->
<!-- GridView control, the store's detailed -->
<!-- information is displayed in the DetailsView -->
<!-- control. -->
<asp:GridView ID="GridView1" runat="server"
DataSourceID="Customers" AutoGenerateColumns="False"
DataKeyNames="CustomerID">
<Columns>
<asp:CommandField ShowSelectButton="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
</Columns>
</asp:GridView>
</td>
<td valign="top">
<asp:DetailsView ID="DetailsView" runat="server"
DataSourceID="Details" AutoGenerateRows="false"
DataKeyNames="CustomerID" >
<HeaderStyle BackColor="Navy" ForeColor="White" />
<Fields>
<asp:BoundField DataField="CustomerID" HeaderText="CustomerID"
ReadOnly="True" />
<asp:BoundField DataField="ContactName" HeaderText="ContactName" />
<asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
<asp:BoundField DataField="City" HeaderText="City" />
<asp:BoundField DataField="Region" HeaderText="Region" />
<asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
<asp:BoundField DataField="Country" HeaderText="Country" />
</Fields>
</asp:DetailsView>
</td>
</tr>
</table>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<!-- It is strongly recommended that each data-bound -->
<!-- control uses a separate data source control. -->
<asp:SqlDataSource ID="Customers" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
</asp:SqlDataSource>
<!-- Add a filter to the data source control for the -->
<!-- DetailsView control to display the details of the -->
<!-- store selected in the GridView control. -->
<asp:SqlDataSource ID="Details" runat="server"
ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
<SelectParameters>
<asp:ControlParameter ControlID="GridView1" Name="CustomerID"
PropertyName="SelectedValue"
Type="String" />
</SelectParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
Remarques
Dans cette rubrique :
Introduction
Le DetailsView contrôle est utilisé pour afficher un enregistrement unique à partir d’une source de données dans une table, où chaque champ de l’enregistrement est affiché dans une ligne de la table. Il peut être utilisé en combinaison avec un GridView contrôle pour les scénarios maître-détail. Le DetailsView contrôle prend en charge les fonctionnalités suivantes :
Liaison à des contrôles de source de données, tels que SqlDataSource.
Fonctionnalités d’insertion intégrées.
Fonctionnalités intégrées de mise à jour et de suppression.
Fonctionnalités de pagination intégrées.
Accès par programmation au DetailsView modèle objet pour définir dynamiquement les propriétés, gérer les événements, etc.
Apparence personnalisable via des thèmes et des styles.
Champs de ligne
Chaque ligne de données du DetailsView contrôle est créée en déclarant un contrôle de champ. Différents types de champs de ligne déterminent le comportement des lignes dans le contrôle. Les contrôles de champ dérivent de DataControlField. Le tableau suivant répertorie les différents types de champs de ligne qui peuvent être utilisés.
Type de champ de colonne | Description |
---|---|
BoundField | Affiche la valeur d’un champ dans une source de données sous forme de texte. |
ButtonField | Affiche un bouton de commande dans le DetailsView contrôle. Cela vous permet d’afficher une ligne avec un contrôle de bouton personnalisé, tel qu’un bouton Ajouter ou Supprimer. |
CheckBoxField | Affiche une case à cocher dans le DetailsView contrôle. Ce type de champ de ligne est couramment utilisé pour afficher les champs avec une valeur booléenne. |
CommandField | Affiche les boutons de commande intégrés pour effectuer des opérations de modification, d’insertion ou de suppression dans le DetailsView contrôle. |
HyperLinkField | Affiche la valeur d’un champ dans une source de données sous la forme d’un lien hypertexte. Ce type de champ de ligne vous permet de lier un deuxième champ à l’URL du lien hypertexte. |
ImageField | Affiche une image dans le DetailsView contrôle. |
TemplateField | Affiche le contenu défini par l’utilisateur pour une ligne dans le DetailsView contrôle en fonction d’un modèle spécifié. Ce type de champ de ligne vous permet de créer un champ de ligne personnalisé. |
Par défaut, la propriété a la AutoGenerateRowstrue
valeur , ce qui génère automatiquement un objet de champ de ligne lié pour chaque champ d’un type pouvant être lié dans la source de données. Les types pouvant être liés valides sont String, DateTime, Decimal, Guidet l’ensemble de types primitifs. 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.
La génération automatique des lignes permet d’afficher rapidement et facilement 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 déclarer les champs de ligne, définissez d’abord la AutoGenerateRows propriété sur false
. Ensuite, ajoutez des balises d’ouverture et de fermeture <Fields>
entre les balises d’ouverture et de fermeture du DetailsView contrôle. Enfin, répertoriez les champs de ligne que vous souhaitez inclure entre les balises d’ouverture et de fermeture <Fields>
. Les champs de ligne spécifiés sont ajoutés à la Fields collection dans l’ordre indiqué. La Fields collection vous permet de gérer par programmation les champs de ligne dans le DetailsView contrôle.
Notes
Les champs de ligne générés automatiquement ne sont pas ajoutés à la Fields collection.
Notes
Les champs de ligne déclarés explicitement peuvent être affiché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 rendus en premier, suivis des champs de ligne générés automatiquement.
Liaison à des données
Le DetailsView contrôle peut être lié à un contrôle de source de données (tel que le contrôle ou ObjectDataSource le SqlDataSource contrôle) ou à toute collection de source de données qui implémente l’interfaceSystem.Collections.IEnumerable, comme System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou d’autres types de collection. Utilisez l’une des méthodes suivantes pour lier le DetailsView contrôle au type de source de données approprié :
Pour établir une liaison à un contrôle de source de données, définissez la DataSourceID propriété du DetailsView contrôle sur la ID valeur du contrôle de source de données. Le DetailsView contrôle se lie automatiquement au contrôle de source de données spécifié. Il s’agit de la méthode recommandée pour lier des données.
Pour établir une liaison à une source de données qui implémente l’interface System.Collections.IEnumerable , définissez par programmation la DataSource propriété du DetailsView contrôle sur la source de données, puis appelez la DataBind méthode.
Pour plus d’informations sur la liaison de données, consultez Liaison à des bases de données.
Sécurité
Ce contrôle peut être utilisé pour afficher l’entrée utilisateur, qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou tout autre code avant de les afficher dans votre application. ASP.NET fournit une fonctionnalité de validation de demande d’entrée pour bloquer le script et le code HTML dans l’entrée utilisateur. Pour plus d’informations, consultez Vue d’ensemble des attaques de script. Des contrôles serveur de validation sont également fournis pour évaluer les entrées utilisateur. Pour plus d’informations, consultez Syntaxe du contrôle du serveur de validation.
Opérations de données
Le DetailsView contrôle fournit des fonctionnalités intégrées qui permettent à l’utilisateur de mettre à jour, de supprimer, d’insérer et de pager des éléments dans le contrôle. Lorsque le DetailsView contrôle est lié à un contrôle de source de données, le DetailsView contrôle peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de mise à jour, de suppression, d’insertion et de pagination automatiques.
Notes
Le DetailsView contrôle peut prendre en charge les opérations de mise à jour, de suppression, d’insertion et de pagination avec d’autres types de sources de données. Toutefois, vous devez fournir l’implémentation de ces opérations dans un gestionnaire d’événements approprié. Pour plus d'informations, consultez ItemDeleting, ItemInserting et ItemUpdating.
Le DetailsView contrôle peut ajouter automatiquement un CommandField champ de ligne avec un bouton Modifier, Supprimer ou Nouveau en définissant les AutoGenerateEditButtonpropriétés true
, AutoGenerateDeleteButtonou AutoGenerateInsertButton sur , respectivement. Contrairement au bouton Supprimer (qui supprime immédiatement l’enregistrement sélectionné), lorsque vous cliquez sur le bouton Modifier ou Nouveau, le DetailsView contrôle passe en mode édition ou insertion, respectivement. En mode Édition, le bouton Modifier est remplacé par un bouton Mettre à jour et un bouton Annuler. Les contrôles d’entrée appropriés pour le type de données du champ (par exemple, un TextBox ou un CheckBox contrôle) s’affichent avec la valeur d’un champ que l’utilisateur peut modifier. Cliquer sur le bouton Mettre à jour met à jour l’enregistrement dans la source de données, tandis que cliquer sur le bouton Annuler abandonne toute modification. De même, en mode Insertion, le bouton Nouveau est remplacé par un bouton Insérer et un bouton Annuler, et des contrôles d’entrée vides s’affichent pour que l’utilisateur entre les valeurs du nouvel enregistrement.
Notes
Vous pouvez également définir manuellement les boutons de commande mettre à jour, supprimer et insérer dans un ButtonFieldchamp , CommandFieldou TemplateField de ligne. Le DetailsView contrôle reconnaît les boutons dont la CommandName propriété est définie sur « Modifier », « Mettre à jour », « Supprimer », « Nouveau », « Insérer » ou « Annuler ». Toutefois, vous devez toujours fournir la fonctionnalité vous-même. Pour plus d'informations, consultez ItemDeleting, ItemInserting et ItemUpdating.
Le DetailsView contrôle fournit une fonctionnalité de pagination, qui permet à l’utilisateur de naviguer vers d’autres enregistrements dans la source de données. Lorsque cette option est activée, les contrôles de navigation de page s’affichent dans une ligne du pagineur. Pour activer la pagination, définissez la propriété sur AllowPagingtrue
. La ligne du pagineur peut être personnalisée à l’aide des PagerStyle propriétés et PagerSettings .
Personnalisation de l’interface utilisateur
Vous pouvez personnaliser l’apparence du DetailsView contrôle en définissant les propriétés de style pour différentes parties du contrôle. Le tableau suivant répertorie les propriétés de style que vous pouvez définir.
Propriété Style | Description |
---|---|
AlternatingRowStyle | Paramètres de style pour les lignes de données alternées dans le DetailsView contrôle. Lorsque cette propriété est définie, les lignes de données sont affichées dans des bandes, en alternance entre les RowStyle paramètres et les AlternatingRowStyle paramètres. |
CommandRowStyle | Paramètres de style pour la ligne qui contient les boutons de commande intégrés. |
EditRowStyle | Paramètres de style pour les lignes de données lorsque le DetailsView contrôle est en mode édition. |
EmptyDataRowStyle | Paramètres de style pour la ligne de données vide qui s’affichent dans le DetailsView contrôle lorsque la source de données ne contient pas d’enregistrements. |
FooterStyle | Paramètres de style pour la ligne de pied de page. |
HeaderStyle | Paramètres de style de la ligne d’en-tête. |
InsertRowStyle | Paramètres de style pour les lignes de données lorsque le DetailsView contrôle est en mode insertion. |
PagerStyle | Paramètres de style de la ligne du pagineur. |
RowStyle | Paramètres de style pour les lignes de données dans le DetailsView contrôle. Lorsque la AlternatingRowStyle propriété est également définie, les lignes de données s’affichent en alternance entre les RowStyle paramètres et les AlternatingRowStyle paramètres. |
FieldHeaderStyle | Paramètres de style pour la colonne d’en-tête. |
Événements
Le DetailsView contrôle fournit plusieurs événements sur lesquels vous pouvez programmer. Cela vous permet d’exécuter une routine personnalisée chaque fois qu’un événement se produit. Le tableau suivant répertorie les événements pris en charge par le DetailsView contrôle. Le DetailsView contrôle hérite également de ces événements de ses classes de base : DataBinding, DataBound, Disposed, Init, Load, , PreRenderet Render.
Événement | Description |
---|---|
ItemCommand | Se produit lors d'un clic sur le bouton d'un contrôle DetailsView. |
ItemCreated | Se produit après la création de tous les DetailsViewRow objets dans le DetailsView contrôle. Cet événement est souvent utilisé pour modifier les valeurs d’un enregistrement avant son affichage. |
ItemDeleted | Se produit lorsqu’un bouton Supprimer est cliqué, mais après que le DetailsView contrôle a supprimé l’enregistrement de la source de données. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de suppression. |
ItemDeleting | Se produit quand un bouton Supprimer est cliqué, mais avant que le DetailsView contrôle supprime l’enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l’opération de suppression. |
ItemInserted | Se produit quand un bouton Insérer est cliqué, mais après que le DetailsView contrôle insère l’enregistrement. Cet événement est souvent utilisé pour vérifier les résultats de l’opération d’insertion. |
ItemInserting | Se produit lorsqu’un bouton Insérer est cliqué, mais avant que le DetailsView contrôle insère l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération d’insertion. |
ItemUpdated | Se produit lorsqu’un bouton Mettre à jour est cliqué, mais après que le DetailsView contrôle a mis à jour la ligne. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de mise à jour. |
ItemUpdating | Se produit lorsqu’un bouton Mettre à jour est cliqué, mais avant que le DetailsView contrôle ne met à jour l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération de mise à jour. |
ModeChanged | Se produit après que le contrôle change de DetailsView mode (mode édition, insertion ou mode lecture seule). Cet événement est souvent utilisé pour effectuer une tâche lorsque le contrôle change de DetailsView mode. |
ModeChanging | Se produit avant que le contrôle change de DetailsView mode (édition, insertion ou mode lecture seule). Cet événement est souvent utilisé pour annuler un changement de mode. |
PageIndexChanged | Se produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle DetailsView a géré l'opération de pagination. Cet événement est couramment utilisé lorsque vous devez effectuer une tâche après que l’utilisateur accède à un autre enregistrement dans le contrôle. |
PageIndexChanging | Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle DetailsView n'ait géré l'opération de pagination. Cet événement est souvent utilisé pour annuler l’opération de pagination. |
Accessibilité
Pour plus d’informations sur la configuration de ce contrôle afin qu’il génère un balisage conforme aux normes d’accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et ASP.NET contrôles et accessibilité.
Syntaxe déclarative
<asp:DetailsView
AccessKey="string"
AllowPaging="True|False"
AutoGenerateDeleteButton="True|False"
AutoGenerateEditButton="True|False"
AutoGenerateInsertButton="True|False"
AutoGenerateRows="True|False"
BackColor="color name|#dddddd"
BackImageUrl="uri"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataKeyNames="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DefaultMode="ReadOnly|Edit|Insert"
EmptyDataText="string"
Enabled="True|False"
EnablePagingCallbacks="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
FooterText="string"
ForeColor="color name|#dddddd"
GridLines="None|Horizontal|Vertical|Both"
HeaderText="string"
Height="size"
HorizontalAlign="NotSet|Left|Center|Right|Justify"
ID="string"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnItemCommand="ItemCommand event handler"
OnItemCreated="ItemCreated event handler"
OnItemDeleted="ItemDeleted event handler"
OnItemDeleting="ItemDeleting event handler"
OnItemInserted="ItemInserted event handler"
OnItemInserting="ItemInserting event handler"
OnItemUpdated="ItemUpdated event handler"
OnItemUpdating="ItemUpdating event handler"
OnLoad="Load event handler"
OnModeChanged="ModeChanged event handler"
OnModeChanging="ModeChanging event handler"
OnPageIndexChanged="PageIndexChanged event handler"
OnPageIndexChanging="PageIndexChanging event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PageIndex="integer"
PagerSettings-FirstPageImageUrl="uri"
PagerSettings-FirstPageText="string"
PagerSettings-LastPageImageUrl="uri"
PagerSettings-LastPageText="string"
PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|NumericFirstLast"
PagerSettings-NextPageImageUrl="uri"
PagerSettings-NextPageText="string"
PagerSettings-PageButtonCount="integer"
PagerSettings-Position="Bottom|Top|TopAndBottom"
PagerSettings-PreviousPageImageUrl="uri"
PagerSettings-PreviousPageText="string"
PagerSettings-Visible="True|False"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
Visible="True|False"
Width="size"
>
<AlternatingRowStyle />
<CommandRowStyle />
<EditRowStyle />
<EmptyDataRowStyle />
<EmptyDataTemplate>
<!-- child controls -->
</EmptyDataTemplate>
<FieldHeaderStyle />
<Fields>
<asp:BoundField
AccessibleHeaderText="string"
ApplyFormatInEditMode="True|False"
ConvertEmptyStringToNull="True|False"
DataField="string"
DataFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
HtmlEncode="True|False"
InsertVisible="True|False"
NullDisplayText="string"
ReadOnly="True|False"
ShowHeader="True|False"
SortExpression="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:BoundField>
<asp:ButtonField
AccessibleHeaderText="string"
ButtonType="Button|Image|Link"
CausesValidation="True|False"
CommandName="string"
DataTextField="string"
DataTextFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
ImageUrl="uri"
InsertVisible="True|False"
ShowHeader="True|False"
SortExpression="string"
Text="string"
ValidationGroup="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:ButtonField>
<asp:CheckBoxField
AccessibleHeaderText="string"
DataField="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
ReadOnly="True|False"
ShowHeader="True|False"
SortExpression="string"
Text="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:CheckBoxField>
<asp:CommandField
AccessibleHeaderText="string"
ButtonType="Button|Image|Link"
CancelImageUrl="uri"
CancelText="string"
CausesValidation="True|False"
DeleteImageUrl="uri"
DeleteText="string"
EditImageUrl="uri"
EditText="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertImageUrl="uri"
InsertText="string"
InsertVisible="True|False"
NewImageUrl="uri"
NewText="string"
SelectImageUrl="uri"
SelectText="string"
ShowCancelButton="True|False"
ShowDeleteButton="True|False"
ShowEditButton="True|False"
ShowHeader="True|False"
ShowInsertButton="True|False"
ShowSelectButton="True|False"
SortExpression="string"
UpdateImageUrl="uri"
UpdateText="string"
ValidationGroup="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:CommandField>
<asp:DynamicField
AccessibleHeaderText="string"
ApplyFormatInEditMode="True|False"
ConvertEmptyStringToNull="True|False"
DataField="string"
DataFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
HtmlEncode="True|False"
InsertVisible="True|False"
NullDisplayText="string"
ShowHeader="True|False"
UIHint="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:DynamicField>
<asp:HyperLinkField
AccessibleHeaderText="string"
DataNavigateUrlFields="string"
DataNavigateUrlFormatString="string"
DataTextField="string"
DataTextFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
NavigateUrl="uri"
ShowHeader="True|False"
SortExpression="string"
Target="string|_blank|_parent|_search|_self|_top"
Text="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:HyperLinkField>
<asp:ImageField
AccessibleHeaderText="string"
AlternateText="string"
ConvertEmptyStringToNull="True|False"
DataAlternateTextField="string"
DataAlternateTextFormatString="string"
DataImageUrlField="string"
DataImageUrlFormatString="string"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
NullDisplayText="string"
NullImageUrl="uri"
ReadOnly="True|False"
ShowHeader="True|False"
SortExpression="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
</asp:ImageField>
<asp:TemplateField
AccessibleHeaderText="string"
ConvertEmptyStringToNull="True|False"
FooterText="string"
HeaderImageUrl="uri"
HeaderText="string"
InsertVisible="True|False"
ShowHeader="True|False"
SortExpression="string"
Visible="True|False"
>
<ControlStyle />
<FooterStyle />
<HeaderStyle />
<ItemStyle />
<AlternatingItemTemplate>
<!-- child controls -->
</AlternatingItemTemplate>
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<InsertItemTemplate>
<!-- child controls -->
</InsertItemTemplate>
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
</asp:TemplateField>
</Fields>
<FooterStyle />
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderStyle />
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<InsertRowStyle />
<PagerSettings
FirstPageImageUrl="uri"
FirstPageText="string"
LastPageImageUrl="uri"
LastPageText="string"
Mode="NextPrevious|Numeric|NextPreviousFirstLast|
NumericFirstLast"
NextPageImageUrl="uri"
NextPageText="string"
OnPropertyChanged="PropertyChanged event handler"
PageButtonCount="integer"
Position="Bottom|Top|TopAndBottom"
PreviousPageImageUrl="uri"
PreviousPageText="string"
Visible="True|False"
/>
<PagerStyle />
<PagerTemplate>
<!-- child controls -->
</PagerTemplate>
<RowStyle />
</asp:DetailsView>
Constructeurs
DetailsView() |
Initialise une nouvelle instance de la classe DetailsView. |
Propriétés
AccessKey |
Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl) |
Adapter |
Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
AllowPaging |
Obtient ou définit une valeur indiquant si la fonctionnalité de pagination est activée. |
AlternatingRowStyle |
Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence des lignes de données en alternance dans un contrôle DetailsView. |
AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control) |
Attributes |
Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl) |
AutoGenerateDeleteButton |
Obtient ou définit une valeur indiquant si le contrôle intégré pour supprimer l'enregistrement actuel s'affiche dans un contrôle DetailsView. |
AutoGenerateEditButton |
Obtient ou définit une valeur indiquant si les contrôles intégrés pour modifier l'enregistrement actuel s'affichent dans un contrôle DetailsView. |
AutoGenerateInsertButton |
Obtient ou définit une valeur indiquant si les contrôles intégrés pour insérer un nouvel enregistrement s'affichent dans un contrôle DetailsView. |
AutoGenerateRows |
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. |
BackColor |
Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl) |
BackImageUrl |
Obtient ou définit l'URL d'une image à afficher à l'arrière-plan d'un contrôle DetailsView. |
BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
BorderColor |
Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl) |
BorderStyle |
Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl) |
BorderWidth |
Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl) |
BottomPagerRow |
Obtient un objet DetailsViewRow qui représente la ligne du bas de pagineur dans un contrôle DetailsView. |
Caption |
Obtient ou définit le texte à afficher dans un élément de légende HTML d'un contrôle DetailsView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance. |
CaptionAlign |
Obtient ou définit la position horizontale ou verticale de l'élément de légende HTML dans un contrôle DetailsView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance. |
CellPadding |
Obtient ou définit l'espace entre le contenu d'une cellule et la bordure de celle-ci. |
CellSpacing |
Obtient ou définit l'espace entre les cellules. |
ChildControlsCreated |
Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
ClientID |
Obtient l’ID de contrôle du balisage HTML généré par ASP.NET. (Hérité de Control) |
ClientIDMode |
Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control) |
ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control) |
CommandRowStyle |
Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence d'une ligne de commande dans un contrôle DetailsView. |
Context |
Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control) |
Controls |
Obtient une collection de contrôles enfants dans le contrôle composite lié aux données. (Hérité de CompositeDataBoundControl) |
ControlStyle |
Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
ControlStyleCreated |
Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
CssClass |
Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
CurrentMode |
Obtient le mode d'entrée des données actuel du contrôle DetailsView. |
DataItem |
Obtient l'élément de données lié au contrôle DetailsView. |
DataItemContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control) |
DataItemCount |
Obtient le nombre d'éléments dans la source de données sous-jacente. |
DataItemIndex |
Obtient l'index de l'élément qui est affiché dans un contrôle DetailsView provenant de la source de données sous-jacente. |
DataKey |
Obtient un objet DataKey qui représente la clé primaire de l'enregistrement affiché. |
DataKeyNames |
Obtient ou définit un tableau qui contient les noms des champs clés pour la source de données. |
DataKeysContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control) |
DataMember |
Obtient ou définit le nom de la liste des données auxquelles le contrôle lié aux données se lie, dans les cas où la source de données contient plusieurs listes distinctes d'éléments de données. (Hérité de DataBoundControl) |
DataSource |
Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de BaseDataBoundControl) |
DataSourceID |
Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données. (Hérité de DataBoundControl) |
DataSourceObject |
Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet. (Hérité de DataBoundControl) |
DefaultMode |
Obtient ou définit le mode d'entrée par défaut du contrôle DetailsView. |
DeleteMethod |
Obtient ou définit le nom de la méthode dans la page appelée lorsque le contrôle effectue une opération de suppression. |
DeleteMethod |
Obtient ou définit le nom de la méthode à appeler afin de supprimer des données. (Hérité de CompositeDataBoundControl) |
DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control) |
EditRowStyle |
Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence des lignes de données lorsqu'un contrôle DetailsView est en mode édition. |
EmptyDataRowStyle |
Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données vide affichée lorsque la source de données liée à un contrôle DetailsView ne contient pas d'enregistrements. |
EmptyDataTemplate |
Obtient ou définit le contenu défini par l'utilisateur de la ligne de données vide rendue lorsqu'un contrôle DetailsView est lié à une source de données qui ne contient pas d'enregistrements. |
EmptyDataText |
Obtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu'un contrôle DetailsView est lié à une source de données qui ne contient pas d'enregistrements. |
Enabled |
Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl) |
EnableModelValidation |
Obtient ou définit une valeur qui indique si la validation de modèle de données est activée. |
EnablePagingCallbacks |
Obtient ou définit une valeur indiquant si les fonctions de rappel côté client sont utilisées pour les opérations de pagination dans le contrôle DetailsView. |
EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl) |
EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
Events |
Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
FieldHeaderStyle |
Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la colonne d'en-tête dans un contrôle DetailsView. |
Fields |
Obtient une collection d'objets DataControlField qui représentent les champs de ligne déclarés explicitement dans un contrôle DetailsView. |
Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
FooterRow |
Obtient un objet DetailsViewRow qui représente la ligne de pied de page dans un contrôle DetailsView. |
FooterStyle |
Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pied de page dans un contrôle DetailsView. |
FooterTemplate |
Obtient ou définit le contenu défini par l'utilisateur pour la ligne de pied de page dans un contrôle DetailsView. |
FooterText |
Obtient ou définit le texte à afficher dans la ligne de pied de page d'un contrôle DetailsView. |
ForeColor |
Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl) |
GridLines |
Obtient ou définit le style de quadrillage d'un contrôle DetailsView. |
HasAttributes |
Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl) |
HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control) |
HeaderRow |
Obtient un objet DetailsViewRow qui représente la ligne d'en-tête dans un contrôle DetailsView. |
HeaderStyle |
Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne d'en-tête dans un contrôle DetailsView. |
HeaderTemplate |
Obtient ou définit le contenu défini par l'utilisateur pour la ligne d'en-tête dans un contrôle DetailsView. |
HeaderText |
Obtient ou définit le texte à afficher dans la ligne d'en-tête d'un contrôle DetailsView. |
Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
HorizontalAlign |
Obtient ou définit l'alignement horizontal d'un contrôle DetailsView sur la page. |
ID |
Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control) |
IdSeparator |
Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control) |
Initialized |
Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl) |
InsertMethod |
Obtient ou définit le nom de la méthode dans la page appelée lorsque le contrôle effectue une opération d'insertion. |
InsertMethod |
Obtient ou définit le nom de la méthode à appeler afin d'insérer des données. (Hérité de CompositeDataBoundControl) |
InsertRowStyle |
Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence des lignes de données dans un contrôle DetailsView lorsque le contrôle DetailsView est en mode insertion. |
IsBoundUsingDataSourceID |
Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl) |
IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control) |
IsDataBindingAutomatic |
Obtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl) |
IsEnabled |
Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl) |
IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control) |
IsUsingModelBinders |
Obtient une valeur qui indique si la liaison de modèle est utilisée. (Hérité de CompositeDataBoundControl) |
IsViewStateEnabled |
Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control) |
ItemType |
Obtient ou définit le nom du type d'élément de données pour la liaison de données fortement typée. (Hérité de DataBoundControl) |
LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control) |
NamingContainer |
Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur. (Hérité de Control) |
Page |
Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control) |
PageCount |
Obtient le nombre d'enregistrements dans la source de données. |
PageIndex |
Obtient ou définit l'index de l'enregistrement affiché. |
PagerSettings |
Obtient une référence à l'objet PagerSettings vous permettant de définir les propriétés des boutons du pagineur dans un contrôle DetailsView. |
PagerStyle |
Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pagineur dans un contrôle DetailsView. |
PagerTemplate |
Obtient ou définit le contenu personnalisé de la ligne de pagineur dans un contrôle DetailsView. |
Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control) |
RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control) |
RequiresDataBinding |
Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée. (Hérité de BaseDataBoundControl) |
Rows |
Obtient une collection d'objets DetailsViewRow qui représentent les lignes de données d'un contrôle DetailsView. |
RowsGenerator |
Obtient ou définit un objet qui implémente l'interface IAutoFieldGenerator afin de renseigner automatiquement des lignes dans la vue. |
RowStyle |
Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de lignes de données dans un contrôle DetailsView. |
SelectArguments |
Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données d'un contrôle de source de données. (Hérité de DataBoundControl) |
SelectedValue |
Obtient la valeur de clés des données de l'enregistrement en cours dans un contrôle DetailsView. |
SelectMethod |
Nom de la méthode à appeler pour pouvoir lire les données. (Hérité de DataBoundControl) |
Site |
Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control) |
SkinID |
Obtient ou définit l’apparence à appliquer au contrôle. (Hérité de WebControl) |
Style |
Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl) |
SupportsDisabledAttribute |
Obtient une valeur qui indique si le contrôle doit définir l'attribut |
TabIndex |
Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
TagKey |
Obtient la valeur HtmlTextWriterTag du contrôle DetailsView. |
TagName |
Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
TemplateSourceDirectory |
Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control) |
ToolTip |
Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl) |
TopPagerRow |
Obtient un objet DetailsViewRow qui représente la ligne du haut du pagineur dans un contrôle DetailsView. |
UniqueID |
Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control) |
UpdateMethod |
Obtient ou définit le nom de la méthode dans la page appelée lorsque le contrôle effectue une opération de mise à jour. |
UpdateMethod |
Obtient ou définit le nom de la méthode à appeler afin de mettre à jour des données. (Hérité de CompositeDataBoundControl) |
ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control) |
ViewState |
Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control) |
ViewStateIgnoresCase |
Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control) |
ViewStateMode |
Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control) |
Visible |
Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control) |
Width |
Obtient ou définit la largeur du contrôle serveur web. (Hérité de WebControl) |
Méthodes
AddAttributesToRender(HtmlTextWriter) |
Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
AddedControl(Control, Int32) |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control) |
AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control) |
ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control) |
BeginRenderTracing(TextWriter, Object) |
Commence le traçage au moment du design des données de rendu. (Hérité de Control) |
BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control) |
ChangeMode(DetailsViewMode) |
Bascule le contrôle DetailsView vers le mode spécifié. |
ClearCachedClientID() |
Affecte à la valeur ClientID mise en cache la valeur |
ClearChildControlState() |
Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control) |
ClearChildState() |
Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
ClearChildViewState() |
Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
ClearEffectiveClientIDMode() |
Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control) |
ConfirmInitState() |
Définit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl) |
CopyBaseAttributes(WebControl) |
Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
CreateAutoGeneratedRow(AutoGeneratedFieldProperties) |
Crée un objet AutoGeneratedField qui représente un champ de ligne généré automatiquement à l'aide des propriétés de champ spécifiées. |
CreateAutoGeneratedRows(Object) |
Crée un ensemble de champs de ligne générés automatiquement pour l'élément de données spécifié. |
CreateChildControls() |
Crée la hiérarchie des contrôles utilisée pour restituer un contrôle composite lié aux données basé sur les valeurs qui sont stockées dans l'état d'affichage. (Hérité de CompositeDataBoundControl) |
CreateChildControls(IEnumerable, Boolean) |
Crée la hiérarchie des contrôles utilisée pour rendre le contrôle DetailsView. |
CreateControlCollection() |
Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control) |
CreateControlStyle() |
Crée un objet de style de tableau par défaut pour le contrôle DetailsView. |
CreateDataSourceSelectArguments() |
Crée l'objet DataSourceSelectArguments qui passe à la commande Select. |
CreateFieldSet(Object, Boolean) |
Crée l'ensemble complet de champs de ligne générés automatiquement et de champs définis par l'utilisateur utilisés pour générer la hiérarchie des contrôles. |
CreateRow(Int32, DataControlRowType, DataControlRowState) |
Crée un objet DetailsViewRow à l'aide de l'index de l'élément, du type de ligne et de l'état de ligne spécifiés. |
CreateTable() |
Crée la table conteneur pour le contrôle DetailsView. |
DataBind() |
Appelle la méthode DataBind() de la classe de base. |
DataBind(Boolean) |
Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control) |
DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
DeleteItem() |
Supprime l'enregistrement actuel de la source de données. |
Dispose() |
Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control) |
EndRenderTracing(TextWriter, Object) |
Met fin au traçage au moment du design des données de rendu. (Hérité de Control) |
EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control) |
EnsureDataBound() |
Appelle la méthode DataBind() après avoir vérifié que le contrôle de liste de données nécessite une liaison de données et qu'un contrôle de source de données valide est spécifié. |
EnsureID() |
Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
ExtractRowValues(IOrderedDictionary, Boolean, Boolean) |
Récupère les valeurs de chaque champ affiché et les stocke dans l'objet IOrderedDictionary spécifié. |
FindControl(String) |
Recherche un contrôle serveur possédant le paramètre |
FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
Focus() |
Affecte le focus d'entrée à un contrôle. (Hérité de Control) |
GetCallbackResult() |
Retourne le résultat d'un événement de rappel qui cible un contrôle. |
GetCallbackScript(IButtonControl, String) |
Retourne la chaîne de rappel créée à l'aide de l'argument spécifié. |
GetData() |
Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données. (Hérité de DataBoundControl) |
GetDataSource() |
Récupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant. (Hérité de DataBoundControl) |
GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetRouteUrl(Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
GetRouteUrl(RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
GetRouteUrl(String, Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
GetRouteUrl(String, RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control) |
HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
HasEvents() |
Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control) |
InitializePager(DetailsViewRow, PagedDataSource) |
Crée la ligne de pagineur pour le contrôle DetailsView. |
InitializeRow(DetailsViewRow, DataControlField) |
Initialise l'objet DetailsViewRow spécifié. |
InsertItem(Boolean) |
Insère l'enregistrement actif dans la source de données. |
IsBindableType(Type) |
Détermine si le type de données spécifié peut être lié à un champ dans le contrôle DetailsView. |
IsLiteralContent() |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
LoadControlState(Object) |
Charge l'état des propriétés du contrôle DetailsView à faire persister, même lorsque la propriété EnableViewState a la valeur |
LoadViewState(Object) |
Charge l'état d'affichage enregistré précédemment du contrôle DetailsView. |
MapPathSecure(String) |
Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control) |
MarkAsDataBound() |
Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données. (Hérité de DataBoundControl) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
OnBubbleEvent(Object, EventArgs) |
Détermine si l'événement pour les contrôles serveur Web est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. |
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Déclenche l’événement CreatingModelDataSource. (Hérité de DataBoundControl) |
OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
OnDataBound(EventArgs) |
Déclenche l’événement DataBound. (Hérité de BaseDataBoundControl) |
OnDataPropertyChanged() |
Relie le contrôle lié aux données à ses données après la modification d'une des propriétés de l'identification de la source de données de base. (Hérité de DataBoundControl) |
OnDataSourceViewChanged(Object, EventArgs) |
Déclenche l’événement DataSourceViewChanged. |
OnInit(EventArgs) |
Déclenche l’événement Init. |
OnItemCommand(DetailsViewCommandEventArgs) |
Déclenche l’événement ItemCommand. |
OnItemCreated(EventArgs) |
Déclenche l’événement ItemCreated. |
OnItemDeleted(DetailsViewDeletedEventArgs) |
Déclenche l’événement ItemDeleted. |
OnItemDeleting(DetailsViewDeleteEventArgs) |
Déclenche l’événement ItemDeleting. |
OnItemInserted(DetailsViewInsertedEventArgs) |
Déclenche l’événement ItemInserted. |
OnItemInserting(DetailsViewInsertEventArgs) |
Déclenche l’événement ItemInserting. |
OnItemUpdated(DetailsViewUpdatedEventArgs) |
Déclenche l’événement ItemUpdated. |
OnItemUpdating(DetailsViewUpdateEventArgs) |
Déclenche l’événement ItemUpdating. |
OnLoad(EventArgs) |
Gère l'événement Load. (Hérité de DataBoundControl) |
OnModeChanged(EventArgs) |
Déclenche l’événement ModeChanged. |
OnModeChanging(DetailsViewModeEventArgs) |
Déclenche l’événement ModeChanging. |
OnPageIndexChanged(EventArgs) |
Déclenche l’événement PageIndexChanged. |
OnPageIndexChanging(DetailsViewPageEventArgs) |
Déclenche l’événement PageIndexChanging. |
OnPagePreLoad(Object, EventArgs) |
Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. |
OnPreRender(EventArgs) |
Déclenche l’événement PreRender. |
OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
OpenFile(String) |
Obtient un Stream utilisé pour lire un fichier. (Hérité de Control) |
PerformDataBinding(IEnumerable) |
Lie la source de données spécifiée au contrôle DetailsView. |
PerformSelect() |
Récupère les données de la source de données associée. (Hérité de DataBoundControl) |
PrepareControlHierarchy() |
Définit la hiérarchie des contrôles du contrôle DetailsView. |
RaiseBubbleEvent(Object, EventArgs) |
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control) |
RaiseCallbackEvent(String) |
Crée les arguments du gestionnaire de rappel de la méthode GetCallbackEventReference. |
RaisePostBackEvent(String) |
Déclenche les événements appropriés pour le contrôle DetailsView lors de la publication sur le serveur. |
RemovedControl(Control) |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
Render(HtmlTextWriter) |
Affiche le contrôle DetailsView sur le client à l'aide de l'objet HtmlTextWriter spécifié. |
RenderBeginTag(HtmlTextWriter) |
Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
RenderChildren(HtmlTextWriter) |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
RenderContents(HtmlTextWriter) |
Génère le rendu du contenu du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
RenderControl(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé. (Hérité de Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control) |
RenderEndTag(HtmlTextWriter) |
Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl) |
ResolveAdapter() |
Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control) |
ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
ResolveUrl(String) |
Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control) |
SaveControlState() |
Enregistre l'état des propriétés du contrôle DetailsView à faire persister, même lorsque la propriété EnableViewState a la valeur |
SaveViewState() |
Enregistre l'état d'affichage actuel du contrôle DetailsView. |
SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
SetPageIndex(Int32) |
Définit l'index de la page actuellement affichée dans le contrôle DetailsView. |
SetRenderMethodDelegate(RenderMethod) |
Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control) |
SetTraceData(Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
TrackViewState() |
Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées au contrôle DetailsView. |
UpdateItem(Boolean) |
Met à jour l'enregistrement en cours dans la source de données. |
ValidateDataSource(Object) |
Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner. (Hérité de DataBoundControl) |
Événements
CallingDataMethods |
Se produit lorsque les méthodes de données sont appelées. (Hérité de DataBoundControl) |
CreatingModelDataSource |
Se produit lorsque l'objet ModelDataSource est créé. (Hérité de DataBoundControl) |
DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
DataBound |
Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl) |
Disposed |
Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control) |
Init |
Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control) |
ItemCommand |
Se produit lorsqu'un clic est effectué sur un bouton du contrôle DetailsView. |
ItemCreated |
Se produit lorsqu'un enregistrement est créé dans un contrôle DetailsView. |
ItemDeleted |
Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle DetailsView, mais après l'opération de suppression. |
ItemDeleting |
Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle DetailsView, mais avant l'opération de suppression. |
ItemInserted |
Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle DetailsView, mais après l'opération d'insertion. |
ItemInserting |
Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle DetailsView, mais avant l'opération d'insertion. |
ItemUpdated |
Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle DetailsView, mais après l'opération de mise à jour. |
ItemUpdating |
Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle DetailsView, mais avant l'opération de mise à jour. |
Load |
Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control) |
ModeChanged |
Se produit lorsqu'un contrôle DetailsView tente de basculer entre les modes édition, insertion et lecture seule, mais après la mise à jour de la propriété CurrentMode. |
ModeChanging |
Se produit lorsqu'un contrôle DetailsView tente de basculer entre les modes édition, insertion et lecture seule, mais avant la mise à jour de la propriété CurrentMode. |
PageIndexChanged |
Se produit lorsque la valeur de la propriété PageIndex change après une opération de pagination. |
PageIndexChanging |
Se produit lorsque la valeur de la propriété PageIndex change avant une opération de pagination. |
PreRender |
Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control) |
Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
IAttributeAccessor.SetAttribute(String, String) |
Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl) |
ICallbackContainer.GetCallbackScript(IButtonControl, String) |
Crée le script de rappel pour le contrôle DetailsView. |
ICallbackEventHandler.GetCallbackResult() |
Voir la méthode GetCallbackResult(). |
ICallbackEventHandler.RaiseCallbackEvent(String) |
Déclenche l’événement de rappel à l’aide des arguments spécifiés. |
IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
IDataBoundControl.DataKeyNames |
Pour obtenir une description de cette propriété, consultez DataKeyNames. |
IDataBoundControl.DataMember |
Pour obtenir une description de cette propriété, consultez DataMember. |
IDataBoundControl.DataSource |
Pour obtenir une description de cette propriété, consultez DataSource. |
IDataBoundControl.DataSourceID |
Pour obtenir une description de cette propriété, consultez DataSourceID. |
IDataBoundControl.DataSourceObject |
Pour obtenir une description de cette propriété, consultez DataSourceObject. |
IDataBoundItemControl.DataKey |
Pour obtenir une description de cette propriété, consultez DataKey. |
IDataBoundItemControl.Mode |
Pour obtenir une description de cette propriété, consultez Mode. |
IDataItemContainer.DataItemIndex |
Pour obtenir une description de ce membre, consultez DataItemIndex. |
IDataItemContainer.DisplayIndex |
Pour obtenir une description de ce membre, consultez DisplayIndex. |
IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
IFieldControl.FieldsGenerator |
Pour obtenir une description de cette propriété, consultez FieldsGenerator. |
IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
IPostBackContainer.GetPostBackOptions(IButtonControl) |
Pour obtenir une description de ce membre, consultez GetPostBackOptions(IButtonControl). |
IPostBackEventHandler.RaisePostBackEvent(String) |
Pour obtenir une description de ce membre, consultez RaisePostBackEvent(String). |
Méthodes d’extension
EnablePersistedSelection(BaseDataBoundControl) |
Obsolète.
Permet la conservation de la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination. |
FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
FindFieldTemplate(Control, String) |
Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
FindMetaTable(Control) |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
GetDefaultValues(INamingContainer) |
Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. |
GetMetaTable(INamingContainer) |
Obtient les métadonnées de table pour le contrôle de données spécifié. |
SetMetaTable(INamingContainer, MetaTable) |
Définit les métadonnées de table pour le contrôle de données spécifié. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié. |
TryGetMetaTable(INamingContainer, MetaTable) |
Détermine si des métadonnées de table sont disponibles. |
EnableDynamicData(INamingContainer, Type) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
EnableDynamicData(INamingContainer, Type, Object) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
S’applique à
Voir aussi
- IsPrimitive
- AccessDataSource
- AllowPaging
- AutoGenerateRows
- AutoGenerateDeleteButton
- AutoGenerateEditButton
- AutoGenerateInsertButton
- Fields
- Rows
- BoundField
- ButtonField
- CommandField
- CheckBoxField
- GridView
- HyperLinkField
- SqlDataSource
- TemplateField
- Utilisation de paramètres avec des contrôles de source de données