DetailsView Clase

Definición

Muestra los valores de un único registro de un origen de datos en una tabla, donde cada fila de datos representa un campo del registro. El control DetailsView permite editar, eliminar e insertar registros.

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
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar para usar un DetailsView control en combinación con un GridView control para un escenario sencillo de maestro y detalles. Muestra los detalles de un elemento seleccionado en el GridView control .

<%@ 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>

En el ejemplo de código siguiente se muestra cómo usar el DetailsView control para agregar, eliminar y editar registros.


<%@ 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>

En el ejemplo de código siguiente se muestra cómo agregar declarativamente campos de fila al DetailsView control .

<%@ 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>

Comentarios

En este tema:

Introducción

El DetailsView control se usa para mostrar un único registro de un origen de datos en una tabla, donde cada campo del registro se muestra en una fila de la tabla. Se puede usar en combinación con un GridView control para escenarios de maestro y detalles. El DetailsView control admite las siguientes características:

  • Enlace a controles de origen de datos, como SqlDataSource.

  • Funcionalidades de inserción integradas.

  • Funcionalidades de actualización y eliminación integradas.

  • Funcionalidades de paginación integradas.

  • Acceso mediante programación al DetailsView modelo de objetos para establecer dinámicamente propiedades, controlar eventos, etc.

  • Apariencia personalizable a través de temas y estilos.

Campos de fila

Cada fila de datos del DetailsView control se crea declarando un control de campo. Los distintos tipos de campo de fila determinan el comportamiento de las filas del control . Los controles de campo derivan de DataControlField. En la tabla siguiente se enumeran los distintos tipos de campo de fila que se pueden usar.

Tipo de campo de columna Descripción
BoundField Muestra el valor de un campo de un origen de datos como texto.
ButtonField Muestra un botón de comando en el DetailsView control . Esto le permite mostrar una fila con un control de botón personalizado, como un botón Agregar o quitar.
CheckBoxField Muestra una casilla en el DetailsView control . Este tipo de campo de fila se usa normalmente para mostrar campos con un valor booleano.
CommandField Muestra los botones de comandos integrados para realizar operaciones de edición, inserción o eliminación en el DetailsView control.
HyperLinkField Muestra el valor de un campo de un origen de datos como hipervínculo. Este tipo de campo de fila permite enlazar un segundo campo a la dirección URL del hipervínculo.
ImageField Muestra una imagen en el DetailsView control .
TemplateField Muestra el contenido definido por el usuario para una fila en el DetailsView control según una plantilla especificada. Este tipo de campo de fila permite crear un campo de fila personalizado.

De forma predeterminada, la AutoGenerateRows propiedad se establece trueen , que genera automáticamente un objeto de campo de fila enlazado para cada campo de un tipo enlazable en el origen de datos. Los tipos enlazables válidos son String, DateTime, Decimal, Guidy el conjunto de tipos primitivos. A continuación, cada campo se muestra en una fila como texto, en el orden en que cada campo aparece en el origen de datos.

La generación automática de las filas proporciona una manera rápida y sencilla de mostrar todos los campos del registro. Sin embargo, para usar las DetailsView funcionalidades avanzadas del control, debe declarar explícitamente los campos de fila que se incluirán en el DetailsView control. Para declarar los campos de fila, establezca primero la AutoGenerateRows propiedad en false. A continuación, agregue etiquetas de apertura y cierre <Fields> entre las etiquetas de apertura y cierre del DetailsView control. Por último, enumere los campos de fila que desea incluir entre las etiquetas de apertura y cierre <Fields> . Los campos de fila especificados se agregan a la Fields colección en el orden indicado. La Fields colección permite administrar mediante programación los campos de fila del DetailsView control .

Nota

Los campos de fila generados automáticamente no se agregan a la Fields colección.

Nota

Los campos de fila declarados explícitamente se pueden mostrar en combinación con campos de fila generados automáticamente. Cuando se usan ambos, los campos de fila declarados explícitamente se representan primero, seguidos de los campos de fila generados automáticamente.

Enlace a datos

El DetailsView control se puede enlazar a un control de origen de datos (como el SqlDataSource control o ObjectDataSource control) o a cualquier colección de orígenes de datos que implemente la System.Collections.IEnumerable interfaz, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>u otros tipos de colección. Use uno de los métodos siguientes para enlazar el DetailsView control al tipo de origen de datos adecuado:

  • Para enlazar a un control de origen de datos, establezca la DataSourceID propiedad del DetailsView control en el ID valor del control de origen de datos. El DetailsView control se enlaza automáticamente al control de origen de datos especificado. Este es el método preferido para enlazar a datos.

  • Para enlazar a un origen de datos que implementa la System.Collections.IEnumerable interfaz, establezca mediante programación la DataSource propiedad del control en el origen de DetailsView datos y, a continuación, llame al DataBind método .

