DetailsView Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Visualizza i valori di un singolo record da un'origine dati in una tabella, in cui ogni riga di dati rappresenta un campo del record. Il DetailsView controllo consente di modificare, eliminare e inserire record.
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- Ereditarietà
- Attributi
- Implementazioni
Esempio
Nell'esempio di codice seguente viene illustrato come usare un DetailsView controllo in combinazione con un GridView controllo per uno scenario master-dettagli semplice. Visualizza i dettagli di un elemento selezionato nel GridView controllo .
<%@ 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>
Nell'esempio di codice seguente viene illustrato come usare il DetailsView controllo per aggiungere, eliminare e modificare record.
<%@ 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>
Nell'esempio di codice seguente viene illustrato come aggiungere in modo dichiarativo campi di riga al DetailsView controllo .
<%@ 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>
Commenti
In questo argomento:
Introduzione
Il DetailsView controllo viene utilizzato per visualizzare un singolo record da un'origine dati in una tabella, in cui ogni campo del record viene visualizzato in una riga della tabella. Può essere usato in combinazione con un GridView controllo per scenari master-dettagli. Il DetailsView controllo supporta le funzionalità seguenti:
Associazione a controlli origine dati, ad esempio SqlDataSource.
Funzionalità di inserimento predefinite.
Funzionalità predefinite di aggiornamento ed eliminazione.
Funzionalità di paging predefinite.
Accesso a livello di codice al DetailsView modello a oggetti per impostare in modo dinamico le proprietà, gestire gli eventi e così via.
Aspetto personalizzabile tramite temi e stili.
Campi riga
Ogni riga di dati nel DetailsView controllo viene creata dichiarando un controllo campo. Diversi tipi di campo di riga determinano il comportamento delle righe nel controllo . I controlli campo derivano da DataControlField. Nella tabella seguente sono elencati i diversi tipi di campo di riga che è possibile usare.
| Tipo di campo colonna | Descrizione |
|---|---|
| BoundField | Visualizza il valore di un campo in un'origine dati come testo. |
| ButtonField | Visualizza un pulsante di comando nel DetailsView controllo . In questo modo è possibile visualizzare una riga con un controllo pulsante personalizzato, ad esempio un pulsante Aggiungi o Rimuovi. |
| CheckBoxField | Visualizza una casella di controllo nel DetailsView controllo . Questo tipo di campo di riga viene comunemente usato per visualizzare i campi con un valore booleano. |
| CommandField | Visualizza i pulsanti di comando predefiniti per eseguire operazioni di modifica, inserimento o eliminazione nel DetailsView controllo. |
| HyperLinkField | Visualizza il valore di un campo in un'origine dati come collegamento ipertestuale. Questo tipo di campo di riga consente di associare un secondo campo all'URL del collegamento ipertestuale. |
| ImageField | Visualizza un'immagine nel DetailsView controllo . |
| TemplateField | Visualizza il contenuto definito dall'utente per una riga nel DetailsView controllo in base a un modello specificato. Questo tipo di campo riga consente di creare un campo riga personalizzato. |
Per impostazione predefinita, la AutoGenerateRows proprietà è impostata su true, che genera automaticamente un oggetto campo riga associato per ogni campo di un tipo associabile nell'origine dati. I tipi associabili validi sono String, DateTime, Decimal, Guide il set di tipi primitivi. Ogni campo viene quindi visualizzato in una riga come testo, nell'ordine in cui ogni campo viene visualizzato nell'origine dati.
La generazione automatica delle righe offre un modo rapido e semplice per visualizzare ogni campo nel record. Tuttavia, per usare DetailsView le funzionalità avanzate del controllo, è necessario dichiarare in modo esplicito i campi di riga da includere nel DetailsView controllo . Per dichiarare i campi di riga, impostare prima la AutoGenerateRows proprietà su false. Aggiungere quindi tag di apertura e chiusura tra i tag di apertura e chiusura <Fields> del DetailsView controllo. Infine, elencare i campi di riga da includere tra i tag di apertura e chiusura <Fields> . I campi di riga specificati vengono aggiunti all'insieme Fields nell'ordine elencato. La Fields raccolta consente di gestire a livello di codice i campi di riga nel DetailsView controllo .
Annotazioni
I campi di riga generati automaticamente non vengono aggiunti alla Fields raccolta.
Annotazioni
I campi di riga dichiarati in modo esplicito possono essere visualizzati in combinazione con i campi di riga generati automaticamente. Quando vengono usati entrambi, viene eseguito il rendering dei campi di riga dichiarati in modo esplicito, seguito dai campi di riga generati automaticamente.
Associazione ai dati
Il DetailsView controllo può essere associato a un controllo origine dati (ad esempio il controllo o ObjectDataSource il SqlDataSource controllo) o a qualsiasi raccolta di origini dati che implementa l'interfacciaSystem.Collections.IEnumerable, ad esempio System.Data.DataView, System.Collections.ArrayListSystem.Collections.Generic.List<T>, o altri tipi di raccolta. Utilizzare uno dei metodi seguenti per associare il DetailsView controllo al tipo di origine dati appropriato:
Per eseguire l'associazione a un controllo origine dati, impostare la DataSourceID proprietà del DetailsView controllo sul ID valore del controllo origine dati. Il DetailsView controllo viene associato automaticamente al controllo origine dati specificato. Si tratta del metodo preferito da associare ai dati.
Per eseguire l'associazione a un'origine dati che implementa l'interfaccia System.Collections.IEnumerable , impostare a livello di codice la DataSource proprietà del DetailsView controllo sull'origine dati e quindi chiamare il DataBind metodo .
Per altre informazioni sul data binding, vedere Associazione a database.
sicurezza
Questo controllo può essere usato per visualizzare l'input dell'utente, che potrebbe includere script client dannosi. Controllare le informazioni inviate da un client per lo script eseguibile, le istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare lo script e il codice HTML nell'input dell'utente. Per altre informazioni, vedere Cenni preliminari sugli exploit di script. I controlli server di convalida vengono forniti anche per valutare l'input dell'utente. Per altre informazioni, vedere Sintassi del controllo server di convalida.
Operazioni dati
Il DetailsView controllo fornisce funzionalità predefinite che consentono all'utente di aggiornare, eliminare, inserire e scorrere gli elementi nel controllo. Quando il DetailsView controllo è associato a un controllo origine dati, il DetailsView controllo può sfruttare le funzionalità del controllo origine dati e fornire funzionalità di aggiornamento automatico, eliminazione, inserimento e paging.
Annotazioni
Il DetailsView controllo può fornire supporto per operazioni di aggiornamento, eliminazione, inserimento e paging con altri tipi di origini dati. Tuttavia, è necessario fornire l'implementazione per queste operazioni in un gestore eventi appropriato. Per altre informazioni, vedere ItemDeleting, ItemInserting e ItemUpdating.
Il DetailsView controllo può aggiungere automaticamente un campo di riga con un CommandField pulsante Modifica, Elimina o Nuovo impostando rispettivamente le AutoGenerateEditButtonproprietà , AutoGenerateDeleteButtono AutoGenerateInsertButton su true. A differenza del pulsante Elimina (che elimina immediatamente il record selezionato), quando si fa clic sul pulsante Modifica o Nuovo, il DetailsView controllo passa rispettivamente alla modalità di modifica o inserimento. In modalità di modifica, il pulsante Modifica viene sostituito con un pulsante Aggiorna e Annulla. I controlli di input appropriati per il tipo di dati del campo (ad esempio un TextBoxCheckBox controllo o ) vengono visualizzati con il valore di un campo da modificare. Facendo clic sul pulsante Aggiorna viene aggiornato il record nell'origine dati, mentre facendo clic sul pulsante Annulla vengono abbandonate le modifiche. Analogamente, in modalità di inserimento, il pulsante Nuovo viene sostituito con un pulsante Inserisci e annulla e i controlli di input vuoti vengono visualizzati per consentire all'utente di immettere i valori per il nuovo record.
Annotazioni
È anche possibile definire manualmente i pulsanti di comando di aggiornamento, eliminazione e inserimento in un ButtonFieldcampo di riga , CommandFieldo TemplateField . Il DetailsView controllo riconosce i pulsanti con la CommandName proprietà impostata su "Edit", "Update", "Delete", "New", "Insert" o "Cancel", ma è comunque necessario fornire la funzionalità manualmente. Per altre informazioni, vedere ItemDeleting, ItemInserting e ItemUpdating.
Il DetailsView controllo fornisce una funzionalità di paging, che consente all'utente di passare ad altri record nell'origine dati. Se abilitata, i controlli di spostamento delle pagine vengono visualizzati in una riga del cercapersone. Per abilitare il paging, impostare la AllowPaging proprietà su true. La riga del cercapersone può essere personalizzata usando le PagerStyle proprietà e PagerSettings .
Personalizzazione dell'interfaccia utente
È possibile personalizzare l'aspetto del DetailsView controllo impostando le proprietà di stile per diverse parti del controllo. Nella tabella seguente sono elencate le proprietà di stile che è possibile impostare.
| Proprietà Style | Descrizione |
|---|---|
| AlternatingRowStyle | Impostazioni di stile per le righe di dati alternate nel DetailsView controllo . Quando questa proprietà è impostata, le righe di dati vengono visualizzate in bande, alternando tra le RowStyle impostazioni e le AlternatingRowStyle impostazioni. |
| CommandRowStyle | Impostazioni di stile per la riga che contiene i pulsanti di comando predefiniti. |
| EditRowStyle | Impostazioni di stile per le righe di dati quando il DetailsView controllo è in modalità di modifica. |
| EmptyDataRowStyle | Impostazioni di stile per la riga di dati vuota visualizzata nel DetailsView controllo quando l'origine dati non contiene record. |
| FooterStyle | Impostazioni di stile per la riga del piè di pagina. |
| HeaderStyle | Impostazioni di stile per la riga di intestazione. |
| InsertRowStyle | Impostazioni di stile per le righe di dati quando il DetailsView controllo è in modalità di inserimento. |
| PagerStyle | Impostazioni di stile per la riga del cercapersone. |
| RowStyle | Impostazioni di stile per le righe di dati nel DetailsView controllo . Quando la AlternatingRowStyle proprietà è impostata anche, le righe di dati vengono visualizzate alternando tra le RowStyle impostazioni e le AlternatingRowStyle impostazioni. |
| FieldHeaderStyle | Impostazioni di stile per la colonna di intestazione. |
Events
Il DetailsView controllo fornisce diversi eventi su cui è possibile programmare. In questo modo è possibile eseguire una routine personalizzata ogni volta che si verifica un evento. Nella tabella seguente sono elencati gli eventi supportati dal DetailsView controllo . Il DetailsView controllo eredita anche questi eventi dalle relative classi di base: DataBinding, DataBound, DisposedPreRenderInitLoade .Render
| Event | Descrizione |
|---|---|
| ItemCommand | Si verifica quando si fa clic su un pulsante nel DetailsView controllo . |
| ItemCreated | Si verifica dopo la creazione di tutti gli DetailsViewRow oggetti nel DetailsView controllo . Questo evento viene spesso usato per modificare i valori di un record prima che venga visualizzato. |
| ItemDeleted | Si verifica quando si fa clic su un pulsante Elimina, ma dopo che il DetailsView controllo elimina il record dall'origine dati. Questo evento viene spesso usato per controllare i risultati dell'operazione di eliminazione. |
| ItemDeleting | Si verifica quando si fa clic su un pulsante Elimina, ma prima che il DetailsView controllo elimini il record dall'origine dati. Questo evento viene spesso usato per annullare l'operazione di eliminazione. |
| ItemInserted | Si verifica quando si fa clic su un pulsante Inserisci, ma dopo che il DetailsView controllo inserisce il record. Questo evento viene spesso usato per controllare i risultati dell'operazione di inserimento. |
| ItemInserting | Si verifica quando si fa clic su un pulsante Inserisci, ma prima che il DetailsView controllo inserisca il record. Questo evento viene spesso usato per annullare l'operazione di inserimento. |
| ItemUpdated | Si verifica quando si fa clic su un pulsante Aggiorna, ma dopo che il DetailsView controllo aggiorna la riga. Questo evento viene spesso usato per controllare i risultati dell'operazione di aggiornamento. |
| ItemUpdating | Si verifica quando si fa clic su un pulsante Aggiorna, ma prima che il DetailsView controllo aggiorni il record. Questo evento viene spesso usato per annullare l'operazione di aggiornamento. |
| ModeChanged | Si verifica dopo la modifica delle modalità di DetailsView controllo (modifica, inserimento o modalità di sola lettura). Questo evento viene spesso usato per eseguire un'attività quando il controllo cambia modalità DetailsView . |
| ModeChanging | Si verifica prima che il DetailsView controllo modifichi le modalità (modifica, inserimento o modalità di sola lettura). Questo evento viene spesso usato per annullare una modifica della modalità. |
| PageIndexChanged | Si verifica quando si fa clic su uno dei pulsanti del cercapersone, ma dopo che il DetailsView controllo gestisce l'operazione di paging. Questo evento viene comunemente usato quando è necessario eseguire un'attività dopo che l'utente passa a un record diverso nel controllo. |
| PageIndexChanging | Si verifica quando si fa clic su uno dei pulsanti del cercapersone, ma prima che il DetailsView controllo gestisca l'operazione di paging. Questo evento viene spesso usato per annullare l'operazione di paging. |
Accessibilità
Per informazioni su come configurare questo controllo in modo che generi markup conforme agli standard di accessibilità, vedere Accessibilità in Visual Studio e ASP.NET e controlli ASP.NET e accessibilità.
Sintassi dichiarativa
<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>
Costruttori
| Nome | Descrizione |
|---|---|
| DetailsView() |
Inizializza una nuova istanza della classe DetailsView. |
Proprietà
| Nome | Descrizione |
|---|---|
| AccessKey |
Ottiene o imposta la chiave di accesso che consente di passare rapidamente al controllo server Web. (Ereditato da WebControl) |
| Adapter |
Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control) |
| AllowPaging |
Ottiene o imposta un valore che indica se la funzionalità di paging è abilitata. |
| AlternatingRowStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto delle righe di dati alternate in un DetailsView controllo . |
| AppRelativeTemplateSourceDirectory |
Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control) |
| Attributes |
Ottiene la raccolta di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl) |
| AutoGenerateDeleteButton |
Ottiene o imposta un valore che indica se il controllo predefinito per eliminare il record corrente viene visualizzato in un DetailsView controllo . |
| AutoGenerateEditButton |
Ottiene o imposta un valore che indica se i controlli predefiniti per modificare il record corrente vengono visualizzati in un DetailsView controllo . |
| AutoGenerateInsertButton |
Ottiene o imposta un valore che indica se i controlli predefiniti per inserire un nuovo record vengono visualizzati in un DetailsView controllo . |
| AutoGenerateRows |
Ottiene o imposta un valore che indica se i campi di riga per ogni campo dell'origine dati vengono generati e visualizzati automaticamente in un DetailsView controllo . |
| BackColor |
Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl) |
| BackImageUrl |
Ottiene o imposta l'URL di un'immagine da visualizzare in background di un DetailsView controllo. |
| BindingContainer |
Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control) |
| BorderColor |
Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl) |
| BorderStyle |
Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl) |
| BorderWidth |
Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl) |
| BottomPagerRow |
Ottiene un DetailsViewRow oggetto che rappresenta la riga del cercapersone inferiore in un DetailsView controllo . |
| Caption |
Ottiene o imposta il testo di cui eseguire il rendering in un elemento della didascalia HTML in un DetailsView controllo . Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi di assistive technology. |
| CaptionAlign |
Ottiene o imposta la posizione orizzontale o verticale dell'elemento della didascalia HTML in un DetailsView controllo . Questa proprietà viene fornita per rendere il controllo più accessibile agli utenti di dispositivi di assistive technology. |
| CellPadding |
Ottiene o imposta la quantità di spazio tra il contenuto di una cella e il bordo della cella. |
| CellSpacing |
Ottiene o imposta la quantità di spazio tra le celle. |
| ChildControlsCreated |
Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control) |
| ClientID |
Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control) |
| ClientIDMode |
Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà . (Ereditato da Control) |
| ClientIDSeparator |
Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control) |
| CommandRowStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto di una riga di comando in un DetailsView controllo . |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene una raccolta dei controlli figlio all'interno del controllo associato a dati composito. (Ereditato da CompositeDataBoundControl) |
| ControlStyle |
Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ControlStyleCreated |
Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel client. (Ereditato da WebControl) |
| CurrentMode |
Ottiene la modalità di immissione dati corrente del DetailsView controllo. |
| DataItem |
Ottiene l'elemento di dati associato al DetailsView controllo . |
| DataItemContainer |
Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control) |
| DataItemCount |
Ottiene il numero di elementi nell'origine dati sottostante. |
| DataItemIndex |
Ottiene l'indice dell'elemento visualizzato in un DetailsView controllo dall'origine dati sottostante. |
| DataKey |
Ottiene un DataKey oggetto che rappresenta la chiave primaria del record visualizzato. |
| DataKeyNames |
Ottiene o imposta una matrice che contiene i nomi dei campi chiave per l'origine dati. |
| DataKeysContainer |
Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control) |
| DataMember |
Ottiene o imposta il nome dell'elenco di dati a cui è associato il controllo associato a dati, nei casi in cui l'origine dati contiene più di un elenco distinto di elementi di dati. (Ereditato da DataBoundControl) |
| DataSource |
Ottiene o imposta l'oggetto da cui il controllo associato a dati recupera l'elenco di elementi di dati. (Ereditato da BaseDataBoundControl) |
| DataSourceID |
Ottiene o imposta l'ID del controllo da cui il controllo associato a dati recupera il relativo elenco di elementi di dati. (Ereditato da DataBoundControl) |
| DataSourceObject |
Ottiene un oggetto che implementa l'interfaccia IDataSource , che fornisce l'accesso al contenuto dei dati dell'oggetto. (Ereditato da DataBoundControl) |
| DefaultMode |
Ottiene o imposta la modalità di immissione dati predefinita del DetailsView controllo. |
| DeleteMethod |
Ottiene o imposta il nome del metodo nella pagina chiamata quando il controllo esegue un'operazione di eliminazione. |
| DesignMode |
Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control) |
| EditRowStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto delle righe di dati quando un DetailsView controllo è in modalità di modifica. |
| EmptyDataRowStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto della riga di dati vuota visualizzata quando l'origine dati associata a un DetailsView controllo non contiene record. |
| EmptyDataTemplate |
Ottiene o imposta il contenuto definito dall'utente per la riga di dati vuota di cui viene eseguito il rendering quando un DetailsView controllo è associato a un'origine dati che non contiene record. |
| EmptyDataText |
Ottiene o imposta il testo da visualizzare nella riga di dati vuota di cui viene eseguito il rendering quando un DetailsView controllo è associato a un'origine dati che non contiene record. |
| Enabled |
Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl) |
| EnableModelValidation |
Ottiene o imposta un valore che indica se la convalida del modello di dati è abilitata. |
| EnablePagingCallbacks |
Ottiene o imposta un valore che indica se le funzioni di callback lato client vengono utilizzate per le operazioni di paging nel DetailsView controllo . |
| EnableTheming |
Ottiene o imposta un valore che indica se i temi si applicano a questo controllo. (Ereditato da WebControl) |
| EnableViewState |
Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control) |
| Events |
Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control) |
| FieldHeaderStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto della colonna di intestazione in un DetailsView controllo . |
| Fields |
Ottiene una raccolta di DataControlField oggetti che rappresentano i campi di riga dichiarati in modo esplicito in un DetailsView controllo . |
| Font |
Ottiene le proprietà del tipo di carattere associate al controllo server Web. (Ereditato da WebControl) |
| FooterRow |
Ottiene un DetailsViewRow oggetto che rappresenta la riga del piè di pagina in un DetailsView controllo . |
| FooterStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto della riga del piè di pagina in un DetailsView controllo . |
| FooterTemplate |
Ottiene o imposta il contenuto definito dall'utente per la riga del piè di pagina in un DetailsView controllo . |
| FooterText |
Ottiene o imposta il testo da visualizzare nella riga del piè di pagina di un DetailsView controllo . |
| ForeColor |
Ottiene o imposta il colore di primo piano (in genere il colore del testo) del controllo server Web. (Ereditato da WebControl) |
| GridLines |
Ottiene o imposta lo stile della griglia per un DetailsView controllo . |
| HasAttributes |
Ottiene un valore che indica se il controllo dispone di attributi impostati. (Ereditato da WebControl) |
| HasChildViewState |
Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control) |
| HeaderRow |
Ottiene un DetailsViewRow oggetto che rappresenta la riga di intestazione in un DetailsView controllo . |
| HeaderStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto della riga di intestazione in un DetailsView controllo . |
| HeaderTemplate |
Ottiene o imposta il contenuto definito dall'utente per la riga di intestazione in un DetailsView controllo . |
| HeaderText |
Ottiene o imposta il testo da visualizzare nella riga di intestazione di un DetailsView controllo. |
| Height |
Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl) |
| HorizontalAlign |
Ottiene o imposta l'allineamento orizzontale di un DetailsView controllo nella pagina. |
| ID |
Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control) |
| IdSeparator |
Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control) |
| Initialized |
Ottiene un valore che indica se il controllo associato a dati è stato inizializzato. (Ereditato da BaseDataBoundControl) |
| InsertMethod |
Ottiene o imposta il nome del metodo nella pagina chiamata quando il controllo esegue un'operazione di inserimento. |
| InsertRowStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto delle righe di dati in un DetailsView controllo quando il DetailsView controllo è in modalità di inserimento. |
| IsBoundUsingDataSourceID |
Ottiene un valore che indica se la DataSourceID proprietà è impostata. (Ereditato da BaseDataBoundControl) |
| IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control) |
| IsDataBindingAutomatic |
Ottiene un valore che indica se il data binding è automatico. (Ereditato da BaseDataBoundControl) |
| IsEnabled |
Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl) |
| IsTrackingViewState |
Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control) |
| IsUsingModelBinders |
Ottiene un valore che indica se l'associazione di modelli è in uso. (Ereditato da CompositeDataBoundControl) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control) |
| ItemType |
Ottiene o imposta il nome del tipo di elemento di dati per il data binding fortemente tipizzato. (Ereditato da DataBoundControl) |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control) |
| NamingContainer |
Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control) |
| Page |
Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control) |
| PageCount |
Ottiene il numero di record nell'origine dati. |
| PageIndex |
Ottiene o imposta l'indice del record visualizzato. |
| PagerSettings |
Ottiene un riferimento all'oggetto PagerSettings che consente di impostare le proprietà dei pulsanti del cercapersone in un DetailsView controllo . |
| PagerStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto della riga del cercapersone in un DetailsView controllo . |
| PagerTemplate |
Ottiene o imposta il contenuto personalizzato per la riga del cercapersone in un DetailsView controllo . |
| Parent |
Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control) |
| RenderingCompatibility |
Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control) |
| RequiresDataBinding |
Ottiene o imposta un valore che indica se il DataBind() metodo deve essere chiamato. (Ereditato da BaseDataBoundControl) |
| Rows |
Ottiene una raccolta di oggetti che rappresentano le righe di DetailsViewRow dati in un DetailsView controllo . |
| RowsGenerator |
Ottiene o imposta un oggetto che implementa l'interfaccia IAutoFieldGenerator per popolare automaticamente le righe nella visualizzazione. |
| RowStyle |
Ottiene un riferimento all'oggetto TableItemStyle che consente di impostare l'aspetto delle righe di dati in un DetailsView controllo . |
| SelectArguments |
Ottiene un DataSourceSelectArguments oggetto utilizzato dal controllo associato a dati durante il recupero di dati da un controllo origine dati. (Ereditato da DataBoundControl) |
| SelectedValue |
Ottiene il valore della chiave dati del record corrente in un DetailsView controllo . |
| SelectMethod |
Nome del metodo da chiamare per leggere i dati. (Ereditato da DataBoundControl) |
| Site |
Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da WebControl) |
| Style |
Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web. (Ereditato da WebControl) |
| SupportsDisabledAttribute |
Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento |
| TabIndex |
Ottiene o imposta l'indice della scheda del controllo server Web. (Ereditato da WebControl) |
| TagKey |
Ottiene il HtmlTextWriterTag valore per il DetailsView controllo . |
| TagName |
Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control) |
| ToolTip |
Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web. (Ereditato da WebControl) |
| TopPagerRow |
Ottiene un DetailsViewRow oggetto che rappresenta la riga del cercapersone superiore in un DetailsView controllo . |
| UniqueID |
Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control) |
| UpdateMethod |
Ottiene o imposta il nome del metodo nella pagina chiamata quando il controllo esegue un'operazione di aggiornamento. |
| ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control) |
| Width |
Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl) |
Metodi
| Nome | Descrizione |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Aggiunge attributi e stili HTML di cui è necessario eseguire il rendering nell'oggetto specificato HtmlTextWriterTag. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| AddedControl(Control, Int32) |
Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| AddParsedSubObject(Object) |
Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control) |
| ApplyStyle(Style) |
Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ApplyStyleSheetSkin(Page) |
Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da Control) |
| BeginRenderTracing(TextWriter, Object) |
Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| BuildProfileTree(String, Boolean) |
Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control) |
| ChangeMode(DetailsViewMode) |
Passa il DetailsView controllo alla modalità specificata. |
| ClearCachedClientID() |
Imposta il valore memorizzato nella ClientID cache su |
| ClearChildControlState() |
Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildState() |
Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildViewState() |
Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearEffectiveClientIDMode() |
Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control) |
| ConfirmInitState() |
Imposta lo stato inizializzato del controllo associato a dati. (Ereditato da BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web da cui viene chiamato questo metodo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CreateAutoGeneratedRow(AutoGeneratedFieldProperties) |
Crea un AutoGeneratedField oggetto che rappresenta un campo di riga generato automaticamente utilizzando le proprietà del campo specificate. |
| CreateAutoGeneratedRows(Object) |
Crea un set di campi di riga generati automaticamente per l'elemento di dati specificato. |
| CreateChildControls() |
Crea la gerarchia di controlli utilizzata per eseguire il rendering di un controllo associato a dati composito in base ai valori archiviati nello stato di visualizzazione. (Ereditato da CompositeDataBoundControl) |
| CreateChildControls(IEnumerable, Boolean) |
Crea la gerarchia dei controlli utilizzata per eseguire il rendering del DetailsView controllo. |
| CreateControlCollection() |
Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da Control) |
| CreateControlStyle() |
Crea un oggetto stile tabella predefinito per il DetailsView controllo . |
| CreateDataSourceSelectArguments() |
Crea l'oggetto DataSourceSelectArguments passato al comando Select. |
| CreateFieldSet(Object, Boolean) |
Crea il set completo di campi di riga generati automaticamente e definiti dall'utente usati per generare la gerarchia dei controlli. |
| CreateRow(Int32, DataControlRowType, DataControlRowState) |
Crea un DetailsViewRow oggetto utilizzando l'indice dell'elemento, il tipo di riga e lo stato della riga specificati. |
| CreateTable() |
Crea la tabella contenitore per il DetailsView controllo . |
| DataBind() |
Chiama il DataBind() metodo della classe base. |
| DataBind(Boolean) |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control) |
| DeleteItem() |
Elimina il record corrente dall'origine dati. |
| Dispose() |
Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control) |
| EndRenderTracing(TextWriter, Object) |
Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| EnsureChildControls() |
Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control) |
| EnsureDataBound() |
Chiama il DataBind() metodo dopo aver verificato che il controllo elenco dati richieda il data binding e che sia specificato un controllo origine dati valido. |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExtractRowValues(IOrderedDictionary, Boolean, Boolean) |
Recupera i valori di ogni campo visualizzato e li archivia nell'oggetto specificato IOrderedDictionary . |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato |
| FindControl(String) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato |
| Focus() |
Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control) |
| GetCallbackResult() |
Restituisce il risultato di un evento di callback destinato a un controllo . |
| GetCallbackScript(IButtonControl, String) |
Restituisce la stringa di callback creata utilizzando l'argomento specificato. |
| GetData() |
Recupera un DataSourceView oggetto utilizzato dal controllo associato a dati per eseguire operazioni sui dati. (Ereditato da DataBoundControl) |
| GetDataSource() |
Recupera l'interfaccia IDataSource a cui è associato il controllo associato a dati, se presente. (Ereditato da DataBoundControl) |
| GetDesignModeState() |
Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRouteUrl(Object) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(String, Object) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control) |
| HasControls() |
Determina se il controllo server contiene controlli figlio. (Ereditato da Control) |
| HasEvents() |
Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control) |
| InitializePager(DetailsViewRow, PagedDataSource) |
Crea la riga del cercapersone per il DetailsView controllo . |
| InitializeRow(DetailsViewRow, DataControlField) |
Inizializza l'oggetto specificato DetailsViewRow . |
| InsertItem(Boolean) |
Inserisce il record corrente nell'origine dati. |
| IsBindableType(Type) |
Determina se il tipo di dati specificato può essere associato a un campo nel DetailsView controllo . |
| IsLiteralContent() |
Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control) |
| LoadControlState(Object) |
Carica lo stato delle proprietà nel DetailsView controllo che devono essere mantenute, anche quando la EnableViewState proprietà è impostata su |
| LoadViewState(Object) |
Carica lo stato di visualizzazione salvato in precedenza del DetailsView controllo. |
| MapPathSecure(String) |
Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MarkAsDataBound() |
Imposta lo stato del controllo nello stato di visualizzazione come associato correttamente ai dati. (Ereditato da DataBoundControl) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto corrente Object. (Ereditato da Object) |
| MergeStyle(Style) |
Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Determina se l'evento per il controllo server Web viene passato alla gerarchia del controllo server dell'interfaccia utente della pagina. |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Genera l'evento CreatingModelDataSource. (Ereditato da DataBoundControl) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnDataBound(EventArgs) |
Genera l'evento DataBound. (Ereditato da BaseDataBoundControl) |
| OnDataPropertyChanged() |
Riassocia il controllo associato a dati ai dati dopo la modifica di una delle proprietà di identificazione dell'origine dati di base. (Ereditato da DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Genera l'evento DataSourceViewChanged. |
| OnInit(EventArgs) |
Genera l'evento Init. |
| OnItemCommand(DetailsViewCommandEventArgs) |
Genera l'evento ItemCommand. |
| OnItemCreated(EventArgs) |
Genera l'evento ItemCreated. |
| OnItemDeleted(DetailsViewDeletedEventArgs) |
Genera l'evento ItemDeleted. |
| OnItemDeleting(DetailsViewDeleteEventArgs) |
Genera l'evento ItemDeleting. |
| OnItemInserted(DetailsViewInsertedEventArgs) |
Genera l'evento ItemInserted. |
| OnItemInserting(DetailsViewInsertEventArgs) |
Genera l'evento ItemInserting. |
| OnItemUpdated(DetailsViewUpdatedEventArgs) |
Genera l'evento ItemUpdated. |
| OnItemUpdating(DetailsViewUpdateEventArgs) |
Genera l'evento ItemUpdating. |
| OnLoad(EventArgs) |
Gestisce l'evento Load . (Ereditato da DataBoundControl) |
| OnModeChanged(EventArgs) |
Genera l'evento ModeChanged. |
| OnModeChanging(DetailsViewModeEventArgs) |
Genera l'evento ModeChanging. |
| OnPageIndexChanged(EventArgs) |
Genera l'evento PageIndexChanged. |
| OnPageIndexChanging(DetailsViewPageEventArgs) |
Genera l'evento PageIndexChanging. |
| OnPagePreLoad(Object, EventArgs) |
Imposta lo stato inizializzato del controllo associato a dati prima del caricamento del controllo. |
| OnPreRender(EventArgs) |
Genera l'evento PreRender. |
| OnUnload(EventArgs) |
Genera l'evento Unload. (Ereditato da Control) |
| OpenFile(String) |
Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control) |
| PerformDataBinding(IEnumerable) |
Associa l'origine dati specificata al DetailsView controllo . |
| PerformSelect() |
Recupera i dati dall'origine dati associata. (Ereditato da DataBoundControl) |
| PrepareControlHierarchy() |
Configura la gerarchia dei controlli del DetailsView controllo. |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control) |
| RaiseCallbackEvent(String) |
Crea gli argomenti per il gestore di callback nel GetCallbackEventReference metodo . |
| RaisePostBackEvent(String) |
Genera gli eventi appropriati per il controllo quando esegue il DetailsView postback al server. |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| Render(HtmlTextWriter) |
Visualizza il DetailsView controllo nel client utilizzando l'oggetto specificato HtmlTextWriter . |
| RenderBeginTag(HtmlTextWriter) |
Esegue il rendering del tag di apertura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderContents(HtmlTextWriter) |
Esegue il rendering del contenuto del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control) |
| RenderEndTag(HtmlTextWriter) |
Esegue il rendering del tag di chiusura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ResolveAdapter() |
Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control) |
| ResolveClientUrl(String) |
Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control) |
| ResolveUrl(String) |
Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salva lo stato delle proprietà nel DetailsView controllo che devono essere mantenute, anche quando la EnableViewState proprietà è impostata su |
| SaveViewState() |
Salva lo stato di visualizzazione corrente del DetailsView controllo. |
| SetDesignModeState(IDictionary) |
Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| SetPageIndex(Int32) |
Imposta l'indice della pagina attualmente visualizzata nel DetailsView controllo . |
| SetRenderMethodDelegate(RenderMethod) |
Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control) |
| SetTraceData(Object, Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| SetTraceData(Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TrackViewState() |
Contrassegna il punto iniziale per iniziare a tenere traccia e salvare le modifiche dello stato di visualizzazione al DetailsView controllo. |
| UpdateItem(Boolean) |
Aggiorna il record corrente nell'origine dati. |
| ValidateDataSource(Object) |
Verifica che l'oggetto a cui è associato un controllo associato a dati sia utilizzabile. (Ereditato da DataBoundControl) |
Eventi
| Nome | Descrizione |
|---|---|
| CallingDataMethods |
Si verifica quando vengono chiamati i metodi di dati. (Ereditato da DataBoundControl) |
| CreatingModelDataSource |
Si verifica quando l'oggetto ModelDataSource viene creato. (Ereditato da DataBoundControl) |
| DataBinding |
Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
| DataBound |
Si verifica dopo l'associazione del controllo server a un'origine dati. (Ereditato da BaseDataBoundControl) |
| Disposed |
Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
| Init |
Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control) |
| ItemCommand |
Si verifica quando si fa clic su un pulsante all'interno di un DetailsView controllo. |
| ItemCreated |
Si verifica quando viene creato un record in un DetailsView controllo . |
| ItemDeleted |
Si verifica quando si fa clic su un pulsante Elimina all'interno di un DetailsView controllo , ma dopo l'operazione di eliminazione. |
| ItemDeleting |
Si verifica quando si fa clic su un pulsante Elimina all'interno di un DetailsView controllo , ma prima dell'operazione di eliminazione. |
| ItemInserted |
Si verifica quando si fa clic su un pulsante Inserisci all'interno di un DetailsView controllo , ma dopo l'operazione di inserimento. |
| ItemInserting |
Si verifica quando si fa clic su un pulsante Inserisci all'interno di un DetailsView controllo , ma prima dell'operazione di inserimento. |
| ItemUpdated |
Si verifica quando si fa clic su un pulsante Aggiorna all'interno di un DetailsView controllo , ma dopo l'operazione di aggiornamento. |
| ItemUpdating |
Si verifica quando si fa clic su un pulsante Aggiorna all'interno di un DetailsView controllo , ma prima dell'operazione di aggiornamento. |
| Load |
Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control) |
| ModeChanged |
Si verifica quando un DetailsView controllo tenta di passare dalla modalità di modifica, inserimento e sola lettura, ma dopo l'aggiornamento della CurrentMode proprietà. |
| ModeChanging |
Si verifica quando un DetailsView controllo tenta di passare dalla modalità di modifica, inserimento e sola lettura, ma prima dell'aggiornamento della CurrentMode proprietà. |
| PageIndexChanged |
Si verifica quando il valore della PageIndex proprietà cambia dopo un'operazione di paging. |
| PageIndexChanging |
Si verifica quando il valore della proprietà viene modificato prima di PageIndex un'operazione di paging. |
| PreRender |
Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control) |
| Unload |
Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Imposta un attributo del controllo Web sul nome e sul valore specificati. (Ereditato da WebControl) |
| ICallbackContainer.GetCallbackScript(IButtonControl, String) |
Crea lo script di callback per il DetailsView controllo . |
| ICallbackEventHandler.GetCallbackResult() |
Vedere il metodo GetCallbackResult(). |
| ICallbackEventHandler.RaiseCallbackEvent(String) |
Genera l'evento di callback utilizzando gli argomenti specificati. |
| IControlBuilderAccessor.ControlBuilder |
Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control) |
| IControlDesignerAccessor.UserData |
Per una descrizione di questo membro, vedere UserData. (Ereditato da Control) |
| IDataBindingsAccessor.DataBindings |
Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control) |
| IDataBindingsAccessor.HasDataBindings |
Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control) |
| IDataBoundControl.DataKeyNames |
Per una descrizione di questa proprietà, vedere DataKeyNames. |
| IDataBoundControl.DataMember |
Per una descrizione di questa proprietà, vedere DataMember. |
| IDataBoundControl.DataSource |
Per una descrizione di questa proprietà, vedere DataSource. |
| IDataBoundControl.DataSourceID |
Per una descrizione di questa proprietà, vedere DataSourceID. |
| IDataBoundControl.DataSourceObject |
Per una descrizione di questa proprietà, vedere DataSourceObject. |
| IDataBoundItemControl.DataKey |
Per una descrizione di questa proprietà, vedere DataKey. |
| IDataBoundItemControl.Mode |
Per una descrizione di questa proprietà, vedere Mode. |
| IDataItemContainer.DataItemIndex |
Per una descrizione di questo membro, vedere DataItemIndex. |
| IDataItemContainer.DisplayIndex |
Per una descrizione di questo membro, vedere DisplayIndex. |
| IExpressionsAccessor.Expressions |
Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control) |
| IExpressionsAccessor.HasExpressions |
Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control) |
| IFieldControl.FieldsGenerator |
Per una descrizione di questa proprietà, vedere FieldsGenerator. |
| IParserAccessor.AddParsedSubObject(Object) |
Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control) |
| IPostBackContainer.GetPostBackOptions(IButtonControl) |
Per una descrizione di questo membro, vedere GetPostBackOptions(IButtonControl). |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Per una descrizione di questo membro, vedere RaisePostBackEvent(String). |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| EnableDynamicData(INamingContainer, Type, Object) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| EnableDynamicData(INamingContainer, Type) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| EnablePersistedSelection(BaseDataBoundControl) |
Obsoleti.
Consente di rendere persistente la selezione nei controlli dati che supportano la selezione e il paging. |
| FindDataSourceControl(Control) |
Restituisce l'origine dati associata al controllo dati per il controllo specificato. |
| FindFieldTemplate(Control, String) |
Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. |
| FindMetaTable(Control) |
Restituisce l'oggetto metatable per il controllo dati contenitore. |
| GetDefaultValues(INamingContainer) |
Ottiene la raccolta dei valori predefiniti per il controllo dati specificato. |
| GetMetaTable(INamingContainer) |
Ottiene i metadati della tabella per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable) |
Imposta i metadati della tabella per il controllo dati specificato. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se i metadati della tabella sono disponibili. |
