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 à partir d’une source de données dans une table, où chaque ligne de données représente un champ de l’enregistrement. Le DetailsView contrôle vous permet de modifier, supprimer et 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::IPostBackContainerpublic 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 IFieldControlPublic Class DetailsView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataItemContainer, IPostBackContainer, IPostBackEventHandlerPublic 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 contrôle pour un GridView scénario simple maître-détail. 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 :
Présentation
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 programmatique au DetailsView modèle objet pour définir dynamiquement les propriétés, gérer les événements, et ainsi de suite.
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 du 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 en tant que 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 AutoGenerateRows propriété est définie truesur , 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, , DateTimeDecimal, 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 offre un moyen rapide et facile d’afficher chaque champ dans 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é falsesur . 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.
Note
Les champs de ligne générés automatiquement ne sont pas ajoutés à la Fields collection.
Note
Les champs de ligne explicitement déclarés peuvent être affichés en combinaison avec les 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 à n’importe quelle collection de sources de données qui implémente l’interfaceSystem.Collections.IEnumerable, telle que System.Data.DataView, , System.Collections.ArrayListou System.Collections.Generic.List<T>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 est automatiquement lié au contrôle de source de données spécifié. Il s’agit de la méthode préférée à lier aux données.
Pour établir une liaison à une source de données qui implémente l’interface System.Collections.IEnumerable , définissez par programme 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 aux 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 l’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 exploits de script. Les contrôles de serveur de validation sont également fournis pour évaluer l’entrée utilisateur. Pour plus d’informations, consultez La syntaxe de contrôle du serveur de validation.
Opérations sur les données
Le DetailsView contrôle fournit des fonctionnalités intégrées qui permettent à l’utilisateur de mettre à jour, supprimer, insérer et 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.
Note
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 pour 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 champ de ligne avec un CommandField bouton Modifier, Supprimer ou Nouveau en définissant respectivement les propriétés ou AutoGenerateInsertButton les AutoGenerateEditButtonAutoGenerateDeleteButtonpropriétéstrue. Contrairement au bouton Supprimer (qui supprime immédiatement l’enregistrement sélectionné), lorsque le bouton Modifier ou Nouveau est cliqué, le DetailsView contrôle passe en mode Édition ou Insertion, respectivement. En mode Édition, le bouton Modifier est remplacé par une mise à 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) sont affichés avec la valeur d’un champ que l’utilisateur doit modifier. Cliquer sur le bouton Mettre à jour met à jour l’enregistrement dans la source de données, tout en cliquant sur le bouton Annuler abandonne les modifications. De même, en mode Insertion, le bouton Nouveau est remplacé par un bouton Insertion et Annuler, et les contrôles d’entrée vides s’affichent pour que l’utilisateur entre les valeurs du nouvel enregistrement.
Note
Vous pouvez également définir manuellement les boutons de commande de mise à jour, de suppression et d’insertion dans un champ de CommandFieldligne ou TemplateField de ButtonFieldmise à jour. Le DetailsView contrôle reconnaît les boutons avec la CommandName propriété définie sur « Edit », « Update », « Delete », « New », « Insert » ou « Cancel ». Toutefois, vous devez toujours fournir les fonctionnalités 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 d’accéder à 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 de pagineur. Pour activer la pagination, définissez la AllowPaging propriété sur true. La ligne du pagineur peut être personnalisée à l’aide des propriétés et PagerSettings des PagerStyle propriétés.
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.
| Style, propriété | 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 remplaçant les RowStyle paramètres et les AlternatingRowStyle paramètres. |
| CommandRowStyle | Paramètres de style de 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 de la ligne de données vide qui sont affichés dans le DetailsView contrôle lorsque la source de données ne contient aucun enregistrement. |
| FooterStyle | Paramètres de style de 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 sont affichées en alternance entre les RowStyle paramètres et les AlternatingRowStyle paramètres. |
| FieldHeaderStyle | Paramètres de style de la colonne d’en-tête. |
Événements
Le DetailsView contrôle fournit plusieurs événements que 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, , DataBoundDisposed, Init, Load, PreRenderet Render.
| Événement | Description |
|---|---|
| ItemCommand | Se produit lorsqu’un bouton est cliqué dans le DetailsView contrôle. |
| ItemCreated | Se produit une fois tous les DetailsViewRow objets créés 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 une fois 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 lorsqu’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 lorsqu’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 Insertion 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 une fois que le DetailsView contrôle met à 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 contrôle ne met à jour l’enregistrement DetailsView . Cet événement est souvent utilisé pour annuler l’opération de mise à jour. |
| ModeChanged | Se produit après que le DetailsView contrôle change les modes (mode édition, insertion ou lecture seule). Cet événement est souvent utilisé pour effectuer une tâche lorsque le DetailsView contrôle change de mode. |
| ModeChanging | Se produit avant les modes de modification du DetailsView contrôle (mode édition, insertion ou lecture seule). Cet événement est souvent utilisé pour annuler une modification de mode. |
| PageIndexChanged | Se produit lorsqu’un des boutons du pagineur est cliqué, mais après que le DetailsView contrôle gère l’opération de pagination. Cet événement est couramment utilisé lorsque vous devez effectuer une tâche une fois que l’utilisateur accède à un autre enregistrement dans le contrôle. |
| PageIndexChanging | Se produit lorsqu’un des boutons du pagineur est cliqué, mais avant que le DetailsView contrôle gère 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 des marques conformes 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
| Nom | Description |
|---|---|
| DetailsView() |
Initialise une nouvelle instance de la classe DetailsView. |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au 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 alternées dans un DetailsView contrôle. |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| Attributes |
Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux 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 actif est affiché dans un DetailsView contrôle. |
| AutoGenerateEditButton |
Obtient ou définit une valeur indiquant si les contrôles intégrés pour modifier l’enregistrement actif sont affichés dans un DetailsView contrôle. |
| AutoGenerateInsertButton |
Obtient ou définit une valeur indiquant si les contrôles intégrés pour insérer un nouvel enregistrement sont affichés dans un DetailsView contrôle. |
| AutoGenerateRows |
Obtient ou définit une valeur indiquant si les champs de ligne de chaque champ de la source de données sont générés automatiquement et affichés dans un DetailsView contrôle. |
| 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 en arrière-plan d’un DetailsView contrôle. |
| 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 DetailsViewRow objet qui représente la ligne du pagineur inférieur dans un DetailsView contrôle. |
| Caption |
Obtient ou définit le texte à afficher dans un élément de légende HTML dans un DetailsView contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d’appareils technologiques d’assistance. |
| CaptionAlign |
Obtient ou définit la position horizontale ou verticale de l’élément de légende HTML dans un DetailsView contrôle. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d’appareils technologiques d’assistance. |
| CellPadding |
Obtient ou définit la quantité d’espace entre le contenu d’une cellule et la bordure de la cellule. |
| CellSpacing |
Obtient ou définit la quantité d’espace entre les cellules. |
| ChildControlsCreated |
Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle pour le 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 ClientID propriété. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (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 DetailsView contrôle. |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient une collection des contrôles enfants dans le contrôle composite lié aux données. (Hérité de CompositeDataBoundControl) |
| ControlStyle |
Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ControlStyleCreated |
Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| CssClass |
Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
| CurrentMode |
Obtient le mode d’entrée de données actuel du DetailsView contrôle. |
| DataItem |
Obtient l’élément de données lié au DetailsView contrôle. |
| DataItemContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (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 affiché dans un DetailsView contrôle à partir de la source de données sous-jacente. |
| DataKey |
Obtient un DataKey objet 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 de la source de données. |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (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 est lié, 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 à partir 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 de données par défaut du DetailsView contrôle. |
| DeleteMethod |
Obtient ou définit le nom de la méthode sur la page appelée lorsque le contrôle effectue une opération de suppression. |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface 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 DetailsView contrôle 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 DetailsView contrôle ne contient aucun enregistrement. |
| EmptyDataTemplate |
Obtient ou définit le contenu défini par l’utilisateur pour la ligne de données vide rendue lorsqu’un DetailsView contrôle est lié à une source de données qui ne contient aucun enregistrement. |
| EmptyDataText |
Obtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu’un DetailsView contrôle est lié à une source de données qui ne contient aucun enregistrement. |
| 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 du 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 DetailsView contrôle. |
| 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 des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient une liste de délégués de gestionnaire 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 qui vous permet de définir l’apparence de la colonne d’en-tête dans un DetailsView contrôle. |
| Fields |
Obtient une collection d’objets DataControlField qui représentent les champs de ligne déclarés explicitement dans un DetailsView contrôle. |
| Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
| FooterRow |
Obtient un DetailsViewRow objet qui représente la ligne du pied de page dans un DetailsView contrôle. |
| FooterStyle |
Obtient une référence à l’objet TableItemStyle qui vous permet de définir l’apparence de la ligne du pied de page dans un DetailsView contrôle. |
| FooterTemplate |
Obtient ou définit le contenu défini par l’utilisateur pour la ligne de pied de page dans un DetailsView contrôle. |
| FooterText |
Obtient ou définit le texte à afficher dans la ligne de pied de page d’un DetailsView contrôle. |
| 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 DetailsView contrôle. |
| 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 actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control) |
| HeaderRow |
Obtient un DetailsViewRow objet qui représente la ligne d’en-tête dans un DetailsView contrôle. |
| HeaderStyle |
Obtient une référence à l’objet TableItemStyle qui vous permet de définir l’apparence de la ligne d’en-tête dans un DetailsView contrôle. |
| HeaderTemplate |
Obtient ou définit le contenu défini par l’utilisateur pour la ligne d’en-tête dans un DetailsView contrôle. |
| HeaderText |
Obtient ou définit le texte à afficher dans la ligne d’en-tête d’un DetailsView contrôle. |
| 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 DetailsView contrôle sur la page. |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les 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 sur la page appelée lorsque le contrôle effectue une opération d’insertion. |
| InsertRowStyle |
Obtient une référence à l’objet TableItemStyle qui vous permet de définir l’apparence des lignes de données dans un DetailsView contrôle lorsque le DetailsView contrôle est en mode d’insertion. |
| IsBoundUsingDataSourceID |
Obtient une valeur indiquant si la DataSourceID propriété est définie. (Hérité de BaseDataBoundControl) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de 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 en cours d’utilisation. (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 ID au lieu de l’index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control) |
| Page |
Obtient une référence à l’instance 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 qui vous permet de définir les propriétés des boutons du pagineur dans un DetailsView contrôle. |
| PagerStyle |
Obtient une référence à l’objet TableItemStyle qui vous permet de définir l’apparence de la ligne du pagineur dans un DetailsView contrôle. |
| PagerTemplate |
Obtient ou définit le contenu personnalisé de la ligne du pagineur dans un DetailsView contrôle. |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control) |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| RequiresDataBinding |
Obtient ou définit une valeur indiquant si la DataBind() méthode doit être appelée. (Hérité de BaseDataBoundControl) |
| Rows |
Obtient une collection d’objets qui représentent les lignes de DetailsViewRow données d’un DetailsView contrôle. |
| RowsGenerator |
Obtient ou définit un objet qui implémente l’interface IAutoFieldGenerator afin de remplir automatiquement les lignes dans la vue. |
| RowStyle |
Obtient une référence à l’objet TableItemStyle qui vous permet de définir l’apparence des lignes de données dans un DetailsView contrôle. |
| SelectArguments |
Obtient un DataSourceSelectArguments objet que le contrôle lié aux données utilise lors de la récupération de données à partir d’un contrôle de source de données. (Hérité de DataBoundControl) |
| SelectedValue |
Obtient la valeur de clé de données de l’enregistrement actif dans un DetailsView contrôle. |
| SelectMethod |
Nom de la méthode à appeler pour lire les données. (Hérité de DataBoundControl) |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl) |
| Style |
Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du 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 HtmlTextWriterTag valeur du DetailsView contrôle. |
| TagName |
Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les 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 PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| ToolTip |
Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl) |
| TopPagerRow |
Obtient un DetailsViewRow objet qui représente la ligne du pagineur supérieur dans un DetailsView contrôle. |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control) |
| UpdateMethod |
Obtient ou définit le nom de la méthode sur la page appelée lorsque le contrôle effectue une opération de mise à jour. |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des 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 sur plusieurs requêtes pour la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet ne respecte pas la StateBag 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
| Nom | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Ajoute des attributs et des styles HTML qui doivent être rendus dans le fichier spécifié HtmlTextWriterTag. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection 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 du ControlCollection contrôle serveur. (Hérité de Control) |
| ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les 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 page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi 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 le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ChangeMode(DetailsViewMode) |
Bascule le DetailsView contrôle en mode spécifié. |
| ClearCachedClientID() |
Définit la valeur mise en ClientID cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour 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() |
Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (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 les développeurs de contrôles. (Hérité de WebControl) |
| CreateAutoGeneratedRow(AutoGeneratedFieldProperties) |
Crée un AutoGeneratedField objet 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 de contrôle utilisée pour afficher un contrôle composite lié aux données en fonction des valeurs stockées dans l’état d’affichage. (Hérité de CompositeDataBoundControl) |
| CreateChildControls(IEnumerable, Boolean) |
Crée la hiérarchie de contrôles utilisée pour afficher le DetailsView contrôle. |
| CreateControlCollection() |
Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control) |
| CreateControlStyle() |
Crée un objet de style de table par défaut pour le DetailsView contrôle. |
| CreateDataSourceSelectArguments() |
Crée l’objet DataSourceSelectArguments qui est passé à la commande Select. |
| CreateFieldSet(Object, Boolean) |
Crée l’ensemble complet de champs de ligne générés automatiquement et définis par l’utilisateur utilisés pour générer la hiérarchie de contrôle. |
| CreateRow(Int32, DataControlRowType, DataControlRowState) |
Crée un DetailsViewRow objet à l’aide de l’index d’élément, du type de ligne et de l’état de ligne spécifiés. |
| CreateTable() |
Crée la table conteneur pour le DetailsView contrôle. |
| DataBind() |
Appelle la DataBind() méthode 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 actif de la source de données. |
| Dispose() |
Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi 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. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control) |
| EnsureDataBound() |
Appelle la DataBind() méthode 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 qui n’ont pas d’identificateur affecté. (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 spécifié IOrderedDictionary . |
| FindControl(String, Int32) |
Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur 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 DataSourceView objet que le contrôle lié aux données utilise pour effectuer des opérations de données. (Hérité de DataBoundControl) |
| GetDataSource() |
Récupère l’interface IDataSource avec 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() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetRouteUrl(Object) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble 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 ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la UniqueID propriété 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 les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| InitializePager(DetailsViewRow, PagedDataSource) |
Crée la ligne du pagineur pour le DetailsView contrôle. |
| InitializeRow(DetailsViewRow, DataControlField) |
Initialise l’objet spécifié DetailsViewRow . |
| 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 DetailsView contrôle. |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Charge l’état des propriétés dans le DetailsView contrôle qui doivent être conservées, même lorsque la EnableViewState propriété est définie |
| LoadViewState(Object) |
Charge l’état d’affichage précédemment enregistré du DetailsView contrôle. |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MarkAsDataBound() |
Définit l’état du contrôle dans l’état d’affichage comme étant lié avec succès aux données. (Hérité de DataBoundControl) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement pour le contrôle serveur web est transmis à la hiérarchie de contrôle 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() |
Rebind le contrôle lié aux données à ses données après la modification de l’une des propriétés d’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 le chargement du contrôle. |
| 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 élément utilisé pour lire un fichier. (Hérité de Control) |
| PerformDataBinding(IEnumerable) |
Lie la source de données spécifiée au DetailsView contrôle. |
| PerformSelect() |
Récupère les données de la source de données associée. (Hérité de DataBoundControl) |
| PrepareControlHierarchy() |
Configure la hiérarchie de contrôle du DetailsView contrôle. |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources 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 dans la GetCallbackEventReference méthode. |
| RaisePostBackEvent(String) |
Déclenche les événements appropriés pour le DetailsView contrôle lorsqu’il publie sur le serveur. |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Affiche le DetailsView contrôle sur le client à l’aide de l’objet spécifié HtmlTextWriter . |
| RenderBeginTag(HtmlTextWriter) |
Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderChildren(HtmlTextWriter) |
Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
Restitue le contenu du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control) |
| RenderEndTag(HtmlTextWriter) |
Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle 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 utilisable sur le client demandeur. (Hérité de Control) |
| SaveControlState() |
Enregistre l’état des propriétés dans le DetailsView contrôle qui doivent être conservées, même lorsque la EnableViewState propriété est définie |
| SaveViewState() |
Enregistre l’état d’affichage actuel du DetailsView contrôle. |
| 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 DetailsView contrôle. |
| SetRenderMethodDelegate(RenderMethod) |
Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de 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 pour commencer le suivi et l’enregistrement des modifications de l’état d’affichage dans le DetailsView contrôle. |
| UpdateItem(Boolean) |
Met à jour l’enregistrement actif dans la source de données. |
| ValidateDataSource(Object) |
Vérifie que l’objet auquel un contrôle lié aux données est lié est un contrôle qu’il peut utiliser. (Hérité de DataBoundControl) |
Événements
| Nom | Description |
|---|---|
| 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, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control) |
| ItemCommand |
Se produit lorsqu’un bouton dans un DetailsView contrôle est cliqué. |
| ItemCreated |
Se produit lorsqu’un enregistrement est créé dans un DetailsView contrôle. |
| ItemDeleted |
Se produit lorsqu’un bouton Supprimer dans un DetailsView contrôle est cliqué, mais après l’opération de suppression. |
| ItemDeleting |
Se produit lorsqu’un bouton Supprimer dans un DetailsView contrôle est cliqué, mais avant l’opération de suppression. |
| ItemInserted |
Se produit lorsqu’un bouton Insérer dans un DetailsView contrôle est cliqué, mais après l’opération d’insertion. |
| ItemInserting |
Se produit lorsqu’un bouton Insérer dans un DetailsView contrôle est cliqué, mais avant l’opération d’insertion. |
| ItemUpdated |
Se produit lorsqu’un bouton Mettre à jour dans un DetailsView contrôle est cliqué, mais après l’opération de mise à jour. |
| ItemUpdating |
Se produit lorsqu’un bouton Mettre à jour dans un DetailsView contrôle est cliqué, 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 DetailsView contrôle tente de changer entre le mode d’édition, d’insertion et de lecture seule, mais après la mise à jour de la CurrentMode propriété. |
| ModeChanging |
Se produit lorsqu’un DetailsView contrôle tente de changer entre le mode d’édition, d’insertion et de lecture seule, mais avant la mise à jour de la CurrentMode propriété. |
| PageIndexChanged |
Se produit lorsque la valeur de la PageIndex propriété change après une opération de pagination. |
| PageIndexChanging |
Se produit lorsque la valeur de la PageIndex propriété 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
| Nom | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl) |
| ICallbackContainer.GetCallbackScript(IButtonControl, String) |
Crée le script de rappel pour le DetailsView contrôle. |
| 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
| Nom | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type, Object) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnablePersistedSelection(BaseDataBoundControl) |
Obsolète.
Permet de conserver 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 de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l’objet métatable pour le contrôle de données contenant. |
| 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, IDictionary<String,Object>) |
Définit les métadonnées de table et le mappage de 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 de valeurs par défaut 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é. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Détermine si les métadonnées de table sont disponibles. |
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
