DetailsView Classe

Definição

Exibe os valores de um registro único de uma fonte de dados em uma tabela em que cada linha de dados representa um campo do registro.Displays the values of a single record from a data source in a table, where each data row represents a field of the record. O controle DetailsView permite que você edite, exclua e insira registros.The DetailsView control allows you to edit, delete, and insert records.

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.IDataBoundItemControl, System.Web.UI.WebControls.IFieldControl, System.Web.UI.WebControls.IPostBackContainer
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, IDataBoundItemControl, IDataItemContainer, IFieldControl, IPostBackContainer, IPostBackEventHandler
Herança
Atributos
Implementações

Exemplos

O exemplo de código a seguir demonstra como usar o para usar um controle de DetailsView em combinação com um controle de GridView para um cenário de detalhes mestre simples.The following code example demonstrates how to use to use a DetailsView control in combination with a GridView control for a simple master-detail scenario. Ele exibe os detalhes de um item selecionado no controle de GridView.It displays the details of an item selected in the 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>
      &nbsp;&nbsp;
      <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>
      &nbsp;&nbsp;
      <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>

O exemplo de código a seguir demonstra como usar o controle DetailsView para adicionar, excluir e editar registros.The following code example demonstrates how to use the DetailsView control to add, delete, and edit records.


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

O exemplo de código a seguir demonstra como adicionar campos de linha declarativamente ao controle DetailsView.The following code example demonstrates how to declaratively add row fields to the 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>

Comentários

Neste tópico:In this topic:

IntroduçãoIntroduction

O controle de DetailsView é usado para exibir um único registro de uma fonte de dados em uma tabela, em que cada campo do registro é exibido em uma linha da tabela.The DetailsView control is used to display a single record from a data source in a table, where each field of the record is displayed in a row of the table. Ele pode ser usado em combinação com um controle de GridView para cenários de detalhes mestre.It can be used in combination with a GridView control for master-detail scenarios. O controle DetailsView dá suporte aos seguintes recursos:The DetailsView control supports the following features:

  • Associação a controles de fonte de dados, como SqlDataSource.Binding to data source controls, such as SqlDataSource.

  • Recursos internos de inserção.Built-in inserting capabilities.

  • Recursos internos de atualização e exclusão.Built-in updating and deleting capabilities.

  • Recursos de paginação internos.Built-in paging capabilities.

  • Acesso programático ao modelo de objeto DetailsView para definir propriedades dinamicamente, manipular eventos e assim por diante.Programmatic access to the DetailsView object model to dynamically set properties, handle events, and so on.

  • Aparência personalizável por meio de temas e estilos.Customizable appearance through themes and styles.

Campos de linhaRow Fields

Cada linha de dados no controle de DetailsView é criada pela declaração de um controle de campo.Each data row in the DetailsView control is created by declaring a field control. Tipos de campo de linha diferentes determinam o comportamento das linhas no controle.Different row field types determine the behavior of the rows in the control. Os controles de campo derivam de DataControlField.Field controls derive from DataControlField. A tabela a seguir lista os diferentes tipos de campo de linha que podem ser usados.The following table lists the different row field types that can be used.

Tipo de campo de colunaColumn field type DescriçãoDescription
BoundField Exibe o valor de um campo em uma fonte de dados como texto.Displays the value of a field in a data source as text.
ButtonField Exibe um botão de comando no controle de DetailsView.Displays a command button in the DetailsView control. Isso permite que você exiba uma linha com um controle de botão personalizado, como um botão Adicionar ou remover.This allows you to display a row with a custom button control, such as an Add or a Remove button.
CheckBoxField Exibe uma caixa de seleção no controle de DetailsView.Displays a check box in the DetailsView control. Esse tipo de campo de linha é comumente usado para exibir campos com um valor booliano.This row field type is commonly used to display fields with a Boolean value.
CommandField Exibe botões de comando internos para executar operações de edição, inserção ou exclusão no controle de DetailsView.Displays built-in command buttons to perform edit, insert, or delete operations in the DetailsView control.
HyperLinkField Exibe o valor de um campo em uma fonte de dados como um hiperlink.Displays the value of a field in a data source as a hyperlink. Esse tipo de campo de linha permite que você vincule um segundo campo à URL do hiperlink.This row field type allows you to bind a second field to the hyperlink's URL.
ImageField Exibe uma imagem no controle de DetailsView.Displays an image in the DetailsView control.
TemplateField Exibe o conteúdo definido pelo usuário para uma linha no controle de DetailsView de acordo com um modelo especificado.Displays user-defined content for a row in the DetailsView control according to a specified template. Esse tipo de campo de linha permite que você crie um campo de linha personalizado.This row field type allows you to create a custom row field.

Por padrão, a propriedade AutoGenerateRows é definida como true, o que gera automaticamente um objeto de campo de linha associado para cada campo de um tipo vinculável na fonte de dados.By default, the AutoGenerateRows property is set to true, which automatically generates a bound row field object for each field of a bindable type in the data source. Os tipos vinculáveis válidos são String, DateTime, Decimal, Guide o conjunto de tipos primitivos.Valid bindable types are String, DateTime, Decimal, Guid, and the set of primitive types. Cada campo é exibido em uma linha como texto, na ordem em que cada campo é exibido na fonte de dados.Each field is then displayed in a row as text, in the order in which each field appears in the data source.

A geração automática de linhas fornece uma maneira rápida e fácil de exibir cada campo no registro.Automatically generating the rows provides a quick and easy way to display every field in the record. No entanto, para fazer uso dos recursos avançados do controle de DetailsView, você deve declarar explicitamente os campos de linha a serem incluídos no controle de DetailsView.However, to make use of the DetailsView control's advanced capabilities you must explicitly declare the row fields to include in the DetailsView control. Para declarar os campos de linha, primeiro defina a propriedade AutoGenerateRows como false.To declare the row fields, first set the AutoGenerateRows property to false. Em seguida, adicione marcas de abertura e fechamento <Fields> entre as marcas de abertura e fechamento do controle de DetailsView.Next, add opening and closing <Fields> tags between the opening and closing tags of the DetailsView control. Por fim, liste os campos de linha que você deseja incluir entre as marcas de <Fields> de abertura e fechamento.Finally, list the row fields that you want to include between the opening and closing <Fields> tags. Os campos de linha especificados são adicionados à coleção de Fields na ordem listada.The row fields specified are added to the Fields collection in the order listed. A coleção de Fields permite que você gerencie programaticamente os campos de linha no controle de DetailsView.The Fields collection allows you to programmatically manage the row fields in the DetailsView control.

