DetailsView Classe

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Exibe os valores de um único registro de uma fonte de dados em uma tabela, em que cada linha de dados representa um campo do registro. O DetailsView controle permite que você edite, exclua e insira registros.

public ref class DetailsView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IPostBackContainer

public ref class DetailsView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IDataBoundItemControl, System::Web::UI::WebControls::IFieldControl, System::Web::UI::WebControls::IPostBackContainer

[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DetailsView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IPostBackContainer

[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DetailsView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IDataBoundItemControl, System.Web.UI.WebControls.IFieldControl, System.Web.UI.WebControls.IPostBackContainer

[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DetailsView = class
    inherit CompositeDataBoundControl
    interface IDataItemContainer
    interface INamingContainer
    interface ICallbackContainer
    interface ICallbackEventHandler
    interface IPostBackEventHandler
    interface IPostBackContainer

[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DetailsView = class
    inherit CompositeDataBoundControl
    interface IDataItemContainer
    interface INamingContainer
    interface ICallbackContainer
    interface ICallbackEventHandler
    interface IPostBackEventHandler
    interface IPostBackContainer
    interface IDataBoundItemControl
    interface IDataBoundControl
    interface IFieldControl

Public Class DetailsView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataItemContainer, IPostBackContainer, IPostBackEventHandler

Public Class DetailsView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataBoundItemControl, IDataItemContainer, IFieldControl, IPostBackContainer, IPostBackEventHandler

Herança: Object

Control

WebControl

BaseDataBoundControl

DataBoundControl

CompositeDataBoundControl
DetailsView

Atributos: ControlValuePropertyAttribute

Implementações: ICallbackEventHandler IDataItemContainer INamingContainer IPostBackEventHandler ICallbackContainer IPostBackContainer IDataBoundControl IDataBoundItemControl IFieldControl

Exemplos

O exemplo de código a seguir demonstra como usar um DetailsView controle em combinação com um GridView controle para um cenário simples de detalhes mestres. Ele exibe os detalhes de um item selecionado no GridView controle.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            <asp:GridView ID="GridView1" runat="server" 
              AutoGenerateColumns="False" DataSourceID="Customers"
              DataKeyNames="CustomerID">
              <Columns>
                <asp:CommandField ShowSelectButton="True" />
                <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
                <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              </Columns>
            </asp:GridView>
          </td>
          <td valign="top">
            <asp:DetailsView ID="DetailsView1" runat="server" 
              AutoGenerateRows="True" DataKeyNames="CustomerID"
              DataSourceID="Details" Height="50px" Width="301px">
            </asp:DetailsView>
          </td>
        </tr>
      </table>
        
      <asp:SqlDataSource ID="Details" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
        <SelectParameters>
          <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
            PropertyName="SelectedValue"
            Type="String" />
        </SelectParameters>
      </asp:SqlDataSource>
      <asp:SqlDataSource ID="Customers" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
      </asp:SqlDataSource>
    </div>
  </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            <asp:GridView ID="GridView1" runat="server" 
              AutoGenerateColumns="False" DataSourceID="Customers"
              DataKeyNames="CustomerID">
              <Columns>
                <asp:CommandField ShowSelectButton="True" />
                <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
                <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              </Columns>
            </asp:GridView>
          </td>
          <td valign="top">
            <asp:DetailsView ID="DetailsView1" runat="server" 
              AutoGenerateRows="True" DataKeyNames="CustomerID"
              DataSourceID="Details" Height="50px" Width="301px">
            </asp:DetailsView>
          </td>
        </tr>
      </table>
        
      <asp:SqlDataSource ID="Details" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
        <SelectParameters>
          <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
            PropertyName="SelectedValue"
            Type="String" />
        </SelectParameters>
      </asp:SqlDataSource>
      <asp:SqlDataSource ID="Customers" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
      </asp:SqlDataSource>
    </div>
  </form>
</body>
</html>

O exemplo de código a seguir demonstra como usar o DetailsView controle para adicionar, excluir e editar registros.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  void CustomerDetail_ItemInserted(object sender, 
    DetailsViewInsertedEventArgs e)
  {
    // Refresh the GridView control after a new record is inserted 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemInserting(object sender, 
    DetailsViewInsertEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.Values.Count; i++)
    {
      if (e.Values[i] != null)
      {
        e.Values[i] = Server.HtmlEncode(e.Values[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemUpdated(object sender, 
    DetailsViewUpdatedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemUpdating(object sender, 
    DetailsViewUpdateEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.NewValues.Count; i++)
    {
      if (e.NewValues[i] != null)
      {
        e.NewValues[i] = Server.HtmlEncode(e.NewValues[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemDeleted(object sender, 
    DetailsViewDeletedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>
      DetailsView Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <h3>
      DetailsView Example</h3>
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the customers//s detailed     -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="CustomersView" DataSourceID="Customers" 
            AutoGenerateColumns="False"
            DataKeyNames="CustomerID" runat="server">
            <HeaderStyle BackColor="Blue" ForeColor="White" />
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" 
                HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" 
                HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="CustomerDetail" 
            DataSourceID="Details" AutoGenerateRows="false"
            AutoGenerateInsertButton="true" 
            AutoGenerateEditButton="true" 
            AutoGenerateDeleteButton="true"
            EmptyDataText="No records." 
            DataKeyNames="CustomerID" GridLines="Both" 
            OnItemInserted="CustomerDetail_ItemInserted"
            OnItemInserting="CustomerDetail_ItemInserting" 
            OnItemUpdated="CustomerDetail_ItemUpdated"
            OnItemUpdating="CustomerDetail_ItemUpdating" 
            OnItemDeleted="CustomerDetail_ItemDeleted"
            runat="server">
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <RowStyle BackColor="White" />
            <AlternatingRowStyle BackColor="LightGray" />
            <EditRowStyle BackColor="LightCyan" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="Address" HeaderText="Address" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
              <asp:BoundField DataField="Phone" HeaderText="Phone" />
              <asp:BoundField DataField="Fax" HeaderText="Fax" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                   -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] 
        FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      runat="server" 
      SelectCommand="SELECT * FROM [Customers] 
        WHERE ([CustomerID] = @CustomerID)"
      DeleteCommand="DELETE FROM [Customers] 
        WHERE [CustomerID] = @CustomerID"
      InsertCommand="INSERT INTO [Customers] ([CustomerID], 
        [CompanyName], [ContactName], [ContactTitle], [Address], 
        [City], [Region], [PostalCode], [Country], [Phone], [Fax]) 
        VALUES (@CustomerID, @CompanyName, @ContactName, @ContactTitle, 
        @Address, @City, @Region, @PostalCode, @Country, @Phone, @Fax)"
      UpdateCommand="UPDATE [Customers] SET [CompanyName] = @CompanyName, 
        [ContactName] = @ContactName, [ContactTitle] = @ContactTitle, 
        [Address] = @Address, [City] = @City, [Region] = @Region, 
        [PostalCode] = @PostalCode, [Country] = @Country, 
        [Phone] = @Phone, [Fax] = @Fax 
        WHERE [CustomerID] = @CustomerID">
      <SelectParameters>
        <asp:ControlParameter ControlID="CustomersView" 
          Name="CustomerID" PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
      <DeleteParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
      </DeleteParameters>
      <UpdateParameters>
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
        <asp:Parameter Name="CustomerID" Type="String" />
      </UpdateParameters>
      <InsertParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
      </InsertParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  Sub CustomerDetail_ItemInserted(ByVal sender As Object, _
    ByVal e As DetailsViewInsertedEventArgs)
    ' Refresh the GridView control after a new record is inserted in 
    ' the DetailsView control.
    CustomersView.DataBind()
  End Sub
  
  Sub CustomerDetail_ItemInserting(ByVal sender As Object, _
    ByVal e As DetailsViewInsertEventArgs)
    ' Iterate though the values entered by the user and HTML encode 
    ' the values. This helps prevent malicious values from being 
    ' stored in the data source.
    For i As Integer = 0 To e.Values.Count - 1
      If e.Values(i) IsNot Nothing Then
        e.Values(i) = Server.HtmlEncode(e.Values(i).ToString())
      End If
    Next
  End Sub
  
  Sub CustomerDetail_ItemUpdated(ByVal sender As Object, _
    ByVal e As DetailsViewUpdatedEventArgs)
    ' Refresh the GridView control after a new record is updated 
    ' in the DetailsView control.
    CustomersView.DataBind()
  End Sub
  
  Sub CustomerDetail_ItemUpdating(ByVal sender As Object, _
    ByVal e As DetailsViewUpdateEventArgs)
    ' Iterate though the values entered by the user and HTML encode 
    ' the values. This helps prevent malicious values from being 
    ' stored in the data source.
    For i As Integer = 0 To e.NewValues.Count - 1
      If e.NewValues(i) IsNot Nothing Then
        e.NewValues(i) = Server.HtmlEncode(e.NewValues(i).ToString())
      End If
    Next
  End Sub
  
  Sub CustomerDetail_ItemDeleted(ByVal sender As Object, _
    ByVal e As DetailsViewDeletedEventArgs)
    ' Refresh the GridView control after a new record is updated 
    ' in the DetailsView control.
    CustomersView.DataBind()
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>DetailsView Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <h3>DetailsView Example</h3>
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the customers's detailed      -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="CustomersView" DataSourceID="Customers" 
            AutoGenerateColumns="False"
            DataKeyNames="CustomerID" runat="server">
            <HeaderStyle BackColor="Blue" ForeColor="White" />
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" 
                HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" 
                HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="CustomerDetail" DataSourceID="Details" 
            AutoGenerateRows="false"
            AutoGenerateInsertButton="true" 
            AutoGenerateEditButton="true" 
            AutoGenerateDeleteButton="true"
            EmptyDataText="No records." 
            DataKeyNames="CustomerID" GridLines="Both" 
            OnItemInserted="CustomerDetail_ItemInserted"
            OnItemInserting="CustomerDetail_ItemInserting" 
            OnItemUpdated="CustomerDetail_ItemUpdated"
            OnItemUpdating="CustomerDetail_ItemUpdating" 
            OnItemDeleted="CustomerDetail_ItemDeleted"
            runat="server">
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <RowStyle BackColor="White" />
            <AlternatingRowStyle BackColor="LightGray" />
            <EditRowStyle BackColor="LightCyan" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
                ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="Address" HeaderText="Address" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
              <asp:BoundField DataField="Phone" HeaderText="Phone" />
              <asp:BoundField DataField="Fax" HeaderText="Fax" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                   -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] 
        FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      runat="server" 
      SelectCommand="SELECT * FROM [Customers] 
        WHERE ([CustomerID] = @CustomerID)"
      DeleteCommand="DELETE FROM [Customers] 
        WHERE [CustomerID] = @CustomerID"
      InsertCommand="INSERT INTO [Customers] ([CustomerID], 
        [CompanyName], [ContactName], [ContactTitle], [Address], 
        [City], [Region], [PostalCode], [Country], [Phone], [Fax]) 
        VALUES (@CustomerID, @CompanyName, @ContactName, 
        @ContactTitle, @Address, @City, @Region, @PostalCode, 
        @Country, @Phone, @Fax)"
      UpdateCommand="UPDATE [Customers] SET 
        [CompanyName] = @CompanyName, 
        [ContactName] = @ContactName, [ContactTitle] = @ContactTitle, 
        [Address] = @Address, [City] = @City, [Region] = @Region, 
        [PostalCode] = @PostalCode, [Country] = @Country, 
        [Phone] = @Phone, [Fax] = @Fax 
        WHERE [CustomerID] = @CustomerID">
      <SelectParameters>
        <asp:ControlParameter ControlID="CustomersView" 
          Name="CustomerID" PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
      <DeleteParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
      </DeleteParameters>
      <UpdateParameters>
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
        <asp:Parameter Name="CustomerID" Type="String" />
      </UpdateParameters>
      <InsertParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
      </InsertParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

O exemplo de código a seguir demonstra como adicionar declarativamente campos de linha ao DetailsView controle.

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

Introdução
Campos de linha
Associação a dados
Security
Operações de dados
Personalizando a interface do usuário
Eventos
Acessibilidade
Sintaxe declarativa

Introdução

O DetailsView controle é 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. Ele pode ser usado em combinação com um GridView controle para cenários de detalhes mestres. O DetailsView controle dá suporte aos seguintes recursos:

Associação a controles de fonte de dados, como SqlDataSource.
Funcionalidades internas de inserção.
Recursos internos de atualização e exclusão.
Funcionalidades de paginação internas.
Acesso programático ao modelo de DetailsView objeto para definir dinamicamente propriedades, manipular eventos e assim por diante.
Aparência personalizável por meio de temas e estilos.

Campos de linha

Cada linha de dados no DetailsView controle é criada declarando um controle de campo. Diferentes tipos de campo de linha determinam o comportamento das linhas no controle. Os controles de campo derivam de DataControlField. A tabela a seguir lista os diferentes tipos de campo de linha que podem ser usados.

Tipo de campo de coluna	Descrição
BoundField	Exibe o valor de um campo em uma fonte de dados como texto.
ButtonField	Exibe um botão de comando no DetailsView controle. Isso permite que você exiba uma linha com um controle de botão personalizado, como um botão Adicionar ou Remover.
CheckBoxField	Exibe uma caixa de seleção no DetailsView controle. Esse tipo de campo de linha geralmente é usado para exibir campos com um valor booliano.
CommandField	Exibe botões de comando internos para executar operações de edição, inserção ou exclusão no DetailsView controle.
HyperLinkField	Exibe o valor de um campo em uma fonte de dados como um hiperlink. Esse tipo de campo de linha permite associar um segundo campo à URL do hiperlink.
ImageField	Exibe uma imagem no DetailsView controle.
TemplateField	Exibe o conteúdo definido pelo usuário para uma linha no DetailsView controle de acordo com um modelo especificado. Esse tipo de campo de linha permite que você crie um campo de linha personalizado.

Por padrão, a AutoGenerateRows propriedade é definida como true, que gera automaticamente um objeto de campo de linha associado para cada campo de um tipo associável na fonte de dados. Tipos associáveis válidos são String, DateTime, , Decimale Guido conjunto de tipos primitivos. Cada campo é exibido em uma linha como texto, na ordem em que cada campo aparece na fonte de dados.

Gerar automaticamente as linhas fornece uma maneira rápida e fácil de exibir cada campo no registro. No entanto, para usar os DetailsView recursos avançados do controle, você deve declarar explicitamente os campos de linha a serem incluídos no DetailsView controle. Para declarar os campos de linha, primeiro defina a AutoGenerateRows propriedade como false. Em seguida, adicione marcas de abertura e fechamento <Fields> entre as marcas de abertura e fechamento do DetailsView controle. Por fim, liste os campos de linha que você deseja incluir entre as marcas de abertura e fechamento <Fields> . Os campos de linha especificados são adicionados à Fields coleção na ordem listada. A Fields coleção permite que você gerencie programaticamente os campos de linha no DetailsView controle.

Observação

Os campos de linha gerados automaticamente não são adicionados à Fields coleção.

Observação

Campos de linha declarados explicitamente podem ser exibidos em combinação com campos de linha gerados automaticamente. Quando ambos são usados, os campos de linha declarados explicitamente são renderizados primeiro, seguidos pelos campos de linha gerados automaticamente.

Associação a dados

O DetailsView controle pode ser associado a um controle de fonte de dados (como o SqlDataSource controle ou ObjectDataSource controle) ou a qualquer coleção de fontes de dados que implemente a System.Collections.IEnumerable interface, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou outros tipos de coleção. Use um dos seguintes métodos para associar o DetailsView controle ao tipo de fonte de dados apropriado:

Para associar a um controle de fonte de dados, defina a DataSourceID propriedade do DetailsView controle como o ID valor do controle da fonte de dados. O DetailsView controle é automaticamente associado ao controle de fonte de dados especificado. Esse é o método preferencial para associar a dados.
Para associar a uma fonte de dados que implementa a System.Collections.IEnumerable interface, defina programaticamente a DataSource propriedade do controle para a fonte de DetailsView dados e, em seguida, chame o DataBind método.

Para obter mais informações sobre a associação de dados, consulte Associação a Bancos de Dados.

Segurança

Esse controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado. 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. ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear script e HTML na entrada do usuário. Para obter mais informações, consulte Visão geral das Explorações de Script. Controles de servidor de validação também são fornecidos para avaliar a entrada do usuário. Para obter mais informações, consulte Sintaxe de controle do servidor de validação.

Operações de dados

O DetailsView controle fornece recursos internos que permitem que o usuário atualize, exclua, insira e página por meio de itens no controle. Quando o DetailsView controle está associado a um controle de fonte de dados, o DetailsView controle pode aproveitar os recursos do controle da fonte de dados e fornecer funcionalidades automáticas de atualização, exclusão, inserção e paginação.

Observação

O DetailsView controle 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. Para obter mais informações, consulte ItemDeleting, ItemInserting e ItemUpdating.

O DetailsView controle pode adicionar automaticamente um CommandField campo de linha com um botão Editar, Excluir ou Novo definindo o AutoGenerateDeleteButton AutoGenerateEditButton, ou AutoGenerateInsertButton as propriedades como true, respectivamente. Ao contrário do botão Excluir (que exclui o registro selecionado imediatamente), quando o botão Editar ou Novo é clicado, o DetailsView controle entra no modo de edição ou inserção, respectivamente. No modo de edição, o botão Editar é substituído por um botão Atualizar e Cancelar. Os controles de entrada apropriados para o tipo de dados do campo (como um TextBox ou um CheckBox controle) são exibidos com o valor de um campo para o usuário modificar. Clicar no botão Atualizar atualiza o registro na fonte de dados, enquanto clicar no botão Cancelar abandona as alterações. Da mesma forma, no modo de inserção, o botão Novo é substituído por um botão Inserir e Cancelar, e os controles de entrada vazios são exibidos para o usuário inserir os valores do novo registro.

Observação

Você também pode definir manualmente os botões atualizar, excluir e inserir comandos em um ButtonFieldcampo de linha ou TemplateField de linhaCommandField. O DetailsView controle reconhece botões com a CommandName propriedade definida como "Editar", "Atualizar", "Excluir", "Novo", "Inserir" ou "Cancelar"; no entanto, você ainda deve fornecer a funcionalidade por conta própria. Para obter mais informações, consulte ItemDeleting, ItemInserting e ItemUpdating.

O DetailsView controle fornece um recurso de paginação, que permite que o usuário navegue até outros registros na fonte de dados. Quando habilitados, os controles de navegação de página são exibidos em uma linha de pager. Para habilitar a paginação, defina a AllowPaging propriedade como true. A linha do pager pode ser personalizada usando as propriedades ePagerSettings.PagerStyle

Personalizando a interface do usuário

Você pode personalizar a aparência do DetailsView controle definindo as propriedades de estilo para diferentes partes do controle. A tabela a seguir lista as propriedades de estilo que você pode definir.

Propriedade Style	Descrição
AlternatingRowStyle	As configurações de estilo para as linhas de dados alternadas no DetailsView controle. Quando essa propriedade é definida, as linhas de dados são exibidas em faixas, alternando entre as RowStyle configurações e as AlternatingRowStyle configurações.
CommandRowStyle	As configurações de estilo para a linha que contém os botões de comando internos.
EditRowStyle	As configurações de estilo para as linhas de dados quando o DetailsView controle está no modo de edição.
EmptyDataRowStyle	As configurações de estilo da linha de dados vazia que são exibidas no DetailsView controle quando a fonte de dados não contém nenhum registro.
FooterStyle	As configurações de estilo para a linha do rodapé.
HeaderStyle	As configurações de estilo da linha de cabeçalho.
InsertRowStyle	As configurações de estilo para as linhas de dados quando o DetailsView controle está no modo de inserção.
PagerStyle	As configurações de estilo para a linha do pager.
RowStyle	As configurações de estilo para as linhas de dados no DetailsView controle. Quando a AlternatingRowStyle propriedade também é definida, as linhas de dados são exibidas alternando entre as RowStyle configurações e as AlternatingRowStyle configurações.
FieldHeaderStyle	As configurações de estilo da coluna de cabeçalho.

Eventos

O DetailsView controle fornece vários eventos nos quais você pode programar. Isso permite que você execute uma rotina personalizada sempre que ocorrer um evento. A tabela a seguir lista os eventos compatíveis com o DetailsView controle. O DetailsView controle também herda esses eventos de suas classes base: DataBinding, , DataBound, Disposed, Init, , Load, e PreRender Render.

Acontecimento	Descrição
ItemCommand	Ocorre quando um botão é clicado no DetailsView controle.
ItemCreated	Ocorre depois que todos os DetailsViewRow objetos são criados no DetailsView controle. Esse evento geralmente é usado para modificar os valores de um registro antes de ser exibido.
ItemDeleted	Ocorre quando um botão Excluir é clicado, mas depois que o DetailsView controle exclui o registro da fonte de dados. Esse evento geralmente é usado para verificar os resultados da operação de exclusão.
ItemDeleting	Ocorre quando um botão Excluir é clicado, mas antes que o DetailsView controle exclua o registro da fonte de dados. Esse evento geralmente é usado para cancelar a operação de exclusão.
ItemInserted	Ocorre quando um botão Inserir é clicado, mas depois que o DetailsView controle insere o registro. Esse evento geralmente é usado para verificar os resultados da operação de inserção.
ItemInserting	Ocorre quando um botão Inserir é clicado, mas antes que o DetailsView controle insira o registro. Esse evento geralmente é usado para cancelar a operação de inserção.
ItemUpdated	Ocorre quando um botão Atualizar é clicado, mas depois que o DetailsView controle atualiza a linha. Esse evento geralmente é usado para verificar os resultados da operação de atualização.
ItemUpdating	Ocorre quando um botão Atualizar é clicado, mas antes que o DetailsView controle atualize o registro. Esse evento geralmente é usado para cancelar a operação de atualização.
ModeChanged	Ocorre depois que o controle altera os DetailsView modos (editar, inserir ou somente leitura). Esse evento geralmente é usado para executar uma tarefa quando o DetailsView controle altera os modos.
ModeChanging	Ocorre antes dos modos de alterações de DetailsView controle (editar, inserir ou somente leitura). Esse evento geralmente é usado para cancelar uma alteração de modo.
PageIndexChanged	Ocorre quando um dos botões do pager é clicado, mas depois que o DetailsView controle manipula a operação de paginação. Esse evento geralmente é usado quando você precisa executar uma tarefa depois que o usuário navega para um registro diferente no controle.
PageIndexChanging	Ocorre quando um dos botões do pager é clicado, mas antes que o DetailsView controle manipule a operação de paginação. Esse evento geralmente é usado para cancelar a operação de paginação.

Accessibility

Para obter informações sobre como configurar esse controle para que ele gere marcação em conformidade com os padrões de acessibilidade, consulte Acessibilidade no Visual Studio e ASP.NET e ASP.NET Controles e Acessibilidade.

Sintaxe declarativa

<asp:DetailsView
    AccessKey="string"
    AllowPaging="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateInsertButton="True|False"
    AutoGenerateRows="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DefaultMode="ReadOnly|Edit|Insert"
    EmptyDataText="string"
    Enabled="True|False"
    EnablePagingCallbacks="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    FooterText="string"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    HeaderText="string"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDeleted="ItemDeleted event handler"
    OnItemDeleting="ItemDeleting event handler"
    OnItemInserted="ItemInserted event handler"
    OnItemInserting="ItemInserting event handler"
    OnItemUpdated="ItemUpdated event handler"
    OnItemUpdating="ItemUpdating event handler"
    OnLoad="Load event handler"
    OnModeChanged="ModeChanged event handler"
    OnModeChanging="ModeChanging event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <AlternatingRowStyle />
        <CommandRowStyle />
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FieldHeaderStyle />
        <Fields>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Fields>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <InsertRowStyle />
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle        />
</asp:DetailsView>

Construtores

Nome	Description
DetailsView()	Inicializa uma nova instância da classe DetailsView.

Propriedades

Nome	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web. (Herdado de WebControl)
Adapter	Obtém o adaptador específico do navegador para o controle. (Herdado de Control)
AllowPaging	Obtém ou define um valor que indica se o recurso de paginação está habilitado.
AlternatingRowStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência das linhas de dados alternadas em um DetailsView controle.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle. (Herdado de WebControl)
AutoGenerateDeleteButton	Obtém ou define um valor que indica se o controle interno para excluir o registro atual é exibido em um DetailsView controle.
AutoGenerateEditButton	Obtém ou define um valor que indica se os controles internos para editar o registro atual são exibidos em um DetailsView controle.
AutoGenerateInsertButton	Obtém ou define um valor que indica se os controles internos para inserir um novo registro são exibidos em um DetailsView controle.
AutoGenerateRows	Obtém ou define um valor que indica se os campos de linha para cada campo na fonte de dados são gerados e exibidos automaticamente em um DetailsView controle.
BackColor	Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl)
BackImageUrl	Obtém ou define a URL para uma imagem a ser exibida na tela de fundo de um DetailsView controle.
BindingContainer	Obtém o controle que contém a associação de dados desse controle. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controle Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controle do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da borda do controle do servidor Web. (Herdado de WebControl)
BottomPagerRow	Obtém um DetailsViewRow objeto que representa a linha de pager inferior em um DetailsView controle.
Caption	Obtém ou define o texto a ser renderizado em um elemento de legenda HTML em um DetailsView controle. Essa propriedade é fornecida para tornar o controle mais acessível aos usuários de dispositivos de tecnologia adaptativa.
CaptionAlign	Obtém ou define a posição horizontal ou vertical do elemento de legenda HTML em um DetailsView controle. Essa propriedade é fornecida para tornar o controle mais acessível aos usuários de dispositivos de tecnologia adaptativa.
CellPadding	Obtém ou define a quantidade de espaço entre o conteúdo de uma célula e a borda da célula.
CellSpacing	Obtém ou define a quantidade de espaço entre as células.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control)
ClientID	Obtém a ID de controle para marcação HTML gerada por ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade. (Herdado de Control)
CommandRowStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência de uma linha de comando em um DetailsView controle.
Context	Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém uma coleção dos controles filho dentro do controle associado a dados compostos. (Herdado de CompositeDataBoundControl)
ControlStyle	Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
ControlStyleCreated	Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
CssClass	Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl)
CurrentMode	Obtém o modo de entrada de dados atual do DetailsView controle.
DataItem	Obtém o item de dados associado ao DetailsView controle.
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer. (Herdado de Control)
DataItemCount	Obtém o número de itens na fonte de dados subjacente.
DataItemIndex	Obtém o índice do item que está sendo exibido em um DetailsView controle da fonte de dados subjacente.
DataKey	Obtém um DataKey objeto que representa a chave primária do registro exibido.
DataKeyNames	Obtém ou define uma matriz que contém os nomes dos campos de chave para a fonte de dados.
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl. (Herdado de Control)
DataMember	Obtém ou define o nome da lista de dados à qual o controle associado a dados se associa, nos casos em que a fonte de dados contém mais de uma lista distinta de itens de dados. (Herdado de DataBoundControl)
DataSource	Obtém ou define o objeto do qual o controle associado a dados recupera sua lista de itens de dados. (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. (Herdado de DataBoundControl)
DataSourceObject	Obtém um objeto que implementa a IDataSource interface, que fornece acesso ao conteúdo de dados do objeto. (Herdado de DataBoundControl)
DefaultMode	Obter ou definir o modo de entrada de dados padrão do DetailsView controle.
DeleteMethod	Obtém ou define o nome do método na página que é chamada quando o controle executa uma operação de exclusão.
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
EditRowStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência das linhas de dados quando um DetailsView controle está no modo de edição.
EmptyDataRowStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da linha de dados vazia exibida quando a fonte de dados associada a um DetailsView controle não contém nenhum registro.
EmptyDataTemplate	Obtém ou define o conteúdo definido pelo usuário para a linha de dados vazia renderizada quando um DetailsView controle é associado a uma fonte de dados que não contém nenhum registro.
EmptyDataText	Obtém ou define o texto a ser exibido na linha de dados vazia renderizada quando um DetailsView controle é associado a uma fonte de dados que não contém nenhum registro.
Enabled	Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl)
EnableModelValidation	Obtém ou define um valor que indica se a validação de modelo de dados está habilitada.
EnablePagingCallbacks	Obtém ou define um valor que indica se as funções de retorno de chamada do lado do cliente são usadas para operações de paginação no DetailsView controle.
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl)
EnableViewState	Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
FieldHeaderStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da coluna de cabeçalho em um DetailsView controle.
Fields	Obtém uma coleção de DataControlField objetos que representam os campos de linha explicitamente declarados em um DetailsView controle.
Font	Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl)
FooterRow	Obtém um DetailsViewRow objeto que representa a linha do rodapé em um DetailsView controle.
FooterStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da linha do rodapé em um DetailsView controle.
FooterTemplate	Obtém ou define o conteúdo definido pelo usuário para a linha de rodapé em um DetailsView controle.
FooterText	Obtém ou define o texto a ser exibido na linha do rodapé de um DetailsView controle.
ForeColor	Obtém ou define a cor do primeiro plano (normalmente a cor do texto) do controle do servidor Web. (Herdado de WebControl)
GridLines	Obtém ou define o estilo de linha de grade para um DetailsView controle.
HasAttributes	Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control)
HeaderRow	Obtém um DetailsViewRow objeto que representa a linha de cabeçalho em um DetailsView controle.
HeaderStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da linha de cabeçalho em um DetailsView controle.
HeaderTemplate	Obtém ou define o conteúdo definido pelo usuário para a linha de cabeçalho em um DetailsView controle.
HeaderText	Obtém ou define o texto a ser exibido na linha de cabeçalho de um DetailsView controle.
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl)
HorizontalAlign	Obtém ou define o alinhamento horizontal de um DetailsView controle na página.
ID	Obtém ou define o identificador programático atribuído ao controle do servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
Initialized	Obtém um valor que indica se o controle associado a dados foi inicializado. (Herdado de BaseDataBoundControl)
InsertMethod	Obtém ou define o nome do método na página que é chamada quando o controle executa uma operação de inserção.
InsertRowStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência das linhas de dados em um DetailsView controle quando o DetailsView controle está no modo de inserção.
IsBoundUsingDataSourceID	Obtém um valor que indica se a DataSourceID propriedade está definida. (Herdado de BaseDataBoundControl)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control)
IsDataBindingAutomatic	Obtém um valor que indica se a associação de dados é automática. (Herdado de BaseDataBoundControl)
IsEnabled	Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl)
IsTrackingViewState	Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição. (Herdado de Control)
IsUsingModelBinders	Obtém um valor que indica se a associação de modelo está em uso. (Herdado de CompositeDataBoundControl)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
ItemType	Obtém ou define o nome do tipo de item de dados para associação de dados fortemente tipada. (Herdado de DataBoundControl)
LoadViewStateByID	Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
Page	Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control)
PageCount	Obtém o número de registros na fonte de dados.
PageIndex	Obtém ou define o índice do registro exibido.
PagerSettings	Obtém uma referência ao PagerSettings objeto que permite definir as propriedades dos botões de pager em um DetailsView controle.
PagerStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência da linha do pager em um DetailsView controle.
PagerTemplate	Obtém ou define o conteúdo personalizado para a linha de pager em um DetailsView controle.
Parent	Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control)
RenderingCompatibility	Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RequiresDataBinding	Obtém ou define um valor que indica se o DataBind() método deve ser chamado. (Herdado de BaseDataBoundControl)
Rows	Obtém uma coleção de DetailsViewRow objetos que representam as linhas de dados em um DetailsView controle.
RowsGenerator	Obtém ou define um objeto que implementa a IAutoFieldGenerator interface para preencher automaticamente as linhas no modo de exibição.
RowStyle	Obtém uma referência ao TableItemStyle objeto que permite definir a aparência das linhas de dados em um DetailsView controle.
SelectArguments	Obtém um DataSourceSelectArguments objeto que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados. (Herdado de DataBoundControl)
SelectedValue	Obtém o valor da chave de dados do registro atual em um DetailsView controle.
SelectMethod	O nome do método a ser chamado para ler dados. (Herdado de DataBoundControl)
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a pele a ser aplicada ao controle. (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 do servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controle é `false`. (Herdado de BaseDataBoundControl)
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém o HtmlTextWriterTag valor do DetailsView controle.
TagName	Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
TemplateControl	Obtém ou define uma referência ao modelo que contém esse controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control)
ToolTip	Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web. (Herdado de WebControl)
TopPagerRow	Obtém um DetailsViewRow objeto que representa a linha de pager superior em um DetailsView controle.
UniqueID	Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control)
UpdateMethod	Obtém ou define o nome do método na página que é chamada quando o controle executa uma operação de atualização.
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos. (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. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página. (Herdado de Control)
Width	Obtém ou define a largura do controle do servidor Web. (Herdado de WebControl)

Métodos

Nome	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona atributos HTML e estilos que precisam ser renderizados ao especificado HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control)
ApplyStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control)
ChangeMode(DetailsViewMode)	Alterna o DetailsView controle para o modo especificado.
ClearCachedClientID()	Define o valor armazenado em ClientID cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle do servidor. (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 do servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control)
ConfirmInitState()	Define o estado inicializado do controle associado a dados. (Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateAutoGeneratedRow(AutoGeneratedFieldProperties)	Cria um AutoGeneratedField objeto que representa um campo de linha gerado automaticamente usando as propriedades de campo especificadas.
CreateAutoGeneratedRows(Object)	Cria um conjunto de campos de linha gerados automaticamente para o item de dados especificado.
CreateChildControls()	Cria a hierarquia de controle usada para renderizar um controle associado a dados compostos com base nos valores armazenados no estado de exibição. (Herdado de CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean)	Cria a hierarquia de controle usada para renderizar o DetailsView controle.
CreateControlCollection()	Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlStyle()	Cria um objeto de estilo de tabela padrão para o DetailsView controle.
CreateDataSourceSelectArguments()	Cria o DataSourceSelectArguments objeto que é passado para o comando Selecionar.
CreateFieldSet(Object, Boolean)	Cria o conjunto completo de campos de linha gerados automaticamente e definidos pelo usuário usados para gerar a hierarquia de controle.
CreateRow(Int32, DataControlRowType, DataControlRowState)	Cria um DetailsViewRow objeto usando o índice de item, o tipo de linha e o estado da linha especificados.
CreateTable()	Cria a tabela de contenção para o DetailsView controle.
DataBind()	Chama o DataBind() método da classe base.
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
DeleteItem()	Exclui o registro atual da fonte de dados.
Dispose()	Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho. (Herdado de Control)
EnsureDataBound()	Chama o DataBind() método depois de verificar se o controle de listagem de dados requer associação de dados e se um controle de fonte de dados válido é especificado.
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExtractRowValues(IOrderedDictionary, Boolean, Boolean)	Recupera os valores de cada campo exibido e os armazena no objeto especificado IOrderedDictionary .
FindControl(String, Int32)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado `id` e um inteiro, especificado no parâmetro, que `pathOffset` ajuda na pesquisa. Você não deve substituir essa versão do FindControl método. (Herdado de Control)
FindControl(String)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada como um controle. (Herdado de Control)
GetCallbackResult()	Retorna o resultado de um evento de retorno de chamada direcionado a um controle.
GetCallbackScript(IButtonControl, String)	Retorna a cadeia de caracteres de retorno de chamada criada usando o argumento especificado.
GetData()	Recupera um DataSourceView objeto que o controle associado a dados usa para executar operações de dados. (Herdado de DataBoundControl)
GetDataSource()	Recupera a IDataSource interface à qual o controle associado a dados está associado, se houver. (Herdado de DataBoundControl)
GetDesignModeState()	Obtém dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (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. (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. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da UniqueID propriedade do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle do servidor contém controles filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control)
InitializePager(DetailsViewRow, PagedDataSource)	Cria a linha do pager para o DetailsView controle.
InitializeRow(DetailsViewRow, DataControlField)	Inicializa o objeto especificado DetailsViewRow .
InsertItem(Boolean)	Insere o registro atual na fonte de dados.
IsBindableType(Type)	Determina se o tipo de dados especificado pode ser associado a um campo no DetailsView controle.
IsLiteralContent()	Determina se o controle do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Carrega o estado das propriedades no DetailsView controle que precisam ser persistentes, mesmo quando a EnableViewState propriedade é definida como `false`.
LoadViewState(Object)	Carrega o estado de exibição salvo anteriormente do DetailsView controle.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control)
MarkAsDataBound()	Define o estado do controle no estado de exibição como associado com êxito aos dados. (Herdado de DataBoundControl)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MergeStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controle do servidor Web é passado para a hierarquia de controle de servidor da interface do usuário (interface do usuário) da página.
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)	Aciona o evento CreatingModelDataSource. (Herdado de DataBoundControl)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnDataBound(EventArgs)	Aciona o evento DataBound. (Herdado de BaseDataBoundControl)
OnDataPropertyChanged()	Vincula novamente o controle associado a dados a seus dados depois que uma das propriedades de identificação da fonte de dados base é alterada. (Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)	Aciona o evento DataSourceViewChanged.
OnInit(EventArgs)	Aciona o evento Init.
OnItemCommand(DetailsViewCommandEventArgs)	Aciona o evento ItemCommand.
OnItemCreated(EventArgs)	Aciona o evento ItemCreated.
OnItemDeleted(DetailsViewDeletedEventArgs)	Aciona o evento ItemDeleted.
OnItemDeleting(DetailsViewDeleteEventArgs)	Aciona o evento ItemDeleting.
OnItemInserted(DetailsViewInsertedEventArgs)	Aciona o evento ItemInserted.
OnItemInserting(DetailsViewInsertEventArgs)	Aciona o evento ItemInserting.
OnItemUpdated(DetailsViewUpdatedEventArgs)	Aciona o evento ItemUpdated.
OnItemUpdating(DetailsViewUpdateEventArgs)	Aciona o evento ItemUpdating.
OnLoad(EventArgs)	Manipula o Load evento. (Herdado de DataBoundControl)
OnModeChanged(EventArgs)	Aciona o evento ModeChanged.
OnModeChanging(DetailsViewModeEventArgs)	Aciona o evento ModeChanging.
OnPageIndexChanged(EventArgs)	Aciona o evento PageIndexChanged.
OnPageIndexChanging(DetailsViewPageEventArgs)	Aciona o evento PageIndexChanging.
OnPagePreLoad(Object, EventArgs)	Define o estado inicializado do controle associado a dados antes que o controle seja carregado.
OnPreRender(EventArgs)	Aciona o evento PreRender.
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
PerformDataBinding(IEnumerable)	Associa a fonte de dados especificada ao DetailsView controle.
PerformSelect()	Recupera dados da fonte de dados associada. (Herdado de DataBoundControl)
PrepareControlHierarchy()	Configura a hierarquia de controle do DetailsView controle.
RaiseBubbleEvent(Object, EventArgs)	Atribui todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control)
RaiseCallbackEvent(String)	Cria os argumentos para o manipulador de retorno de chamada no GetCallbackEventReference método.
RaisePostBackEvent(String)	Gera os eventos apropriados para o DetailsView controle quando ele é postagem de volta para o servidor.
RemovedControl(Control)	Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Exibe o DetailsView controle no cliente usando o objeto especificado HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)	Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza o conteúdo do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento HTML do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que é utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva o estado das propriedades no DetailsView controle que precisam ser persistentes, mesmo quando a EnableViewState propriedade é definida como `false`.
SaveViewState()	Salva o estado de exibição atual do DetailsView controle.
SetDesignModeState(IDictionary)	Define dados de tempo de design para um controle. (Herdado de Control)
SetPageIndex(Int32)	Define o índice da página exibida no momento no DetailsView controle.
SetRenderMethodDelegate(RenderMethod)	Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Marca o ponto inicial para começar a acompanhar e salvar alterações de estado de exibição no DetailsView controle.
UpdateItem(Boolean)	Atualiza o registro atual na fonte de dados.
ValidateDataSource(Object)	Verifica se o objeto ao qual um controle associado a dados se associa é aquele com o qual ele pode trabalhar. (Herdado de DataBoundControl)