Para obtener más información sobre el enlace de datos, consulte Enlace a bases de datos.

Seguridad

Este control se puede usar para mostrar la entrada del usuario, lo que podría incluir un script de cliente malintencionado. Compruebe cualquier información que se envíe desde un cliente para el script ejecutable, las instrucciones SQL u otro código antes de mostrarla en la aplicación. ASP.NET proporciona una característica de validación de solicitudes de entrada para bloquear scripts y HTML en la entrada del usuario. Para más información, consulte Información general sobre los ataques mediante scripts. También se proporcionan controles de servidor de validación para evaluar la entrada del usuario. Para obtener más información, vea Validation Server Control Syntax.

Operaciones de datos

El DetailsView control proporciona funcionalidades integradas que permiten al usuario actualizar, eliminar, insertar y paginar mediante elementos del control. Cuando el DetailsView control está enlazado a un control de origen de datos, el DetailsView control puede aprovechar las funcionalidades del control de origen de datos y proporcionar actualización automática, eliminación, inserción y funcionalidad de paginación.

Nota:

El DetailsView control puede proporcionar compatibilidad con las operaciones de actualización, eliminación, inserción y paginación con otros tipos de orígenes de datos; sin embargo, debe proporcionar la implementación de estas operaciones en un controlador de eventos adecuado. Para obtener más información, vea ItemDeleting, ItemInserting y ItemUpdating.

El DetailsView control puede agregar automáticamente un CommandField campo de fila con un botón Editar, Eliminar o Nuevo estableciendo las AutoGenerateEditButtonpropiedades true, AutoGenerateDeleteButtono AutoGenerateInsertButton en , respectivamente. A diferencia del botón Eliminar (que elimina el registro seleccionado inmediatamente), cuando se hace clic en el botón Editar o Nuevo, el DetailsView control entra en modo de edición o inserción, respectivamente. En el modo de edición, el botón Editar se reemplaza por un botón Actualizar y cancelar. Los controles de entrada adecuados para el tipo de datos del campo (como un TextBoxCheckBox control o ) se muestran con el valor de un campo para que el usuario lo modifique. Al hacer clic en el botón Actualizar se actualiza el registro en el origen de datos, mientras que al hacer clic en el botón Cancelar se abandonan los cambios. Del mismo modo, en el modo de inserción, el botón Nuevo se reemplaza por un botón Insertar y cancelar, y se muestran los controles de entrada vacíos para que el usuario escriba los valores del nuevo registro.

Nota:

También puede definir manualmente los botones de comando actualizar, eliminar e insertar en un ButtonFieldcampo de fila , CommandFieldo TemplateField . El DetailsView control reconoce botones con la CommandName propiedad establecida en "Edit", "Update", "Delete", "New", "Insert" o "Cancel"; sin embargo, todavía debe proporcionar la funcionalidad usted mismo. Para obtener más información, vea ItemDeleting, ItemInserting y ItemUpdating.

El DetailsView control proporciona una característica de paginación, que permite al usuario navegar a otros registros del origen de datos. Cuando se habilita, los controles de navegación de página se muestran en una fila de buscapersonas. Para habilitar la paginación, establezca la AllowPaging propiedad trueen . La fila del buscapersonas se puede personalizar mediante las PagerStyle propiedades y PagerSettings .

Personalización de la interfaz de usuario

Puede personalizar la apariencia del DetailsView control estableciendo las propiedades de estilo para diferentes partes del control. En la tabla siguiente se enumeran las propiedades de estilo que puede establecer.

Propiedad Style Descripción
AlternatingRowStyle La configuración de estilo de las filas de datos alternas en el DetailsView control . Cuando se establece esta propiedad, las filas de datos se muestran en bandas, alternando entre la RowStyle configuración y la AlternatingRowStyle configuración.
CommandRowStyle La configuración de estilo de la fila que contiene los botones de comando integrados.
EditRowStyle La configuración de estilo de las filas de datos cuando el DetailsView control está en modo de edición.
EmptyDataRowStyle La configuración de estilo de la fila de datos vacía que se muestra en el DetailsView control cuando el origen de datos no contiene ningún registro.
FooterStyle La configuración de estilo de la fila de pie de página.
HeaderStyle La configuración de estilo de la fila de encabezado.
InsertRowStyle La configuración de estilo de las filas de datos cuando el DetailsView control está en modo de inserción.
PagerStyle La configuración de estilo de la fila del buscapersonas.
RowStyle La configuración de estilo de las filas de datos del DetailsView control . Cuando también se establece la AlternatingRowStyle propiedad , las filas de datos se muestran alternando entre la RowStyle configuración y la AlternatingRowStyle configuración.
FieldHeaderStyle La configuración de estilo de la columna de encabezado.