Observação

Campos de linha gerados automaticamente não são adicionados à coleção de Fields.Automatically generated row fields are not added to the Fields collection.

Observação

Campos de linha declarados explicitamente podem ser exibidos em combinação com campos de linha gerados automaticamente.Explicitly declared row fields can be displayed in combination with automatically generated row fields. Quando ambos são usados, os campos de linha explicitamente declarados são processados primeiro, seguidos pelos campos de linha gerados automaticamente.When both are used, explicitly declared row fields are rendered first, followed by the automatically generated row fields.

Associação a dadosBinding to Data

O controle de DetailsView pode ser associado a um controle de fonte de dados (como o controle de SqlDataSource ou o controle de ObjectDataSource) ou a qualquer coleção de fontes de dados que implemente a interface System.Collections.IEnumerable, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou outros tipos de coleção.The DetailsView control can be bound to a data source control (such as the SqlDataSource control or ObjectDataSource control) or to any data source collection that implements the System.Collections.IEnumerable interface, such as System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, or other collection types. Use um dos métodos a seguir para associar o controle de DetailsView ao tipo de fonte de dados apropriado:Use one of the following methods to bind the DetailsView control to the appropriate data source type:

  • Para associar a um controle da fonte de dados, defina a propriedade DataSourceID do controle DetailsView como o valor ID do controle da fonte de dados.To bind to a data source control, set the DataSourceID property of the DetailsView control to the ID value of the data source control. O controle de DetailsView é automaticamente associado ao controle de fonte de dados especificado.The DetailsView control automatically binds to the specified data source control. Esse é o método preferencial para associar dados.This is the preferred method to bind to data.

  • Para associar a uma fonte de dados que implementa a interface System.Collections.IEnumerable, defina programaticamente a propriedade DataSource do controle de DetailsView com a fonte de dados e, em seguida, chame o método DataBind.To bind to a data source that implements the System.Collections.IEnumerable interface, programmatically set the DataSource property of the DetailsView control to the data source and then call the DataBind method.

Para obter mais informações sobre a vinculação de dados, consulte associando a bancos dedado.For more information on data binding, see Binding to Databases.

SegurançaSecurity

Esse controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado.This control can be used to display user input, which might include malicious client script. Verifique todas as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo em seu aplicativo.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. O ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear o script e o HTML na entrada do usuário.ASP.NET provides an input request validation feature to block script and HTML in user input. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview. Os controles de servidor de validação também são fornecidos para avaliar a entrada do usuário.Validation server controls are also provided to assess user input. Para obter mais informações, consulte sintaxe de controle de servidor de validação.For more information, see Validation Server Control Syntax.

Operações de dadosData Operations

O controle de DetailsView fornece recursos internos que permitem ao usuário atualizar, excluir, inserir e paginar itens no controle.The DetailsView control provides built-in capabilities that allow the user to update, delete, insert, and page through items in the control. Quando o controle de DetailsView está associado a um controle da fonte de dados, o controle de DetailsView pode tirar proveito dos recursos do controle da fonte de dados e fornecer a funcionalidade de atualização, exclusão, inserção e paginação automática.When the DetailsView control is bound to a data source control, the DetailsView control can take advantage of the data source control's capabilities and provide automatic updating, deleting, inserting, and paging functionality.

Observação

O controle de DetailsView pode fornecer suporte para operações de atualização, exclusão, inserção e paginação com outros tipos de fontes de dados; no entanto, você deve fornecer a implementação para essas operações em um manipulador de eventos apropriado.The DetailsView control can provide support for update, delete, insert, and paging operations with other types of data sources; however, you must provide the implementation for these operations in an appropriate event handler. Para obter mais informações, consulte ItemDeleting, ItemInserting e ItemUpdating.For more information, see ItemDeleting, ItemInserting, and ItemUpdating.

O controle de DetailsView pode adicionar automaticamente um campo de linha de CommandField com um botão Editar, excluir ou novo definindo as propriedades AutoGenerateEditButton, AutoGenerateDeleteButtonou AutoGenerateInsertButton como true, respectivamente.The DetailsView control can automatically add a CommandField row field with an Edit, Delete, or New button by setting the AutoGenerateEditButton, AutoGenerateDeleteButton, or AutoGenerateInsertButton properties to true, respectively. Ao contrário do botão de exclusão (que exclui o registro selecionado imediatamente), quando o botão Editar ou novo é clicado, o controle de DetailsView entra no modo de edição ou inserção, respectivamente.Unlike the Delete button (which deletes the selected record immediately), when the Edit or New button is clicked, the DetailsView control goes into edit or insert mode, respectively. No modo de edição, o botão Editar é substituído por uma atualização e um botão Cancelar.In edit mode, the Edit button is replaced with an Update and a Cancel button. Os controles de entrada apropriados para o tipo de dados do campo (como um TextBox ou um controle de CheckBox) são exibidos com o valor de um campo para que o usuário modifique.Input controls that are appropriate for the field's data type (such as a TextBox or a CheckBox control) are displayed with a field's value for the user to modify. Clicar no botão atualizar atualiza o registro na fonte de dados, enquanto clicar no botão Cancelar abandona as alterações.Clicking the Update button updates the record in the data source, while clicking the Cancel button abandons any changes. Da mesma forma, no modo de inserção, o novo botão é substituído por um botão de inserção e cancelamento, e controles de entrada vazios são exibidos para que o usuário insira os valores para o novo registro.Likewise, in insert mode, the New button is replaced with an Insert and a Cancel button, and empty input controls are displayed for the user to enter the values for the new record.

Observação

Você também pode definir manualmente os botões de comando Update, DELETE e Insert em um campo de linha ButtonField, CommandFieldou TemplateField.You can also manually define the update, delete, and insert command buttons in a ButtonField, CommandField, or TemplateField row field. O controle de DetailsView reconhece botões com a propriedade CommandName definida como "Editar", "atualizar", "excluir", "novo", "Inserir" ou "Cancelar"; no entanto, você ainda deve fornecer a funcionalidade por conta própria.The DetailsView control recognizes buttons with the CommandName property set to "Edit", "Update", "Delete", "New", "Insert", or "Cancel"; however, you still must provide the functionality yourself. Para obter mais informações, consulte ItemDeleting, ItemInserting e ItemUpdating.For more information, see ItemDeleting, ItemInserting, and ItemUpdating.