Eventos

Nome	Description
CallingDataMethods	Ocorre quando os métodos de dados estão sendo chamados. (Herdado de DataBoundControl)
CreatingModelDataSource	Ocorre quando o ModelDataSource objeto está sendo criado. (Herdado de DataBoundControl)
DataBinding	Ocorre quando o controle do servidor é associado a uma fonte de dados. (Herdado de Control)
DataBound	Ocorre depois que o controle do servidor é associado a uma fonte de dados. (Herdado de BaseDataBoundControl)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control)
ItemCommand	Ocorre quando um botão dentro de um DetailsView controle é clicado.
ItemCreated	Ocorre quando um registro é criado em um DetailsView controle.
ItemDeleted	Ocorre quando um botão Excluir dentro de um DetailsView controle é clicado, mas após a operação de exclusão.
ItemDeleting	Ocorre quando um botão Excluir dentro de um DetailsView controle é clicado, mas antes da operação de exclusão.
ItemInserted	Ocorre quando um botão Inserir dentro de um DetailsView controle é clicado, mas após a operação de inserção.
ItemInserting	Ocorre quando um botão Inserir dentro de um DetailsView controle é clicado, mas antes da operação de inserção.
ItemUpdated	Ocorre quando um botão Atualizar dentro de um DetailsView controle é clicado, mas após a operação de atualização.
ItemUpdating	Ocorre quando um botão Atualizar dentro de um DetailsView controle é clicado, mas antes da operação de atualização.
Load	Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control)
ModeChanged	Ocorre quando um DetailsView controle tenta alterar entre o modo de edição, inserção e somente leitura, mas depois que a CurrentMode propriedade é atualizada.
ModeChanging	Ocorre quando um DetailsView controle tenta alterar entre o modo de edição, inserção e somente leitura, mas antes que a CurrentMode propriedade seja atualizada.
PageIndexChanged	Ocorre quando o valor da PageIndex propriedade é alterado após uma operação de paginação.
PageIndexChanging	Ocorre quando o valor da PageIndex propriedade é alterado antes de uma operação de paginação.
PreRender	Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