Eventos

El DetailsView control proporciona varios eventos contra los que puede programar. Esto le permite ejecutar una rutina personalizada cada vez que se produce un evento. En la tabla siguiente se enumeran los eventos admitidos por el DetailsView control . El DetailsView control también hereda estos eventos de sus clases base: DataBinding, DataBound, Disposed, InitLoad, PreRender, y Render.

Evento Descripción
ItemCommand Se desencadena cuando se hace clic en un botón del control DetailsView.
ItemCreated Se produce después de crear todos los DetailsViewRow objetos en el DetailsView control . Este evento se usa a menudo para modificar los valores de un registro antes de que se muestre.
ItemDeleted Se produce cuando se hace clic en un botón Eliminar, pero después de que el DetailsView control elimine el registro del origen de datos. Este evento se usa a menudo para comprobar los resultados de la operación de eliminación.
ItemDeleting Se produce cuando se hace clic en un botón Eliminar, pero antes de que el DetailsView control elimine el registro del origen de datos. Este evento se usa a menudo para cancelar la operación de eliminación.
ItemInserted Se produce cuando se hace clic en un botón Insertar, pero después de que el DetailsView control inserte el registro. Este evento se usa a menudo para comprobar los resultados de la operación de inserción.
ItemInserting Se produce cuando se hace clic en un botón Insertar, pero antes de que el DetailsView control inserte el registro. Este evento se usa a menudo para cancelar la operación de inserción.
ItemUpdated Se produce cuando se hace clic en un botón Actualizar, pero después de que el DetailsView control actualice la fila. Este evento se usa a menudo para comprobar los resultados de la operación de actualización.
ItemUpdating Se produce cuando se hace clic en un botón Actualizar, pero antes de que el DetailsView control actualice el registro. Este evento se usa a menudo para cancelar la operación de actualización.
ModeChanged Se produce después de que el control cambie los DetailsView modos (modo de edición, inserción o de solo lectura). Este evento se usa a menudo para realizar una tarea cuando el control cambia los DetailsView modos.
ModeChanging Se produce antes de que el control cambie los DetailsView modos (modo de edición, inserción o solo lectura). Este evento se suele usar para cancelar un cambio de modo.
PageIndexChanged Se produce cuando se hace clic en uno de los botones de paginación, pero después de que el control DetailsView se ocupe de la operación de paginación. Este evento se usa normalmente cuando es necesario realizar una tarea después de que el usuario navegue a un registro diferente en el control.
PageIndexChanging Se produce cuando se hace clic en uno de los botones de paginación, pero antes de que el control DetailsView se ocupe de la operación de paginación. Este evento se suele usar para cancelar la operación de paginación.

Accesibilidad

Para obtener información sobre cómo configurar este control para que genere marcado que se ajuste a los estándares de accesibilidad, consulte Accesibilidad en Visual Studio y ASP.NET y controles y accesibilidad ASP.NET.

Sintaxis declarativa

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

Constructores

DetailsView()

Inicializa una nueva instancia de la clase DetailsView.

Propiedades

AccessKey

Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web.

(Heredado de WebControl)
Adapter

Obtiene el adaptador específico del explorador para el control.

(Heredado de Control)
AllowPaging

Obtiene o establece un valor que indica si la característica de paginación está habilitada.

AlternatingRowStyle

Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de las filas de datos alternas en un control DetailsView.

AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.

(Heredado de Control)
Attributes

Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control.

(Heredado de WebControl)
AutoGenerateDeleteButton

Obtiene o establece un valor que indica si el control integrado para eliminar el registro actual se muestra en un control DetailsView.

AutoGenerateEditButton

Obtiene o establece un valor que indica si los controles integrados que permiten editar el registro actual se muestran en un control DetailsView.

AutoGenerateInsertButton

Obtiene o establece un valor que indica si los controles integrados que permiten insertar un nuevo registro se muestran en un control DetailsView.

AutoGenerateRows

Obtiene o establece un valor que indica si se generan automáticamente campos de fila para cada campo del origen de datos y se muestran en un control DetailsView.

BackColor

Obtiene o establece el color de fondo del control de servidor web.

(Heredado de WebControl)
BackImageUrl

Obtiene o establece la dirección URL de una imagen que se muestra en segundo plano en el control DetailsView.

BindingContainer

Obtiene el control que contiene el enlace de datos de este control.

(Heredado de Control)
BorderColor