O controle DetailsView fornece um recurso de paginação, que permite ao usuário navegar para outros registros na fonte de dados.The DetailsView control provides a paging feature, which allows the user to navigate to other records in the data source. Quando habilitado, os controles de navegação de página são exibidos em uma linha de pager.When enabled, page navigation controls are displayed in a pager row. Para habilitar a paginação, defina a propriedade AllowPaging como true.To enable paging, set the AllowPaging property to true. A linha do pager pode ser personalizada usando as propriedades PagerStyle e PagerSettings.The pager row can be customized using the PagerStyle and PagerSettings properties.

Personalizando a interface do usuárioCustomizing the User Interface

Você pode personalizar a aparência do controle de DetailsView definindo as propriedades de estilo para diferentes partes do controle.You can customize the appearance of the DetailsView control by setting the style properties for different parts of the control. A tabela a seguir lista as propriedades de estilo que você pode definir.The following table lists the style properties that you can set.

Propriedade de estiloStyle property DescriçãoDescription
AlternatingRowStyle As configurações de estilo para as linhas de dados alternadas no controle de DetailsView.The style settings for the alternating data rows in the DetailsView control. Quando essa propriedade é definida, as linhas de dados são exibidas em faixas, alternando entre as configurações de RowStyle e as configurações de AlternatingRowStyle.When this property is set, the data rows are displayed in bands, alternating between the RowStyle settings and the AlternatingRowStyle settings.
CommandRowStyle As configurações de estilo da linha que contém os botões de comando internos.The style settings for the row that contains the built-in command buttons.
EditRowStyle As configurações de estilo para as linhas de dados quando o controle de DetailsView está no modo de edição.The style settings for the data rows when the DetailsView control is in edit mode.
EmptyDataRowStyle As configurações de estilo para a linha de dados vazia que são exibidas no controle de DetailsView quando a fonte de dados não contém registros.The style settings for the empty data row that are displayed in the DetailsView control when the data source does not contain any records.
FooterStyle As configurações de estilo da linha de rodapé.The style settings for the footer row.
HeaderStyle As configurações de estilo da linha de cabeçalho.The style settings for the header row.
InsertRowStyle As configurações de estilo para as linhas de dados quando o controle de DetailsView está no modo de inserção.The style settings for the data rows when the DetailsView control is in insert mode.
PagerStyle As configurações de estilo da linha do pager.The style settings for the pager row.
RowStyle As configurações de estilo das linhas de dados no controle de DetailsView.The style settings for the data rows in the DetailsView control. Quando a propriedade AlternatingRowStyle também é definida, as linhas de dados são exibidas alternando entre as configurações de RowStyle e as configurações de AlternatingRowStyle.When the AlternatingRowStyle property is also set, the data rows are displayed alternating between the RowStyle settings and the AlternatingRowStyle settings.
FieldHeaderStyle As configurações de estilo da coluna de cabeçalho.The style settings for the header column.

EventosEvents

O controle de DetailsView fornece vários eventos com os quais você pode programar.The DetailsView control provides several events that you can program against. Isso permite que você execute uma rotina personalizada sempre que um evento ocorrer.This allows you to run a custom routine whenever an event occurs. A tabela a seguir lista os eventos com suporte pelo controle de DetailsView.The following table lists the events supported by the DetailsView control. O controle de DetailsView também herda esses eventos de suas classes base: DataBinding, DataBound, Disposed, Init, Load, PreRendere Render.The DetailsView control also inherits these events from its base classes: DataBinding, DataBound, Disposed, Init, Load, PreRender, and Render.

{1>Evento<1}Event DescriçãoDescription
ItemCommand Ocorre quando um usuário clica em um botão no controle DetailsView.Occurs when a button is clicked in the DetailsView control.
ItemCreated Ocorre depois que todos os objetos de DetailsViewRow são criados no controle de DetailsView.Occurs after all DetailsViewRow objects are created in the DetailsView control. Esse evento é geralmente usado para modificar os valores de um registro antes que ele seja exibido.This event is often used to modify the values of a record before it is displayed.
ItemDeleted Ocorre quando um botão de exclusão é clicado, mas depois que o controle de DetailsView exclui o registro da fonte de dados.Occurs when a Delete button is clicked, but after the DetailsView control deletes the record from the data source. Esse evento é geralmente usado para verificar os resultados da operação de exclusão.This event is often used to check the results of the delete operation.
ItemDeleting Ocorre quando um botão de exclusão é clicado, mas antes de o controle de DetailsView excluir o registro da fonte de dados.Occurs when a Delete button is clicked, but before the DetailsView control deletes the record from the data source. Esse evento é geralmente usado para cancelar a operação de exclusão.This event is often used to cancel the delete operation.
ItemInserted Ocorre quando um botão de inserção é clicado, mas depois que o controle de DetailsView insere o registro.Occurs when an Insert button is clicked, but after the DetailsView control inserts the record. Esse evento é geralmente usado para verificar os resultados da operação de inserção.This event is often used to check the results of the insert operation.
ItemInserting Ocorre quando um botão de inserção é clicado, mas antes de o controle de DetailsView inserir o registro.Occurs when an Insert button is clicked, but before the DetailsView control inserts the record. Esse evento é geralmente usado para cancelar a operação de inserção.This event is often used to cancel the insert operation.
ItemUpdated Ocorre quando um botão de atualização é clicado, mas depois que o controle de DetailsView atualiza a linha.Occurs when an Update button is clicked, but after the DetailsView control updates the row. Esse evento é geralmente usado para verificar os resultados da operação de atualização.This event is often used to check the results of the update operation.
ItemUpdating Ocorre quando um botão de atualização é clicado, mas antes de o controle de DetailsView atualizar o registro.Occurs when an Update button is clicked, but before the DetailsView control updates the record. Esse evento é geralmente usado para cancelar a operação de atualização.This event is often used to cancel the update operation.
ModeChanged Ocorre depois que o controle de DetailsView altera os modos (modo de edição, inserção ou somente leitura).Occurs after the DetailsView control changes modes (edit, insert, or read-only mode). Esse evento é geralmente usado para executar uma tarefa quando o controle de DetailsView altera os modos.This event is often used to perform a task when the DetailsView control changes modes.
ModeChanging Ocorre antes que o controle de DetailsView altere os modos (modo de edição, inserção ou somente leitura).Occurs before the DetailsView control changes modes (edit, insert, or read-only mode). Esse evento é geralmente usado para cancelar uma alteração no modo.This event is often used to cancel a mode change.
PageIndexChanged Ocorre quando um dos botões de paginação é acionado, mas após o controle DetailsView manipular a operação de paginação.Occurs when one of the pager buttons is clicked, but after the DetailsView control handles the paging operation. Esse evento é normalmente usado quando você precisa executar uma tarefa depois que o usuário navega para um registro diferente no controle.This event is commonly used when you need to perform a task after the user navigates to a different record in the control.
PageIndexChanging Ocorre quando um dos botões de paginação é acionado, mas antes de o controle DetailsView manipular a operação de paginação.Occurs when one of the pager buttons is clicked, but before the DetailsView control handles the paging operation. Esse evento é geralmente usado para cancelar a operação de paginação.This event is often used to cancel the paging operation.

