DetailsView Classe
Definição
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 registro único de uma fonte de dados em uma tabela em que cada linha de dados representa um campo do registro. O controle DetailsView 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::IPostBackContainerpublic ref class DetailsView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::ICallbackEventHandler, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::ICallbackContainer, System::Web::UI::WebControls::IDataBoundItemControl, System::Web::UI::WebControls::IFieldControl, System::Web::UI::WebControls::IPostBackContainer[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DetailsView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IPostBackContainer[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DetailsView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.ICallbackEventHandler, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.ICallbackContainer, System.Web.UI.WebControls.IDataBoundItemControl, System.Web.UI.WebControls.IFieldControl, System.Web.UI.WebControls.IPostBackContainer[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DetailsView = class
inherit CompositeDataBoundControl
interface IDataItemContainer
interface INamingContainer
interface ICallbackContainer
interface ICallbackEventHandler
interface IPostBackEventHandler
interface IPostBackContainer[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DetailsView = class
inherit CompositeDataBoundControl
interface IDataItemContainer
interface INamingContainer
interface ICallbackContainer
interface ICallbackEventHandler
interface IPostBackEventHandler
interface IPostBackContainer
interface IDataBoundItemControl
interface IDataBoundControl
interface IFieldControlPublic Class DetailsView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataItemContainer, IPostBackContainer, IPostBackEventHandlerPublic Class DetailsView
Inherits CompositeDataBoundControl
Implements ICallbackContainer, ICallbackEventHandler, IDataBoundItemControl, IDataItemContainer, IFieldControl, IPostBackContainer, IPostBackEventHandler- Herança
- Atributos
- Implementações
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 mestre. 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
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 mestre-detalhes. O DetailsView controle dá suporte aos seguintes recursos:
Associação a controles de fonte de dados, como SqlDataSource.
Recursos internos de inserção.
Funcionalidades internas de atualização e exclusão.
Recursos de paginação internos.
Acesso programático ao DetailsView modelo de 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 é comumente 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 truecomo , que gera automaticamente um objeto de campo de linha associado para cada campo de um tipo associável na fonte de dados. Os tipos associáveis válidos são String, DateTimeDecimal, Guid, e o 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 todos os campos 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 explicitamente declarados 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 fonte 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 é associado automaticamente 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 DetailsView controle como a fonte de 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 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 de 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 pagine 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 as AutoGenerateEditButtonpropriedades true, AutoGenerateDeleteButtonou AutoGenerateInsertButton como , 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 todas 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 , CommandFieldou TemplateField . 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 paginação. Para habilitar a paginação, defina a AllowPaging propriedade como true. A linha do pager pode ser personalizada usando as PagerStyle propriedades e PagerSettings .
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 para a 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 de rodapé. |
| HeaderStyle | As configurações de estilo para a 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 para a 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, PreRendere Render.
| Evento | Descrição |
|---|---|
| ItemCommand | Ocorre quando um usuário clica em um botão no controle DetailsView. |
| 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 controle altera os DetailsView modos. |
| ModeChanging | Ocorre antes que o controle altere os DetailsView modos (editar, inserir ou somente leitura). Esse evento geralmente é usado para cancelar uma alteração de modo. |
| PageIndexChanged | Ocorre quando um dos botões de paginação é acionado, mas após o controle DetailsView manipular 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 de paginação é acionado, mas antes de o controle DetailsView manipular a operação de paginação. Esse evento geralmente é usado para cancelar a operação de paginação. |
Acessibilidade
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 controles de ASP.NET 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
| DetailsView() |
Inicializa uma nova instância da classe DetailsView. |
Propriedades
| AccessKey |
Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web. (Herdado de WebControl) |
| Adapter |
Obtém o adaptador específico de 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 para o objeto TableItemStyle que permite que você defina a aparência das linhas de dados alternadas em um controle DetailsView. |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control) |
| Attributes |
Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle. (Herdado de WebControl) |
| AutoGenerateDeleteButton |
Obtém ou define um valor que indica se o controle interno para excluir o registro atual é exibido em um controle DetailsView. |
| AutoGenerateEditButton |
Obtém ou define um valor que indica se os controles internos para editar o registro atual são exibidos em um controle DetailsView. |
| AutoGenerateInsertButton |
Obtém ou define um valor que indica se os controles internos para inserir um novo registro são exibidos em um controle DetailsView. |
| AutoGenerateRows |
Obtém ou define um valor que indica se campos de linha para cada campo na fonte de dados são gerados e exibidos automaticamente em um controle DetailsView. |
| 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 controle DetailsView. |
| BindingContainer |
Obtém o controle que contém a vinculaçã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 de servidor Web. (Herdado de WebControl) |
| BorderWidth |
Obtém ou define a largura da borda do controle de servidor Web. (Herdado de WebControl) |
| BottomPagerRow |
Obtém um objeto DetailsViewRow que representa a linha de paginação inferior em um controle DetailsView. |
| Caption |
Obtém ou define o texto a ser renderizado em um elemento de legenda HTML em um controle DetailsView. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. |
| CaptionAlign |
Obtém ou define a posição horizontal ou vertical de um elemento de legenda HTML em um controle DetailsView. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa. |
| CellPadding |
Obtém ou define a quantidade de espaço entre o conteúdo e a borda de uma célula. |
| CellSpacing |
Obtém ou define a quantidade de espaço entre células. |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control) |
| CommandRowStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência de uma linha de comando em um controle DetailsView. |
| Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém uma coleção dos controles filho no controle com limite de dados de composição. (Herdado de CompositeDataBoundControl) |
| ControlStyle |
Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ControlStyleCreated |
Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. 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 controle DetailsView. |
| DataItem |
Obtém o item de dados associado ao controle DetailsView. |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control) |
| DataItemCount |
Obtém o número de itens na fonte de dados subjacente. |
| DataItemIndex |
Obtém o índice baseado em zero do item sendo exibido em um controle DetailsView da fonte de dados subjacente. |
| DataKey |
Obtém um objeto DataKey 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 da fonte de dados. |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control) |
| DataMember |
Obtém ou define o nome da lista de dados ao qual o controle com limite de dados está associado, nos casos em que a fonte de dados contém mais de uma lista distinta de itens de dados. (Herdado de DataBoundControl) |
| DataSource |
Obtém ou define o objeto do qual o controle com limite de dados recupera sua lista de itens de dados. (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 interface IDataSource, que fornece acesso ao conteúdo de dados do objeto. (Herdado de DataBoundControl) |
| DefaultMode |
Obtém ou define o modo de entrada de dados padrão do controle DetailsView. |
| DeleteMethod |
Obtém ou define o nome do método na página chamada quando o controle executa uma operação de exclusão. |
| DeleteMethod |
Obtém ou define o nome do método a ser chamado para excluir dados. (Herdado de CompositeDataBoundControl) |
| 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 para o objeto TableItemStyle que permite que você defina a aparência das linhas de dados quando um controle DetailsView está em modo de edição. |
| EmptyDataRowStyle |
Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência da linha de dados vazia exibida quando a fonte de dados associada a um controle DetailsView não contém nenhum registro. |
| EmptyDataTemplate |
Obtém ou define o conteúdo definido pelo usuário para a linha de dados vazia renderizada quando um controle DetailsView é associado a uma fonte de dados que não contém registros. |
| EmptyDataText |
Obtém ou define o texto a ser exibido na linha de dados vazia renderizada quando um controle DetailsView é associado a uma fonte de dados que não contém registros. |
| 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 funções de retorno de chamada do lado do cliente usadas para as operações de paginação no controle DetailsView. |
| 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 de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| FieldHeaderStyle |
Obtém uma referência ao objeto TableItemStyle que permite a você definir a aparência da coluna de cabeçalho em um controle DetailsView. |
| Fields |
Obtém uma coleção de objetos DataControlField que representam os campos de linha declarados especificamente em um controle DetailsView. |
| Font |
Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl) |
| FooterRow |
Obtém um objeto DetailsViewRow que representa a linha de rodapé em um controle DetailsView. |
| FooterStyle |
Obtém uma referência ao objeto TableItemStyle que permite a você definir a aparência da linha de rodapé em um controle DetailsView. |
| FooterTemplate |
Obtém ou define o conteúdo definido pelo usuário para a linha de rodapé em um controle DetailsView. |
| FooterText |
Obtém ou define o texto a ser exibido na linha de rodapé de um controle DetailsView. |
| ForeColor |
Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de WebControl) |
| GridLines |
Obtém ou define o estilo das linhas de grade para um controle DetailsView. |
| 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 de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control) |
| HeaderRow |
Obtém um objeto DetailsViewRow que representa a linha de cabeçalho em um controle DetailsView. |
| HeaderStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de cabeçalho em um controle DetailsView. |
| HeaderTemplate |
Obtém ou define o conteúdo definido pelo usuário para a linha de cabeçalho em um controle DetailsView. |
| HeaderText |
Obtém ou define o texto a ser exibido na linha de cabeçalho de um controle DetailsView. |
| 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 controle DetailsView na página. |
| ID |
Obtém ou define o identificador programático atribuído ao controle de 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 chamada quando o controle executa uma operação de inserção. |
| InsertMethod |
Obtém ou define o nome do método a ser chamado para inserir dados. (Herdado de CompositeDataBoundControl) |
| InsertRowStyle |
Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência das linhas de dados em um controle DetailsView quando o controle DetailsView está em modo de inserção. |
| IsBoundUsingDataSourceID |
Obtém um valor que indica se a propriedade DataSourceID foi definida. (Herdado de BaseDataBoundControl) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste 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 de servidor está salvando alterações no estado de exibição. (Herdado de Control) |
| IsUsingModelBinders |
Obtém um valor que indica se o model binding 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 vinculação de dados com rigidez de tipos. (Herdado de DataBoundControl) |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control) |
| Page |
Obtém uma referência para a instância Page que contém o controle de 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 objeto PagerSettings que permite definir as propriedades dos botões de paginação em um controle DetailsView. |
| PagerStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de paginação em um controle DetailsView. |
| PagerTemplate |
Obtém ou define o conteúdo personalizado para a linha do pager em um controle DetailsView. |
| Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control) |
| RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RequiresDataBinding |
Obtém ou define um valor que indica se o método DataBind() deve ser cancelado. (Herdado de BaseDataBoundControl) |
| Rows |
Obtém uma coleção de objetos DetailsViewRow que representam as linhas de dados em um controle DetailsView. |
| RowsGenerator |
Obtém ou define um objeto que implementa a interface IAutoFieldGenerator para popular automaticamente as linhas na exibição. |
| RowStyle |
Obtém uma referência ao objeto TableItemStyle que permite definir a aparência das linhas de dados em um controle DetailsView. |
| SelectArguments |
Obtém um objeto DataSourceSelectArguments 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 controle DetailsView. |
| SelectMethod |
O nome do método a ser chamado para ler os dados. (Herdado de DataBoundControl) |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou define a capa 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 de servidor Web. (Herdado de WebControl) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o atributo |
| TabIndex |
Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl) |
| TagKey |
Obtém o valor HtmlTextWriterTag para o controle DetailsView. |
| 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 este controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control) |
| ToolTip |
Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web. (Herdado de WebControl) |
| TopPagerRow |
Obtém um objeto DetailsViewRow que representa a linha superior do pager em um controle DetailsView. |
| UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control) |
| UpdateMethod |
Obtém ou define o nome do método na página chamada quando o controle executa uma operação de atualização. |
| UpdateMethod |
Obtém ou define o nome do método a ser chamado para atualizar dados. (Herdado de CompositeDataBoundControl) |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para 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 objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control) |
| Visible |
Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. (Herdado de Control) |
| Width |
Obtém ou define a largura do controle de servidor Web. (Herdado de WebControl) |
Métodos
| AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control) |
| ApplyStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control) |
| ChangeMode(DetailsViewMode) |
Muda o controle de DetailsView para o modo especificado. |
| ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de 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 de servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control) |
| ConfirmInitState() |
Define o estado inicializado do controle associado a dados. (Herdado de BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| CreateAutoGeneratedRow(AutoGeneratedFieldProperties) |
Cria um objeto AutoGeneratedField 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 uma hierarquia de controle usada para renderizar um controle de composição associado a dados com base nos valores armazenados no estado de exibição. (Herdado de CompositeDataBoundControl) |
| CreateChildControls(IEnumerable, Boolean) |
Cria a hierarquia de controle usada para renderizar o controle DetailsView. |
| CreateControlCollection() |
Cria um novo objeto ControlCollection 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 controle DetailsView. |
| CreateDataSourceSelectArguments() |
Cria o objeto DataSourceSelectArguments que é passado para o comando Select. |
| CreateFieldSet(Object, Boolean) |
Cria o conjunto completo de campos de linha automaticamente gerados e definidos pelo usuário usados para gerar a hierarquia de controle. |
| CreateRow(Int32, DataControlRowType, DataControlRowState) |
Cria um objeto DetailsViewRow usando o índice do item, o tipo de linha e o estado de linha especificados. |
| CreateTable() |
Cria a tabela recipiente para o controle DetailsView. |
| DataBind() |
Chama o método DataBind() da classe base. |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (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 do lançamento da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control) |
| EnsureDataBound() |
Chama o método DataBind() após verificar se o controle de listagem de dados requer uma associação de dados e se um controle de fonte de dados válido foi especificado. |
| 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 armazena-os no objeto IOrderedDictionary especificado. |
| FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| Focus() |
Define o foco de entrada para 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 objeto DataSourceView que o controle com associação de dados usa para executar operações de dados. (Herdado de DataBoundControl) |
| GetDataSource() |
Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver. (Herdado de DataBoundControl) |
| GetDesignModeState() |
Obtém os 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 propriedade UniqueID do controle especificado. (Herdado de Control) |
| HasControls() |
Determina se o controle de servidor contém algum controle filho. (Herdado de Control) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control) |
| InitializePager(DetailsViewRow, PagedDataSource) |
Cria a linha de paginação para o controle DetailsView. |
| InitializeRow(DetailsViewRow, DataControlField) |
Inicializa o objeto DetailsViewRow especificado. |
| InsertItem(Boolean) |
Insere o registro atual na fonte de dados. |
| IsBindableType(Type) |
Determina se o tipo de dados especificado pode estar associado a um campo no controle DetailsView. |
| IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Carrega as informações de estado das propriedades no controle DetailsView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como |
| LoadViewState(Object) |
Carrega o estado de exibição salvo anteriormente do controle DetailsView. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control) |
| MarkAsDataBound() |
Define o estado do controle em estado de exibição como associado com êxito aos dados. (Herdado de DataBoundControl) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| MergeStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor Web é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. |
| 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() |
Associa novamente o controle associado a dados a seus dados após a alteração de uma das propriedades de identificação da fonte de dados base. (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 evento Load. (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 do carregamento do controle. |
| 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 controle DetailsView. |
| PerformSelect() |
Recupera dados da fonte de dados associada. (Herdado de DataBoundControl) |
| PrepareControlHierarchy() |
Define a hierarquia de controle do controle DetailsView. |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control) |
| RaiseCallbackEvent(String) |
Cria os argumentos para o manipulador de retorno de chamada no método GetCallbackEventReference. |
| RaisePostBackEvent(String) |
Gera os eventos apropriados para o controle DetailsView quando ele executa um postback para o servidor. |
| RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control) |
| Render(HtmlTextWriter) |
Exibe o controle DetailsView no cliente usando o objeto HtmlTextWriter especificado. |
| 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 HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderContents(HtmlTextWriter) |
Renderiza o conteúdo do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a marca de fechamento HTML do controle para o 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 possa ser usada no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Salva as informações de estado das propriedades no controle DetailsView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como |
| SaveViewState() |
Salva o estado de exibição atual do controle DetailsView. |
| SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. (Herdado de Control) |
| SetPageIndex(Int32) |
Define o índice da página exibida atualmente no controle DetailsView. |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Marca o ponto inicial no qual começar a acompanhar e salvar as alterações de estado de exibição no controle DetailsView. |
| UpdateItem(Boolean) |
Atualiza o registro atual na fonte de dados. |
| ValidateDataSource(Object) |
Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar. (Herdado de DataBoundControl) |
Eventos
| CallingDataMethods |
Ocorre quando os métodos de dados estão sendo chamados. (Herdado de DataBoundControl) |
| CreatingModelDataSource |
Ocorre quando o objeto ModelDataSource está sendo criado. (Herdado de DataBoundControl) |
| DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control) |
| DataBound |
Ocorre após o controle de servidor ser 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 de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control) |
| ItemCommand |
Ocorre quando um botão é clicado dentro de um controle DetailsView. |
| ItemCreated |
Ocorre quando um registro é criado em um controle DetailsView. |
| ItemDeleted |
Ocorre quando se clica em um botão Excluir em um controle DetailsView, mas após a operação de exclusão. |
| ItemDeleting |
Ocorre quando se clica em um botão Excluir em um controle DetailsView, mas antes da operação de exclusão. |
| ItemInserted |
Ocorre ao clicar em um botão Inserir dentro de um controle DetailsView, porém depois da operação de inserção. |
| ItemInserting |
Ocorre ao clicar em um botão Inserir em um controle DetailsView, porém antes da operação de inserção. |
| ItemUpdated |
Ocorre quando um botão Atualizar dentro de um controle DetailsView é clicado após a operação de atualização. |
| ItemUpdating |
Ocorre quando um botão Atualizar dentro de um controle DetailsView é clicado, mas antes da operação de atualização. |
| Load |
Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control) |
| ModeChanged |
Ocorre quando um controle DetailsView tenta mudar entre os modos de edição, inserção e somente leitura, mas depois que a propriedade CurrentMode é atualizada. |
| ModeChanging |
Ocorre quando um controle DetailsView tenta alterar entre os modos de edição, inserção e somente leitura, mas antes de a propriedade CurrentMode ser atualizada. |
| PageIndexChanged |
Ocorre quando o valor da propriedade PageIndex é alterado depois de uma operação de paginação. |
| PageIndexChanging |
Ocorre quando o valor da propriedade PageIndex é alterado antes de uma operação de paginação. |
| PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
| Unload |
Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
| IAttributeAccessor.GetAttribute(String) |
Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controle da Web para o nome e o valor especificados. (Herdado de WebControl) |
| ICallbackContainer.GetCallbackScript(IButtonControl, String) |
Cria o script de retorno de chamada para o controle DetailsView. |
| ICallbackEventHandler.GetCallbackResult() |
Veja o método GetCallbackResult(). |
| ICallbackEventHandler.RaiseCallbackEvent(String) |
Aciona o evento de retorno de chamada usando os argumentos especificados. |
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira 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 desse membro, confira DataItemIndex. |
| IDataItemContainer.DisplayIndex |
Para obter uma descrição desse membro, confira DisplayIndex. |
| IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control) |
| IFieldControl.FieldsGenerator |
Para obter uma descrição dessa propriedade, consulte FieldsGenerator. |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control) |
| IPostBackContainer.GetPostBackOptions(IButtonControl) |
Para obter uma descrição desse membro, confira GetPostBackOptions(IButtonControl). |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Para obter uma descrição desse membro, confira RaisePostBackEvent(String). |
Métodos de Extensão
| EnablePersistedSelection(BaseDataBoundControl) |
Obsoleto.
Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação. |
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados. |
| GetDefaultValues(INamingContainer) |
Obtém a coleção de valores padrão para o controle de dados especificado. |
| GetMetaTable(INamingContainer) |
Obtém os metadados de tabela para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Define os metadados de tabela para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |
| EnableDynamicData(INamingContainer, Type) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
| 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. |