Obtiene o establece el color de borde del control Web.

(Heredado de WebControl)
BorderStyle

Obtiene o establece el estilo del borde del control de servidor web.

(Heredado de WebControl)
BorderWidth

Obtiene o establece el ancho del borde del control de servidor web.

(Heredado de WebControl)
BottomPagerRow

Obtiene un objeto DetailsViewRow que representa la fila de paginación inferior de un control DetailsView.

Caption

Obtiene o establece el texto que se va a representar en un elemento de título HTML de un control DetailsView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.

CaptionAlign

Obtiene o establece la posición horizontal o vertical del elemento de título HTML de un control DetailsView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.

CellPadding

Obtiene o establece la cantidad de espacio entre el contenido de una celda y el borde de la misma.

CellSpacing

Obtiene o establece la cantidad de espacio entre las celdas.

ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.

(Heredado de Control)
ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.

(Heredado de Control)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.

(Heredado de Control)
CommandRowStyle

Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de una fila de comandos de un control DetailsView.

Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.

(Heredado de Control)
Controls

Obtiene una colección de los controles secundarios dentro del control enlazado a datos compuesto.

(Heredado de CompositeDataBoundControl)
ControlStyle

Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
ControlStyleCreated

Obtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
CssClass

Obtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente.

(Heredado de WebControl)
CurrentMode

Obtiene el modo de entrada de datos actual del control DetailsView.

DataItem

Obtiene el elemento de datos enlazado al control DetailsView.

DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.

(Heredado de Control)
DataItemCount

Obtiene el número de elementos del origen de datos subyacente.

DataItemIndex

Obtiene el índice del elemento que se muestra en un control DetailsView procedente del origen de datos subyacente.

DataKey

Obtiene un objeto DataKey que representa la clave principal del registro mostrado.

DataKeyNames

Obtiene o establece una matriz que contiene los nombres de los campos clave del origen de datos.

DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.

(Heredado de Control)
DataMember

Obtiene o establece el nombre de la lista de datos a la que se enlaza el control enlazado a datos, en los casos en que el origen de datos contiene más de una lista distinta de elementos de datos.

(Heredado de DataBoundControl)
DataSource

Obtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos.

(Heredado de BaseDataBoundControl)
DataSourceID

Obtiene o establece el identificador del control desde el que el control enlazado a datos recupera su lista de elementos de datos.

(Heredado de DataBoundControl)
DataSourceObject

Obtiene un objeto que implementa la interfaz IDataSource, que proporciona acceso al contenido de datos del objeto.

(Heredado de DataBoundControl)
DefaultMode

Obtiene o establece el modo de entrada de datos predeterminado del control DetailsView.

DeleteMethod

Obtiene o establece el nombre del método en la página al que se llama cuando el control realiza una operación de eliminación.

DeleteMethod

Obtiene o establece el nombre de método al que se va a llamar para eliminar datos.

(Heredado de CompositeDataBoundControl)
DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.

(Heredado de Control)
EditRowStyle

Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de las filas de datos cuando un control DetailsView está en modo de edición.

EmptyDataRowStyle

Obtiene una referencia al objeto TableItemStyle que le permite establecer el aspecto de la fila de datos vacía mostrada cuando se enlaza el origen de datos a un control DetailsView que no contiene ningún registro.

EmptyDataTemplate

Obtiene o establece el contenido definido por el usuario para la fila de datos vacía que se representa cuando un control DetailsView se enlaza a un origen de datos que no contiene registros.

EmptyDataText

Obtiene o establece el texto que se mostrará en la fila de datos vacía que se representa cuando un control DetailsView se enlaza a un origen de datos que no contiene registros.

Enabled

Obtiene o establece un valor que indica si el control de servidor web está habilitado.

(Heredado de WebControl)
EnableModelValidation

Obtiene o establece un valor que indica si está habilitada la validación del modelo de datos.

EnablePagingCallbacks

Obtiene o establece un valor que indica si las funciones de devolución de llamada del lado cliente se utilizan para las operaciones de paginación del control DetailsView.

EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.

(Heredado de WebControl)
EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.

(Heredado de Control)
Events

Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura.

(Heredado de Control)
FieldHeaderStyle

Obtiene una referencia al objeto TableItemStyle que permite establecer el aspecto de la columna de encabezado en un control DetailsView.

Fields

Obtiene una colección de objetos DataControlField que representan los campos de fila explícitamente declarados en un control DetailsView.

Font

Obtiene las propiedades de fuente asociadas al control de servidor web.

(Heredado de WebControl)
FooterRow

Obtiene un objeto DetailsViewRow que representa la fila de pie de página de un control DetailsView.

FooterStyle