AcessibilidadeAccessibility

Para obter informações sobre como configurar esse controle para que ele gere marcação que esteja de acordo com os padrões de acessibilidade, consulte acessibilidade no Visual Studio e controles e acessibilidadeASP.net e ASP.net.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Sintaxe declarativaDeclarative Syntax

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

Construtores

DetailsView()

Inicializa uma nova instância da classe DetailsView.Initializes a new instance of the DetailsView class.

Propriedades

AccessKey

Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control.

(Herdado de Control)
AllowPaging

Obtém ou define um valor que indica se o recurso de paginação está habilitado.Gets or sets a value indicating whether the paging feature is enabled.

AlternatingRowStyle

Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência das linhas de dados alternadas em um controle DetailsView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the alternating data rows in a DetailsView control.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Herdado de WebControl)
AutoGenerateDeleteButton

Obtém ou define um valor que indica se o controle interno para excluir o registro atual é exibido em um controle DetailsView.Gets or sets a value indicating whether the built-in control to delete the current record is displayed in a DetailsView control.

AutoGenerateEditButton

Obtém ou define um valor que indica se os controles internos para editar o registro atual são exibidos em um controle DetailsView.Gets or sets a value indicating whether the built-in controls to edit the current record are displayed in a DetailsView control.

AutoGenerateInsertButton

Obtém ou define um valor que indica se os controles internos para inserir um novo registro são exibidos em um controle DetailsView.Gets or sets a value indicating whether the built-in controls to insert a new record are displayed in a DetailsView control.

AutoGenerateRows

Obtém ou define um valor que indica se campos de linha para cada campo na fonte de dados são gerados e exibidos automaticamente em um controle DetailsView.Gets or sets a value indicating whether row fields for each field in the data source are automatically generated and displayed in a DetailsView control.

BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.Gets or sets the background color of the Web server control.

(Herdado de WebControl)
BackImageUrl

Obtém ou define a URL para uma imagem a ser exibida na tela de fundo de um controle DetailsView.Gets or sets the URL to an image to display in the background of a DetailsView control.

BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.Gets or sets the border color of the Web control.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controle de servidor Web.Gets or sets the border style of the Web server control.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle de servidor Web.Gets or sets the border width of the Web server control.

(Herdado de WebControl)
BottomPagerRow

Obtém um objeto DetailsViewRow que representa a linha de paginação inferior em um controle DetailsView.Gets a DetailsViewRow object that represents the bottom pager row in a DetailsView control.

Caption

Obtém ou define o texto a ser renderizado em um elemento de legenda HTML em um controle DetailsView.Gets or sets the text to render in an HTML caption element in a DetailsView control. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa.This property is provided to make the control more accessible to users of assistive technology devices.

CaptionAlign

Obtém ou define a posição horizontal ou vertical de um elemento de legenda HTML em um controle DetailsView.Gets or sets the horizontal or vertical position of the HTML caption element in a DetailsView control. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa.This property is provided to make the control more accessible to users of assistive technology devices.

CellPadding

Obtém ou define a quantidade de espaço entre o conteúdo e a borda de uma célula.Gets or sets the amount of space between the contents of a cell and the cell's border.

CellSpacing

Obtém ou define a quantidade de espaço entre células.Gets or sets the amount of space between cells.

ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property.

(Herdado de Control)
CommandRowStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência de uma linha de comando em um controle DetailsView.Gets a reference to the TableItemStyle object that allows you to set the appearance of a command row in a DetailsView control.

Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request.

(Herdado de Control)
Controls

Obtém uma coleção dos controles filho no controle com limite de dados de composição.Gets a collection of the child controls within the composite data-bound control.

(Herdado de CompositeDataBoundControl)
ControlStyle

Obtém o estilo de um controle de servidor Web.Gets the style of the Web server control. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is primarily used by control developers.

(Herdado de WebControl)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Herdado de WebControl)
CurrentMode

Obtém o modo de entrada de dados atual do controle DetailsView.Gets the current data-entry mode of the DetailsView control.

DataItem

Obtém o item de dados associado ao controle DetailsView.Gets the data item bound to the DetailsView control.

DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Herdado de Control)
DataItemCount

Obtém o número de itens na fonte de dados subjacente.Gets the number of items in the underlying data source.

DataItemIndex

Obtém o índice baseado em zero do item sendo exibido em um controle DetailsView da fonte de dados subjacente.Gets the index of the item being displayed in a DetailsView control from the underlying data source.

DataKey

Obtém um objeto DataKey que representa a chave primária do registro exibido.Gets a DataKey object that represents the primary key of the displayed record.

DataKeyNames

Obtém ou define uma matriz que contém os nomes dos campos de chave da fonte de dados.Gets or sets an array that contains the names of the key fields for the data source.

DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Herdado de Control)
DataMember

Obtém ou define o nome da lista de dados ao qual o controle com limite de dados está associado, nos casos em que a fonte de dados contém mais de uma lista distinta de itens de dados.Gets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items.

(Herdado de DataBoundControl)
DataSource

Obtém ou define o objeto do qual o controle com limite de dados recupera sua lista de itens de dados.Gets or sets the object from which the data-bound control retrieves its list of data items.

(Herdado de BaseDataBoundControl)
DataSourceID

Obtém ou define a ID do controle do qual o controle associado a dados recupera sua lista de itens de dados.Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Herdado de DataBoundControl)
DataSourceObject

