DetailsView Classe

Définition

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 AutoGenerateRowstruevaleur , 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 disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false.

(Hérité de BaseDataBoundControl)
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 null.

(Hérité de Control)
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 id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
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 false.

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 false.

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