Obtiene una referencia al objeto TableItemStyle que le permite establecer el aspecto de la fila del pie de página en un control DetailsView.

FooterTemplate

Obtiene o establece el contenido definido por el usuario para la fila del pie de página en un control DetailsView.

FooterText

Obtiene o establece el texto que se muestra en la fila del pie de página de un control DetailsView.

ForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web.

(Heredado de WebControl)
GridLines

Obtiene o establece el estilo de línea de cuadrícula de un control DetailsView.

HasAttributes

Obtiene un valor que indica si el control tiene establecido algún atributo.

(Heredado de WebControl)
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.

(Heredado de Control)
HeaderRow

Obtiene un objeto DetailsViewRow que representa la fila de encabezado de un control DetailsView.

HeaderStyle

Obtiene una referencia al objeto TableItemStyle que le permite establecer el aspecto de la fila de encabezado en un control DetailsView.

HeaderTemplate

Obtiene o establece el contenido definido por el usuario para la fila de encabezado en un control DetailsView.

HeaderText

Obtiene o establece el texto que se muestra en la fila de encabezado de un control DetailsView.

Height

Obtiene o establece el alto del control de servidor Web.

(Heredado de WebControl)
HorizontalAlign

Obtiene o establece la alineación horizontal de un control DetailsView en la página.

ID

Obtiene o establece el identificador de programación asignado al control de servidor.

(Heredado de Control)
IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.

(Heredado de Control)
Initialized

Obtiene un valor que indica si el control enlazado a datos está inicializado.

(Heredado de BaseDataBoundControl)
InsertMethod

Obtiene o establece el nombre del método en la página al que se llama cuando el control realiza una operación de inserción.

InsertMethod

Obtiene o establece el nombre de método al que se va a llamar para insertar datos.

(Heredado de CompositeDataBoundControl)
InsertRowStyle

Obtiene una referencia al objeto TableItemStyle que le permite establecer el aspecto de las filas de datos de un control DetailsView cuando un control DetailsView está en modo de inserción.

IsBoundUsingDataSourceID

Obtiene un valor que indica si la propiedad DataSourceID está establecida.

(Heredado de BaseDataBoundControl)
IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.

(Heredado de Control)
IsDataBindingAutomatic

Obtiene un valor que indica si el enlace de datos es automático.

(Heredado de BaseDataBoundControl)
IsEnabled

Obtiene un valor que indica si está habilitado el control.

(Heredado de WebControl)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.

(Heredado de Control)
IsUsingModelBinders

Obtiene un valor que indica si se usa el enlace de modelo.

(Heredado de CompositeDataBoundControl)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.

(Heredado de Control)
ItemType

Obtiene o establece el nombre del tipo de elemento de datos para el enlace de datos fuertemente tipado.

(Heredado de DataBoundControl)
LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.

(Heredado de Control)
NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID.

(Heredado de Control)
Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.

(Heredado de Control)
PageCount

Obtiene el número de registros del origen de datos.

PageIndex

Obtiene o establece el índice del registro mostrado.

PagerSettings

Obtiene una referencia al objeto PagerSettings que le permite establecer las propiedades de los botones de paginación en un control DetailsView.

PagerStyle

Obtiene una referencia al objeto TableItemStyle que le permite establecer el aspecto de la fila de paginación en un control DetailsView.

PagerTemplate

Obtiene o establece el contenido personalizado de la fila de paginación de un control DetailsView.

Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.

(Heredado de Control)
RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.

(Heredado de Control)
RequiresDataBinding

Obtiene o establece un valor que indica si se debe llamar al método DataBind().

(Heredado de BaseDataBoundControl)
Rows

Obtiene una colección de objetos DetailsViewRow que representan las filas de datos de un control DetailsView.

RowsGenerator

Obtiene o establece un objeto que implementa la interfaz IAutoFieldGenerator para llenar automáticamente las filas de la vista.

RowStyle

Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de las filas de datos en un control DetailsView.

SelectArguments

Obtiene un objeto DataSourceSelectArguments que utiliza el control enlazado a datos al recuperar los datos de un control de origen de datos.

(Heredado de DataBoundControl)
SelectedValue

Obtiene el valor clave de los datos del registro actual en un control DetailsView.

SelectMethod

Nombre del método al que se va a llamar para leer datos.

(Heredado de DataBoundControl)
Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.

(Heredado de Control)
SkinID

Obtiene o establece la máscara que se aplica al control.

(Heredado de WebControl)
Style

Obtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web.

(Heredado de WebControl)
SupportsDisabledAttribute

Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.

(Heredado de BaseDataBoundControl)
TabIndex

Obtiene o establece el índice de tabulación del control de servidor web.

(Heredado de WebControl)
TagKey