Obtém um objeto que implementa a interface IDataSource, que fornece acesso ao conteúdo de dados do objeto.Gets an object that implements the IDataSource interface, which provides access to the object's data content.

(Herdado de DataBoundControl)
DefaultMode

Obtém ou define o modo de entrada de dados padrão do controle DetailsView.Get or sets the default data-entry mode of the DetailsView control.

DeleteMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de exclusão.Gets or sets the name of the method on the page that is called when the control performs a delete operation.

DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface.

(Herdado de Control)
EditRowStyle

Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência das linhas de dados quando um controle DetailsView está em modo de edição.Gets a reference to the TableItemStyle object that allows you to set the appearance of the data rows when a DetailsView control is in edit mode.

EmptyDataRowStyle

Obtém uma referência ao objeto TableItemStyle que permite que você defina a aparência da linha de dados vazia exibida quando a fonte de dados associada a um controle DetailsView não contém nenhum registro.Gets a reference to the TableItemStyle object that allows you to set the appearance of the empty data row displayed when the data source bound to a DetailsView control does not contain any records.

EmptyDataTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de dados vazia renderizada quando um controle DetailsView é associado a uma fonte de dados que não contém registros.Gets or sets the user-defined content for the empty data row rendered when a DetailsView control is bound to a data source that does not contain any records.

EmptyDataText

Obtém ou define o texto a ser exibido na linha de dados vazia renderizada quando um controle DetailsView é associado a uma fonte de dados que não contém registros.Gets or sets the text to display in the empty data row rendered when a DetailsView control is bound to a data source that does not contain any records.

Enabled

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.Gets or sets a value indicating whether the Web server control is enabled.

(Herdado de WebControl)
EnableModelValidation

Obtém ou define um valor que indica se a validação de modelo de dados está habilitada.Gets or sets a value that indicates whether data-model validation is enabled.

EnablePagingCallbacks

Obtém ou define um valor que indica se funções de retorno de chamada do lado do cliente usadas para as operações de paginação no controle DetailsView.Gets or sets a value indicating whether client-side callback functions are used for paging operations in the DetailsView control.

EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.Gets or sets a value indicating whether themes apply to this control.

(Herdado de WebControl)
EnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Herdado de Control)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Essa propriedade é somente leitura.This property is read-only.

(Herdado de Control)
FieldHeaderStyle

Obtém uma referência ao objeto TableItemStyle que permite a você definir a aparência da coluna de cabeçalho em um controle DetailsView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the header column in a DetailsView control.

Fields

Obtém uma coleção de objetos DataControlField que representam os campos de linha declarados especificamente em um controle DetailsView.Gets a collection of DataControlField objects that represent the explicitly declared row fields in a DetailsView control.

Font

Obtém as propriedades de fonte associadas ao controle do servidor Web.Gets the font properties associated with the Web server control.

(Herdado de WebControl)
FooterRow

Obtém um objeto DetailsViewRow que representa a linha de rodapé em um controle DetailsView.Gets a DetailsViewRow object that represents the footer row in a DetailsView control.

FooterStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de rodapé em um controle DetailsView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the footer row in a DetailsView control.

FooterTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de rodapé em um controle DetailsView.Gets or sets the user-defined content for the footer row in a DetailsView control.

FooterText

Obtém ou define o texto a ser exibido na linha de rodapé de um controle DetailsView.Gets or sets the text to display in the footer row of a DetailsView control.

ForeColor

Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Herdado de WebControl)
GridLines

Obtém ou define o estilo das linhas de grade para um controle DetailsView.Gets or sets the gridline style for a DetailsView control.

HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.Gets a value indicating whether the control has attributes set.

(Herdado de WebControl)
HasChildViewState

Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Herdado de Control)
HeaderRow

Obtém um objeto DetailsViewRow que representa a linha de cabeçalho em um controle DetailsView.Gets a DetailsViewRow object that represents the header row in a DetailsView control.

HeaderStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de cabeçalho em um controle DetailsView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the header row in a DetailsView control.

HeaderTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de cabeçalho em um controle DetailsView.Gets or sets the user-defined content for the header row in a DetailsView control.

HeaderText

Obtém ou define o texto a ser exibido na linha de cabeçalho de um controle DetailsView.Gets or sets the text to display in the header row of a DetailsView control.

Height

Obtém ou define a altura do controle do servidor Web.Gets or sets the height of the Web server control.

(Herdado de WebControl)
HorizontalAlign

Obtém ou define o alinhamento horizontal de um controle DetailsView na página.Gets or sets the horizontal alignment of a DetailsView control on the page.

ID

Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers.

(Herdado de Control)
Initialized

Obtém um valor que indica se o controle associado a dados foi inicializado.Gets a value indicating whether the data-bound control has been initialized.

(Herdado de BaseDataBoundControl)
InsertMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de inserção.Gets or sets the name of the method on the page that is called when the control performs an insert operation.

InsertRowStyle

Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência das linhas de dados em um controle DetailsView quando o controle DetailsView está em modo de inserção.Gets a reference to the TableItemStyle object that allows you to set the appearance of the data rows in a DetailsView control when the DetailsView control is in insert mode.

IsBoundUsingDataSourceID

Obtém um valor que indica se a propriedade DataSourceID foi definida.Gets a value indicating whether the DataSourceID property is set.

(Herdado de BaseDataBoundControl)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state.

(Herdado de Control)
IsDataBindingAutomatic

Obtém um valor que indica se a associação de dados é automática.Gets a value that indicates whether data binding is automatic.

(Herdado de BaseDataBoundControl)
IsEnabled

Obtém um valor que indica se o controle está habilitado.Gets a value indicating whether the control is enabled.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state.

(Herdado de Control)
IsUsingModelBinders

Obtém um valor que indica se o model binding está em uso.Gets a value that indicates whether model binding is in use.

(Herdado de CompositeDataBoundControl)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control.

(Herdado de Control)
ItemType

Obtém ou define o nome do tipo de item de dados para vinculação de dados com rigidez de tipos.Gets or sets the name of the data item type for strongly typed data binding.

(Herdado de DataBoundControl)
LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Herdado de Control)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control.

(Herdado de Control)
PageCount

Obtém o número de registros na fonte de dados.Gets the number of records in the data source.

PageIndex

Obtém ou define o índice do registro exibido.Gets or sets the index of the displayed record.

PagerSettings