Nome	Description
IAttributeAccessor.GetAttribute(String)	Obtém um atributo do controle Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controle Web como o nome e o valor especificados. (Herdado de WebControl)
ICallbackContainer.GetCallbackScript(IButtonControl, String)	Cria o script de retorno de chamada para o DetailsView controle.
ICallbackEventHandler.GetCallbackResult()	Consulte o método GetCallbackResult().
ICallbackEventHandler.RaiseCallbackEvent(String)	Gera o evento de retorno de chamada usando os argumentos especificados.
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição deste membro, consulte UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control)
IDataBoundControl.DataKeyNames	Para obter uma descrição dessa propriedade, consulte DataKeyNames.
IDataBoundControl.DataMember	Para obter uma descrição dessa propriedade, consulte DataMember.
IDataBoundControl.DataSource	Para obter uma descrição dessa propriedade, consulte DataSource.
IDataBoundControl.DataSourceID	Para obter uma descrição dessa propriedade, consulte DataSourceID.
IDataBoundControl.DataSourceObject	Para obter uma descrição dessa propriedade, consulte DataSourceObject.
IDataBoundItemControl.DataKey	Para obter uma descrição dessa propriedade, consulte DataKey.
IDataBoundItemControl.Mode	Para obter uma descrição dessa propriedade, consulte Mode.
IDataItemContainer.DataItemIndex	Para obter uma descrição deste membro, consulte DataItemIndex.
IDataItemContainer.DisplayIndex	Para obter uma descrição deste membro, consulte DisplayIndex.
IExpressionsAccessor.Expressions	Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control)
IFieldControl.FieldsGenerator	Para obter uma descrição dessa propriedade, consulte FieldsGenerator.
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control)
IPostBackContainer.GetPostBackOptions(IButtonControl)	Para obter uma descrição deste membro, consulte GetPostBackOptions(IButtonControl).
IPostBackEventHandler.RaisePostBackEvent(String)	Para obter uma descrição deste membro, consulte RaisePostBackEvent(String).

Métodos de Extensão

Nome	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnablePersistedSelection(BaseDataBoundControl)	Obsoleto. Permite que a seleção seja mantida em controles de dados que dão suporte à seleção e à paginação.
FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados para o controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatável para o controle de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a coleção dos valores padrão para o controle de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controle de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Compartilhar via

DetailsView Classe

Definição

Exemplos

Comentários

Introdução

Campos de linha

Associação a dados

Segurança

Operações de dados

Personalizando a interface do usuário

Eventos

Accessibility

Sintaxe declarativa

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a

Confira também

Comentários