Obtiene el valor HtmlTextWriterTag del control DetailsView.

TagName

Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.

(Heredado de Control)
ToolTip

Obtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web.

(Heredado de WebControl)
TopPagerRow

Obtiene un objeto DetailsViewRow que representa la fila de paginación superior de un control DetailsView.

UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.

(Heredado de Control)
UpdateMethod

Obtiene o establece el nombre del método en la página al que se llama cuando el control realiza una operación de actualización.

UpdateMethod

Obtiene o establece el nombre de método al que se va a llamar para actualizar datos.

(Heredado de CompositeDataBoundControl)
ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.

(Heredado de Control)
ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.

(Heredado de Control)
Visible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.

(Heredado de Control)
Width

Obtiene o establece el ancho del control de servidor web.

(Heredado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriterTag especificado. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.

(Heredado de Control)
AddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.

(Heredado de Control)
ApplyStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles.

(Heredado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.

(Heredado de Control)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.

(Heredado de Control)
ChangeMode(DetailsViewMode)

Cambia el control DetailsView al modo especificado.

ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.

(Heredado de Control)
ConfirmInitState()

Establece el estado inicializado del control enlazado a datos.

(Heredado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
CreateAutoGeneratedRow(AutoGeneratedFieldProperties)

Crea un objeto AutoGeneratedField que representa un campo de fila generado automáticamente mediante las propiedades de campo especificadas.

CreateAutoGeneratedRows(Object)

Crea un conjunto de campos de fila generados automáticamente para el elemento de datos especificado.

CreateChildControls()

Crea la jerarquía de controles que se utiliza para procesar un control compuesto enlazado a datos basada en los valores que se almacenan en estado de vista.

(Heredado de CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean)

Crea la jerarquía de controles utilizada para representar el control DetailsView.

CreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.

(Heredado de Control)
CreateControlStyle()

Crea un objeto de estilo de tabla predeterminado para el control DetailsView.

CreateDataSourceSelectArguments()

Crea el objeto DataSourceSelectArguments que se pasa al comando de selección.

CreateFieldSet(Object, Boolean)

Crea el conjunto completo de los campos de fila generados automáticamente y los definidos por el usuario que se utilizan para generar la jerarquía de controles.

CreateRow(Int32, DataControlRowType, DataControlRowState)

Crea un objeto DetailsViewRow basándose en el índice del elemento, el tipo de fila y el estado de fila especificados.

CreateTable()

Crea la tabla que contiene el control DetailsView.

DataBind()

Llama al método DataBind() de la clase base.

DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.

(Heredado de Control)
DeleteItem()

Elimina el registro actual del origen de datos.

Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea.

(Heredado de Control)
EnsureDataBound()

Llama al método DataBind() después de comprobar que el control de lista de datos requiere enlace de datos, y que se especifica un control de origen de datos válido.

EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
ExtractRowValues(IOrderedDictionary, Boolean, Boolean)

Recupera los valores de cada campo mostrado y los almacena en el objeto IOrderedDictionary especificado.

FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.

(Heredado de Control)
FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar.

(Heredado de Control)
Focus()

Establece el foco de entrada en un control.

(Heredado de Control)
GetCallbackResult()

Devuelve el resultado de un evento de devolución de llamada que tiene como destino un control.

GetCallbackScript(IButtonControl, String)

Devuelve la cadena de devolución de llamada creada mediante el argumento especificado.

GetData()

Recupera un objeto DataSourceView que el control enlazado a datos usa para llevar a cabo operaciones de datos.

(Heredado de DataBoundControl)
GetDataSource()

Recupera la interfaz IDataSource a la que se asocia el control enlazado a datos, si existe.

(Heredado de DataBoundControl)
GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.

(Heredado de Control)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.

(Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.

(Heredado de Control)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.

(Heredado de Control)
HasControls()

Determina si el control de servidor contiene controles secundarios.

(Heredado de Control)
HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.

(Heredado de Control)
InitializePager(DetailsViewRow, PagedDataSource)

Crea la fila de paginación para el control DetailsView.

InitializeRow(DetailsViewRow, DataControlField)

Inicializa el objeto DetailsViewRow especificado.

InsertItem(Boolean)

Inserta el registro actual en el origen de datos.

IsBindableType(Type)

Determina si el tipo de datos especificado se puede enlazar a un campo del control DetailsView.

IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.

(Heredado de Control)
LoadControlState(Object)

Carga el estado de las propiedades del control DetailsView que deben conservarse, incluso cuando la propiedad EnableViewState se establece en false.

LoadViewState(Object)

Carga el estado de vista guardado previamente del control DetailsView.

MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.

(Heredado de Control)
MarkAsDataBound()

Establece el estado del control en estado de vista como enlazado correctamente a los datos.

(Heredado de DataBoundControl)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MergeStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor Web debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario (UI) de la página.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Genera el evento CreatingModelDataSource.

(Heredado de DataBoundControl)
OnDataBinding(EventArgs)

Genera el evento DataBinding.

(Heredado de Control)
OnDataBound(EventArgs)

Genera el evento DataBound.

(Heredado de BaseDataBoundControl)
OnDataPropertyChanged()

Vuelve a enlazar el control enlazado a datos a sus datos después de un cambio en una de las propiedades de identificación del origen de datos base.

(Heredado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Genera el evento DataSourceViewChanged.

OnInit(EventArgs)

Genera el evento Init.

OnItemCommand(DetailsViewCommandEventArgs)

Genera el evento ItemCommand.

OnItemCreated(EventArgs)

Genera el evento ItemCreated.

OnItemDeleted(DetailsViewDeletedEventArgs)

Genera el evento ItemDeleted.

OnItemDeleting(DetailsViewDeleteEventArgs)

Genera el evento ItemDeleting.

OnItemInserted(DetailsViewInsertedEventArgs)

Genera el evento ItemInserted.

OnItemInserting(DetailsViewInsertEventArgs)

Genera el evento ItemInserting.

OnItemUpdated(DetailsViewUpdatedEventArgs)

Genera el evento ItemUpdated.

OnItemUpdating(DetailsViewUpdateEventArgs)

Genera el evento ItemUpdating.

OnLoad(EventArgs)

Controla el evento Load.

(Heredado de DataBoundControl)
OnModeChanged(EventArgs)

Genera el evento ModeChanged.

OnModeChanging(DetailsViewModeEventArgs)

Genera el evento ModeChanging.

OnPageIndexChanged(EventArgs)

Genera el evento PageIndexChanged.

OnPageIndexChanging(DetailsViewPageEventArgs)

Genera el evento PageIndexChanging.

OnPagePreLoad(Object, EventArgs)

Establece el estado inicializado del control enlazado a datos antes de cargar el control.

OnPreRender(EventArgs)

Genera el evento PreRender.

OnUnload(EventArgs)

Genera el evento Unload.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.

(Heredado de Control)
PerformDataBinding(IEnumerable)

Enlaza el origen de datos especificado al control DetailsView.

PerformSelect()

Recupera los datos del origen de datos asociado.

(Heredado de DataBoundControl)
PrepareControlHierarchy()

Configura la jerarquía de controles del control DetailsView.

RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.

(Heredado de Control)
RaiseCallbackEvent(String)

Crea los argumentos para el controlador de devolución de llamada en el método GetCallbackEventReference.

RaisePostBackEvent(String)

Provoca los eventos correspondientes para el control DetailsView cuando devuelve datos al servidor.

RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.

(Heredado de Control)
Render(HtmlTextWriter)

Muestra el control DetailsView en el cliente utilizando el objeto HtmlTextWriter especificado.

RenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
RenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.

(Heredado de Control)
RenderContents(HtmlTextWriter)

Representa el contenido del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.

(Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.

(Heredado de Control)
RenderEndTag(HtmlTextWriter)

Presenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.

(Heredado de Control)
SaveControlState()

Guarda el estado de las propiedades del control DetailsView que deben conservarse, incluso cuando la propiedad EnableViewState se establece en false.

SaveViewState()

Guarda el estado de vista actual del control DetailsView.

SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.

(Heredado de Control)
SetPageIndex(Int32)

Establece el índice de la página que se muestra actualmente en el control DetailsView.

SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.

(Heredado de Control)
SetTraceData(Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.

(Heredado de Control)
SetTraceData(Object, Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Marca el punto en el que debe comenzar el seguimiento y el almacenamiento de los cambios del estado de vista realizados en el control DetailsView.

UpdateItem(Boolean)

Actualiza el registro actual en el origen de datos.

ValidateDataSource(Object)

Comprueba que el objeto al que se enlaza un control enlazado a datos es compatible.

(Heredado de DataBoundControl)

Eventos

CallingDataMethods

Se produce mientras se llama a los métodos de datos.

(Heredado de DataBoundControl)
CreatingModelDataSource

Se produce mientras se crea el objeto ModelDataSource.

(Heredado de DataBoundControl)
DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.

(Heredado de Control)
DataBound

Se produce después de que el control de servidor se enlaza a un origen de datos.

(Heredado de BaseDataBoundControl)
Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET.

(Heredado de Control)
Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.

(Heredado de Control)
ItemCommand

Se desencadena cuando se hace clic en un botón incluido en un control DetailsView.

ItemCreated

Se desencadena cuando se crea un registro en un control DetailsView.

ItemDeleted

Aparece cuando se hace clic en un botón Suprimir de un control DetailsView, pero después de la operación de eliminación.

ItemDeleting

Aparece cuando se hace clic en un botón Suprimir de un control DetailsView, pero antes de la operación de eliminación.

ItemInserted

Aparece cuando se hace clic en un botón Insertar de un control DetailsView, pero después de la operación de inserción.

ItemInserting

Aparece cuando se hace clic en un botón Insertar de un control DetailsView, pero antes de la operación de inserción.

ItemUpdated

Aparece cuando se hace clic en un botón Actualizar de un control DetailsView, pero después de la operación de actualización.

ItemUpdating

Aparece cuando se hace clic en un botón Actualizar de un control DetailsView, pero antes de la operación de actualización.

Load

Se produce cuando el control de servidor se carga en el objeto Page.

(Heredado de Control)
ModeChanged

Se produce cuando un control DetailsView intenta cambiar entre el modo de edición, el modo de inserción y el modo de sólo lectura, pero después de actualizar la propiedad CurrentMode.

ModeChanging

Se produce cuando un control DetailsView intenta cambiar entre el modo de edición, el modo de inserción y el modo de sólo lectura, pero antes de actualizar la propiedad CurrentMode.

PageIndexChanged

Aparece cuando el valor de la propiedad PageIndex cambia después de una operación de paginación.

PageIndexChanging

Aparece cuando el valor de la propiedad PageIndex cambia antes de una operación de paginación.

PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.

(Heredado de Control)
Unload

Se produce cuando el control de servidor se descarga de la memoria.

(Heredado de Control)

Implementaciones de interfaz explícitas

IAttributeAccessor.GetAttribute(String)

Obtiene un atributo del control Web con el nombre especificado.

(Heredado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Establece un atributo del control Web con el nombre y el valor especificados.

(Heredado de WebControl)
ICallbackContainer.GetCallbackScript(IButtonControl, String)

Crea el script de devolución de llamada para el control DetailsView.

ICallbackEventHandler.GetCallbackResult()

Vea el método GetCallbackResult().

ICallbackEventHandler.RaiseCallbackEvent(String)

Genera el evento de devolución de llamada con los argumentos especificados.

IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obtener una descripción de este miembro, vea GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para obtener una descripción de este miembro, vea UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.

(Heredado de Control)
IDataBoundControl.DataKeyNames

Para obtener una descripción de esta propiedad, vea DataKeyNames.

IDataBoundControl.DataMember

Para obtener una descripción de esta propiedad, vea DataMember.

IDataBoundControl.DataSource

Para obtener una descripción de esta propiedad, vea DataSource.

IDataBoundControl.DataSourceID

Para obtener una descripción de esta propiedad, vea DataSourceID.

IDataBoundControl.DataSourceObject

Para obtener una descripción de esta propiedad, vea DataSourceObject.

IDataBoundItemControl.DataKey

Para obtener una descripción de esta propiedad, vea DataKey.

IDataBoundItemControl.Mode

Para obtener una descripción de esta propiedad, vea Mode.

IDataItemContainer.DataItemIndex

Para obtener una descripción de este miembro, vea DataItemIndex.

IDataItemContainer.DisplayIndex

Para obtener una descripción de este miembro, vea DisplayIndex.

IExpressionsAccessor.Expressions

Para obtener una descripción de este miembro, vea Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.

(Heredado de Control)
IFieldControl.FieldsGenerator

Para obtener una descripción de esta propiedad, vea FieldsGenerator.

IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).

(Heredado de Control)
IPostBackContainer.GetPostBackOptions(IButtonControl)

Para obtener una descripción de este miembro, vea GetPostBackOptions(IButtonControl).

IPostBackEventHandler.RaisePostBackEvent(String)

Para obtener una descripción de este miembro, vea RaisePostBackEvent(String).

Métodos de extensión

EnablePersistedSelection(BaseDataBoundControl)
Obsoletos.

Habilita la selección para que persista en controles de datos que admiten selección y paginación.

FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.

FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.

GetDefaultValues(INamingContainer)

Obtiene la colección de los valores predeterminados para el control de datos especificado.

GetMetaTable(INamingContainer)

Obtiene los metadatos de la tabla para el control de datos especificado.

SetMetaTable(INamingContainer, MetaTable)

Establece los metadatos de la tabla para el control de datos especificado.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina si están disponibles los metadatos de la tabla.

EnableDynamicData(INamingContainer, Type)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.

EnableDynamicData(INamingContainer, Type, Object)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.

Se aplica a

Consulte también