Obtém uma referência ao objeto PagerSettings que permite definir as propriedades dos botões de paginação em um controle DetailsView.Gets a reference to the PagerSettings object that allows you to set the properties of the pager buttons in a DetailsView control.

PagerStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de paginação em um controle DetailsView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the pager row in a DetailsView control.

PagerTemplate

Obtém ou define o conteúdo personalizado para a linha do pager em um controle DetailsView.Gets or sets the custom content for the pager row in a DetailsView control.

Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy.

(Herdado de Control)
RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Herdado de Control)
RequiresDataBinding

Obtém ou define um valor que indica se o método DataBind() deve ser cancelado.Gets or sets a value indicating whether the DataBind() method should be called.

(Herdado de BaseDataBoundControl)
Rows

Obtém uma coleção de objetos DetailsViewRow que representam as linhas de dados em um controle DetailsView.Gets a collection of DetailsViewRow objects that represent the data rows in a DetailsView control.

RowsGenerator

Obtém ou define um objeto que implementa a interface IAutoFieldGenerator para popular automaticamente as linhas na exibição.Gets or sets an object that implements the IAutoFieldGenerator interface in order to automatically populate rows in the view.

RowStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência das linhas de dados em um controle DetailsView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the data rows in a DetailsView control.

SelectArguments

Obtém um objeto DataSourceSelectArguments que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados.Gets a DataSourceSelectArguments object that the data-bound control uses when retrieving data from a data source control.

(Herdado de DataBoundControl)
SelectedValue

Obtém o valor da chave de dados do registro atual em um controle DetailsView.Gets the data key value of the current record in a DetailsView control.

SelectMethod

O nome do método a ser chamado para ler os dados.The name of the method to call in order to read data.

(Herdado de DataBoundControl)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.Gets or sets the skin to apply to the control.

(Herdado de WebControl)
Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Herdado de BaseDataBoundControl)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.Gets or sets the tab index of the Web server control.

(Herdado de WebControl)
TagKey

Obtém o valor HtmlTextWriterTag do controle DetailsView.Gets the HtmlTextWriterTag value for the DetailsView control.

TagName

Obtém o nome da marca de controle.Gets the name of the control tag. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Herdado de Control)
ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Herdado de WebControl)
TopPagerRow

Obtém um objeto DetailsViewRow que representa a linha superior do pager em um controle DetailsView.Gets a DetailsViewRow object that represents the top pager row in a DetailsView control.

UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Herdado de Control)
UpdateMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de atualização.Gets or sets the name of the method on the page that is called when the control performs an update operation.

ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Herdado de Control)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Herdado de Control)
Width

Obtém ou define a largura do controle de servidor Web.Gets or sets the width of the Web server control.

(Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Herdado de Control)
ApplyStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controles.This method is primarily used by control developers.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties defined in the page style sheet to the control.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Herdado de Control)
ChangeMode(DetailsViewMode)

Muda o controle de DetailsView para o modo especificado.Switches the DetailsView control to the specified mode.

ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.Sets the cached ClientID value to null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Herdado de Control)
ConfirmInitState()

Define o estado inicializado do controle associado a dados.Sets the initialized state of the data-bound control.

(Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
CreateAutoGeneratedRow(AutoGeneratedFieldProperties)

Cria um objeto AutoGeneratedField que representa um campo de linha gerado automaticamente usando as propriedades de campo especificadas.Creates an AutoGeneratedField object that represents an automatically generated row field using the specified field properties.

CreateAutoGeneratedRows(Object)

Cria um conjunto de campos de linha gerados automaticamente para o item de dados especificado.Creates a set of automatically generated row fields for the specified data item.

CreateChildControls()

Cria uma hierarquia de controle usada para renderizar um controle de composição associado a dados com base nos valores armazenados no estado de exibição.Creates the control hierarchy that is used to render a composite data-bound control based on the values that are stored in view state.

(Herdado de CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean)

Cria a hierarquia de controle usada para renderizar o controle DetailsView.Creates the control hierarchy used to render the DetailsView control.

CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Herdado de Control)
CreateControlStyle()

Cria um objeto de estilo de tabela padrão para o controle DetailsView.Creates a default table style object for the DetailsView control.

CreateDataSourceSelectArguments()

Cria o objeto DataSourceSelectArguments que é passado para o comando Select.Creates the DataSourceSelectArguments object that gets passed to the Select command.

CreateFieldSet(Object, Boolean)

Cria o conjunto completo de campos de linha automaticamente gerados e definidos pelo usuário usados para gerar a hierarquia de controle.Creates the complete set of automatically generated and user-defined row fields used to generate the control hierarchy.

CreateRow(Int32, DataControlRowType, DataControlRowState)

Cria um objeto DetailsViewRow usando o índice do item, o tipo de linha e o estado de linha especificados.Creates a DetailsViewRow object using the specified item index, row type, and row state.

CreateTable()

Cria a tabela recipiente para o controle DetailsView.Creates the containing table for the DetailsView control.

DataBind()

Chama o método DataBind() da classe base.Calls the DataBind() method of the base class.

DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls.

(Herdado de Control)
DeleteItem()

Exclui o registro atual da fonte de dados.Deletes the current record from the data source.

Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls.

(Herdado de Control)
EnsureDataBound()

Chama o método DataBind() após verificar se o controle de listagem de dados requer uma associação de dados e se um controle de fonte de dados válido foi especificado.Calls the DataBind() method after verifying that the data listing control requires data binding and that a valid data source control is specified.

EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

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

Recupera os valores de cada campo exibido e armazena-os no objeto IOrderedDictionary especificado.Retrieves the values of each field displayed and stores them in the specified IOrderedDictionary object.

FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.Searches the current naming container for a server control with the specified id parameter.

(Herdado de Control)
FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Você não deve substituir esta versão do método FindControl.You should not override this version of the FindControl method.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.Sets input focus to a control.

(Herdado de Control)
GetCallbackResult()

Retorna o resultado de um evento de retorno de chamada direcionado a um controle.Returns the result of a callback event that targets a control.

GetCallbackScript(IButtonControl, String)

Retorna a cadeia de caracteres de retorno de chamada criada usando o argumento especificado.Returns the callback string created using the specified argument.

GetData()

Recupera um objeto DataSourceView que o controle com associação de dados usa para executar operações de dados.Retrieves a DataSourceView object that the data-bound control uses to perform data operations.

(Herdado de DataBoundControl)
GetDataSource()

Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver.Retrieves the IDataSource interface that the data-bound control is associated with, if any.

(Herdado de DataBoundControl)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.Gets design-time data for a control.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls.

(Herdado de Control)
InitializePager(DetailsViewRow, PagedDataSource)

Cria a linha de paginação para o controle DetailsView.Creates the pager row for the DetailsView control.

InitializeRow(DetailsViewRow, DataControlField)

Inicializa o objeto DetailsViewRow especificado.Initializes the specified DetailsViewRow object.

InsertItem(Boolean)

Insere o registro atual na fonte de dados.Inserts the current record in the data source.

IsBindableType(Type)

Determina se o tipo de dados especificado pode estar associado a um campo no controle DetailsView.Determines whether the specified data type can be bound to a field in the DetailsView control.

IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content.

(Herdado de Control)
LoadControlState(Object)

Carrega as informações de estado das propriedades no controle DetailsView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como false.Loads the state of the properties in the DetailsView control that need to be persisted, even when the EnableViewState property is set to false.

LoadViewState(Object)

Carrega o estado de exibição salvo anteriormente do controle DetailsView.Loads the previously saved view state of the DetailsView control.

MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Herdado de Control)
MarkAsDataBound()

Define o estado do controle em estado de exibição como associado com êxito aos dados.Sets the state of the control in view state as successfully bound to data.

(Herdado de DataBoundControl)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MergeStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se o evento do controle de servidor Web é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página.Determines whether the event for the Web server control is passed up the page's user interface (UI) server control hierarchy.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Gera o CreatingModelDataSource evento.Raises the CreatingModelDataSource event.

(Herdado de DataBoundControl)
OnDataBinding(EventArgs)

Gera o evento DataBinding.Raises the DataBinding event.

(Herdado de Control)
OnDataBound(EventArgs)

Gera o DataBound evento.Raises the DataBound event.

(Herdado de BaseDataBoundControl)
OnDataPropertyChanged()

Associa novamente o controle associado a dados a seus dados após a alteração de uma das propriedades de identificação da fonte de dados base.Rebinds the data-bound control to its data after one of the base data source identification properties changes.

(Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Gera o DataSourceViewChanged evento.Raises the DataSourceViewChanged event.

OnInit(EventArgs)

Gera o Init evento.Raises the Init event.

OnItemCommand(DetailsViewCommandEventArgs)

Gera o ItemCommand evento.Raises the ItemCommand event.

OnItemCreated(EventArgs)

Gera o ItemCreated evento.Raises the ItemCreated event.

OnItemDeleted(DetailsViewDeletedEventArgs)

Gera o ItemDeleted evento.Raises the ItemDeleted event.

OnItemDeleting(DetailsViewDeleteEventArgs)

Gera o ItemDeleting evento.Raises the ItemDeleting event.

OnItemInserted(DetailsViewInsertedEventArgs)

Gera o ItemInserted evento.Raises the ItemInserted event.

OnItemInserting(DetailsViewInsertEventArgs)

Gera o ItemInserting evento.Raises the ItemInserting event.

OnItemUpdated(DetailsViewUpdatedEventArgs)

Gera o ItemUpdated evento.Raises the ItemUpdated event.

OnItemUpdating(DetailsViewUpdateEventArgs)

Gera o ItemUpdating evento.Raises the ItemUpdating event.

OnLoad(EventArgs)

Manipula o evento Load.Handles the Load event.

(Herdado de DataBoundControl)
OnModeChanged(EventArgs)

Gera o ModeChanged evento.Raises the ModeChanged event.

OnModeChanging(DetailsViewModeEventArgs)

Gera o ModeChanging evento.Raises the ModeChanging event.

OnPageIndexChanged(EventArgs)

Gera o PageIndexChanged evento.Raises the PageIndexChanged event.

OnPageIndexChanging(DetailsViewPageEventArgs)

Gera o PageIndexChanging evento.Raises the PageIndexChanging event.

OnPagePreLoad(Object, EventArgs)

Define o estado inicializado do controle associado a dados antes do carregamento do controle.Sets the initialized state of the data-bound control before the control is loaded.

OnPreRender(EventArgs)

Gera o PreRender evento.Raises the PreRender event.

OnUnload(EventArgs)

Gera o evento Unload.Raises the Unload event.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file.

(Herdado de Control)
PerformDataBinding(IEnumerable)

Associa a fonte de dados especificada ao controle DetailsView.Binds the specified data source to the DetailsView control.

PerformSelect()

Recupera dados da fonte de dados associada.Retrieves data from the associated data source.

(Herdado de DataBoundControl)
PrepareControlHierarchy()

Configura a hierarquia de controle do controle DetailsView.Sets up the control hierarchy of the DetailsView control.

RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent.

(Herdado de Control)
RaiseCallbackEvent(String)

Cria os argumentos para o manipulador de retorno de chamada no método GetCallbackEventReference.Creates the arguments for the callback handler in the GetCallbackEventReference method.

RaisePostBackEvent(String)

Gera os eventos apropriados para o controle DetailsView quando ele executa um postback para o servidor.Raises the appropriate events for the DetailsView control when it posts back to the server.

RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Herdado de Control)
Render(HtmlTextWriter)

Exibe o controle DetailsView no cliente usando o objeto HtmlTextWriter especificado.Displays the DetailsView control on the client using the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado.Renders the HTML opening tag of the control to the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do controle no gravador especificado.Renders the contents of the control to the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado.Renders the HTML closing tag of the control into the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client.

(Herdado de Control)
SaveControlState()

Salva as informações de estado das propriedades no controle DetailsView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como false.Saves the state of the properties in the DetailsView control that need to be persisted, even when the EnableViewState property is set to false.

SaveViewState()

Salva o estado de exibição atual do controle DetailsView.Saves the current view state of the DetailsView control.

SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.Sets design-time data for a control.

(Herdado de Control)
SetPageIndex(Int32)

Define o índice da página exibida atualmente no controle DetailsView.Sets the index of the currently displayed page in the DetailsView control.

SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.Assigns an event handler delegate to render the server control and its content into its parent control.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
TrackViewState()

Marca o ponto inicial no qual começar a acompanhar e salvar as alterações de estado de exibição no controle DetailsView.Marks the starting point to begin tracking and saving view-state changes to the DetailsView control.

UpdateItem(Boolean)

Atualiza o registro atual na fonte de dados.Updates the current record in the data source.

ValidateDataSource(Object)

Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar.Verifies that the object a data-bound control binds to is one it can work with.

(Herdado de DataBoundControl)

Eventos

CallingDataMethods

Ocorre quando os métodos de dados estão sendo chamados.Occurs when data methods are being called.

(Herdado de DataBoundControl)
CreatingModelDataSource

Ocorre quando o objeto ModelDataSource está sendo criado.Occurs when the ModelDataSource object is being created.

(Herdado de DataBoundControl)
DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source.

(Herdado de Control)
DataBound

Ocorre após o controle de servidor ser associado a uma fonte de dados.Occurs after the server control binds to a data source.

(Herdado de BaseDataBoundControl)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Herdado de Control)
ItemCommand

Ocorre quando um botão é clicado dentro de um controle DetailsView.Occurs when a button within a DetailsView control is clicked.

ItemCreated

Ocorre quando um registro é criado em um controle DetailsView.Occurs when a record is created in a DetailsView control.

ItemDeleted

Ocorre quando se clica em um botão Excluir em um controle DetailsView, mas após a operação de exclusão.Occurs when a Delete button within a DetailsView control is clicked, but after the delete operation.

ItemDeleting

Ocorre quando se clica em um botão Excluir em um controle DetailsView, mas antes da operação de exclusão.Occurs when a Delete button within a DetailsView control is clicked, but before the delete operation.

ItemInserted

Ocorre ao clicar em um botão Inserir dentro de um controle DetailsView, porém depois da operação de inserção.Occurs when an Insert button within a DetailsView control is clicked, but after the insert operation.

ItemInserting

Ocorre ao clicar em um botão Inserir em um controle DetailsView, porém antes da operação de inserção.Occurs when an Insert button within a DetailsView control is clicked, but before the insert operation.

ItemUpdated

Ocorre quando um botão Atualizar dentro de um controle DetailsView é clicado após a operação de atualização.Occurs when an Update button within a DetailsView control is clicked, but after the update operation.

ItemUpdating

Ocorre quando um botão Atualizar dentro de um controle DetailsView é clicado, mas antes da operação de atualização.Occurs when an Update button within a DetailsView control is clicked, but before the update operation.

Load

Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object.

(Herdado de Control)
ModeChanged

Ocorre quando um controle DetailsView tenta mudar entre os modos de edição, inserção e somente leitura, mas depois que a propriedade CurrentMode é atualizada.Occurs when a DetailsView control attempts to change between edit, insert, and read-only mode, but after the CurrentMode property is updated.

ModeChanging

Ocorre quando um controle DetailsView tenta alterar entre os modos de edição, inserção e somente leitura, mas antes de a propriedade CurrentMode ser atualizada.Occurs when a DetailsView control attempts to change between edit, insert, and read-only mode, but before the CurrentMode property is updated.

PageIndexChanged

Ocorre quando o valor da propriedade PageIndex é alterado depois de uma operação de paginação.Occurs when the value of the PageIndex property changes after a paging operation.

PageIndexChanging

Ocorre quando o valor da propriedade PageIndex é alterado antes de uma operação de paginação.Occurs when the value of the PageIndex property changes before a paging operation.

PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering.

(Herdado de Control)
Unload

Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.Gets an attribute of the Web control with the specified name.

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

Define um atributo do controle da Web para o nome e o valor especificados.Sets an attribute of the Web control to the specified name and value.

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

Cria o script de retorno de chamada para o controle DetailsView.Creates the callback script for the DetailsView control.

ICallbackEventHandler.GetCallbackResult()

Veja o método GetCallbackResult().See the method GetCallbackResult().

ICallbackEventHandler.RaiseCallbackEvent(String)

Aciona o evento de retorno de chamada usando os argumentos especificados.Raises the callback event using the specified arguments.

IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.For a description of this member, see ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().For a description of this member, see GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.For a description of this member, see UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.For a description of this member, see DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.For a description of this member, see HasDataBindings.

(Herdado de Control)
IDataBoundControl.DataKeyNames

Para obter uma descrição dessa propriedade, consulte DataKeyNames.For a description of this property, see DataKeyNames.

IDataBoundControl.DataMember

Para obter uma descrição dessa propriedade, consulte DataMember.For a description of this property, see DataMember.

IDataBoundControl.DataSource

Para obter uma descrição dessa propriedade, consulte DataSource.For a description of this property, see DataSource.

IDataBoundControl.DataSourceID

Para obter uma descrição dessa propriedade, consulte DataSourceID.For a description of this property, see DataSourceID.

IDataBoundControl.DataSourceObject

Para obter uma descrição dessa propriedade, consulte DataSourceObject.For a description of this property, see DataSourceObject.

IDataBoundItemControl.DataKey

Para obter uma descrição dessa propriedade, consulte DataKey.For a description of this property, see DataKey.

IDataBoundItemControl.Mode

Para obter uma descrição dessa propriedade, consulte Mode.For a description of this property, see Mode.

IDataItemContainer.DataItemIndex

Para obter uma descrição desse membro, confira DataItemIndex.For a description of this member, see DataItemIndex.

IDataItemContainer.DisplayIndex

Para obter uma descrição desse membro, confira DisplayIndex.For a description of this member, see DisplayIndex.

IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.For a description of this member, see Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.For a description of this member, see HasExpressions.

(Herdado de Control)
IFieldControl.FieldsGenerator

Para obter uma descrição dessa propriedade, consulte FieldsGenerator.For a description of this property, see FieldsGenerator.

IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Herdado de Control)
IPostBackContainer.GetPostBackOptions(IButtonControl)

Para obter uma descrição desse membro, confira GetPostBackOptions(IButtonControl).For a description of this member, see GetPostBackOptions(IButtonControl).

IPostBackEventHandler.RaisePostBackEvent(String)

Para obter uma descrição desse membro, confira RaisePostBackEvent(String).For a description of this member, see RaisePostBackEvent(String).

Métodos de Extensão

EnablePersistedSelection(BaseDataBoundControl)

Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação.Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Obtém a coleção de valores padrão para o controle de dados especificado.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Obtém os metadados de tabela para o controle de dados especificado.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados de tabela para o controle de dados especificado.Sets the table metadata for the specified data control.

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

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.Enables Dynamic Data behavior for the specified data control.

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

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.Enables Dynamic Data behavior for the specified data control.

Aplica-se a

Veja também