DetailsView Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отображает значения одной записи из источника данных в таблице, где каждая строка данных представляет поле записи. Элемент DetailsView управления позволяет изменять, удалять и вставлять записи.
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- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере кода показано, как использовать DetailsView элемент управления в сочетании с GridView элементом управления для простого сценария master-detail. В нем отображаются сведения о элементе, выбранном в элементе GridView управления.
<%@ 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>
В следующем примере кода показано, как использовать DetailsView элемент управления для добавления, удаления и изменения записей.
<%@ 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>
В следующем примере кода показано, как декларативно добавлять поля строк в DetailsView элемент управления.
<%@ 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>
Комментарии
В этом разделе:
Введение
Элемент DetailsView управления используется для отображения одной записи из источника данных в таблице, где каждое поле записи отображается в строке таблицы. Его можно использовать в сочетании с элементом GridView управления для сценариев master-detail. Элемент DetailsView управления поддерживает следующие функции:
Привязка к элементам управления источниками данных, например SqlDataSource.
Встроенные возможности вставки.
Встроенные возможности обновления и удаления.
Встроенные возможности разбиения по страницам.
Программный доступ к объектной модели для динамического DetailsView задания свойств, обработки событий и т. д.
Настраиваемый внешний вид с помощью тем и стилей.
Поля строк
Каждая строка данных в элементе DetailsView управления создается путем объявления элемента управления полем. Различные типы полей строк определяют поведение строк в элементе управления. Элементы управления полями являются производными от DataControlField. В следующей таблице перечислены различные типы полей строк, которые можно использовать.
| Тип поля столбца | Описание |
|---|---|
| BoundField | Отображает значение поля в источнике данных в виде текста. |
| ButtonField | Отображает кнопку команды в элементе DetailsView управления. Это позволяет отображать строку с пользовательским элементом управления кнопкой, например кнопкой "Добавить" или "Удалить". |
| CheckBoxField | Отображает флажок в элементе DetailsView управления. Этот тип поля строки обычно используется для отображения полей с логическим значением. |
| CommandField | Отображает встроенные кнопки команд для выполнения операций редактирования, вставки или удаления в элементе DetailsView управления. |
| HyperLinkField | Отображает значение поля в источнике данных в виде гиперссылки. Этот тип поля строки позволяет привязать второе поле к URL-адресу гиперссылки. |
| ImageField | Отображает изображение в элементе DetailsView управления. |
| TemplateField | Отображает определяемое пользователем содержимое строки в DetailsView элементе управления в соответствии с указанным шаблоном. Этот тип поля строки позволяет создать настраиваемое поле строки. |
По умолчанию AutoGenerateRows для свойства задано trueзначение, которое автоматически создает связанный объект поля строки для каждого поля привязываемого типа в источнике данных. Допустимые привязываемые типы: String, DateTime, DecimalGuidи набор примитивных типов. Затем каждое поле отображается в строке в виде текста в том порядке, в котором каждое поле отображается в источнике данных.
Автоматическое создание строк обеспечивает быстрый и простой способ отображения каждого поля в записи. Однако для использования расширенных возможностей DetailsView элемента управления необходимо явно объявить поля строк для включения в DetailsView элемент управления. Чтобы объявить поля строк, сначала задайте AutoGenerateRows для свойства значение false. Затем добавьте открывающие и закрывающие теги между открывающим и закрывающим <Fields> тегами DetailsView элемента управления. Наконец, перечислите поля строк, которые необходимо включить между открывающими и закрывающими <Fields> тегами. Указанные поля строк добавляются в Fields коллекцию в указанном порядке. Коллекция Fields позволяет программно управлять полями строк в элементе DetailsView управления.
Замечание
Автоматически созданные поля строк не добавляются в коллекцию Fields .
Замечание
Явно объявленные поля строк можно отображать в сочетании с автоматически созданными полями строк. При использовании оба поля явно объявленных строк отображаются сначала, а затем автоматически созданные поля строк.
Привязка к данным
Элемент DetailsView управления может быть привязан к элементу управления источником данных (напримерSqlDataSource, элементу управления или элементу System.Collections.IEnumerable управления) или ObjectDataSource к любой коллекции источников данных, реализующей интерфейс, например System.Data.DataViewSystem.Collections.ArrayListSystem.Collections.Generic.List<T>, или другим типам коллекций. Используйте один из следующих методов для привязки DetailsView элемента управления к соответствующему типу источника данных:
Чтобы выполнить привязку к элементу управления источником данных, задайте DataSourceID для свойства DetailsView элемента управления ID значение элемента управления источниками данных. Элемент DetailsView управления автоматически привязывается к указанному элементу управления источниками данных. Это предпочтительный метод для привязки к данным.
Чтобы привязаться к источнику данных, реализующего System.Collections.IEnumerable интерфейс, программно задайте DataSource свойство DetailsView элемента управления источнику данных, а затем вызовите DataBind метод.
Дополнительные сведения о привязке данных см. в разделе "Привязка к базам данных".
Безопасность
Этот элемент управления можно использовать для отображения входных данных пользователей, которые могут включать вредоносный скрипт клиента. Проверьте все сведения, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода перед отображением в приложении. ASP.NET предоставляет функцию проверки входных запросов для блокировки скрипта и HTML в входных данных пользователя. Дополнительные сведения см. в разделе "Обзор эксплойтов скриптов". Серверные элементы управления проверки также предоставляются для оценки входных данных пользователей. Дополнительные сведения см. в разделе "Синтаксис управления сервером проверки".
Операции с данными
Элемент DetailsView управления предоставляет встроенные возможности, позволяющие пользователю обновлять, удалять, вставлять и страницы с помощью элементов в элементе управления. DetailsView Если элемент управления привязан к элементу управления версиями данных, DetailsView элемент управления может воспользоваться преимуществами возможностей системы управления версиями данных и обеспечить автоматическое обновление, удаление, вставку и функциональность разбиения по страницам.
Замечание
Элемент управления может обеспечить поддержку операций обновления, удаления, вставки и разбиения по страницам с другими типами источников данных. Однако DetailsView необходимо предоставить реализацию этих операций в соответствующем обработчике событий. Дополнительные сведения см. в статьях ItemDeleting, ItemInserting и ItemUpdating.
Элемент DetailsView управления может автоматически добавлять CommandField поле строки с кнопкой "Изменить", "Удалить" или "Создать", задав AutoGenerateEditButtonAutoGenerateDeleteButtonдля свойства или AutoGenerateInsertButton свойства trueсоответственно. В отличие от кнопки "Удалить" (которая немедленно удаляет выбранную запись), при нажатии кнопки "Изменить" или "Создать" DetailsView элемент управления переходит в режим редактирования или вставки соответственно. В режиме редактирования кнопка "Изменить" заменена кнопкой "Обновить" и кнопкой "Отмена". Элементы управления входными данными, соответствующие типу данных поля (например TextBox , элементу управления или CheckBox элементу управления), отображаются со значением поля для изменения пользователем. Нажатие кнопки "Обновить" обновляет запись в источнике данных, при нажатии кнопки "Отмена" все изменения не изменяются. Аналогичным образом, в режиме вставки кнопка "Создать" заменяется кнопкой "Вставка" и "Отмена", а пустые элементы управления входными данными отображаются для ввода значений новой записи.
Замечание
Вы также можете вручную определить кнопки обновления, удаления и вставки команд в ButtonFieldCommandFieldполе строки или TemplateField в поле строки. Элемент DetailsView управления распознает кнопки со свойством CommandName " Изменить", "Обновить", "Удалить", "Создать", "Вставить" или "Отмена", но вы по-прежнему должны предоставлять функциональные возможности самостоятельно. Дополнительные сведения см. в статьях ItemDeleting, ItemInserting и ItemUpdating.
Элемент DetailsView управления предоставляет функцию разбиения по страницам, которая позволяет пользователю переходить к другим записям в источнике данных. При включении элементы управления навигацией страницы отображаются в строке пейджера. Чтобы включить разбиение по страницам AllowPaging , задайте для свойства значение true. Строка пейджера может быть настроена с помощью PagerStyle свойств и PagerSettings свойств.
Настройка пользовательского интерфейса
Внешний DetailsView вид элемента управления можно настроить, задав свойства стиля для разных частей элемента управления. В следующей таблице перечислены свойства стиля, которые можно задать.
| Свойство Style | Описание |
|---|---|
| AlternatingRowStyle | Параметры стиля для чередующихся строк данных в элементе DetailsView управления. Если это свойство задано, строки данных отображаются в группах, чередуясь между RowStyle параметрами и AlternatingRowStyle параметрами. |
| CommandRowStyle | Параметры стиля для строки, содержащей встроенные кнопки команд. |
| EditRowStyle | Параметры стиля для строк данных, когда DetailsView элемент управления находится в режиме редактирования. |
| EmptyDataRowStyle | Параметры стиля для пустой строки данных, отображаемой в элементе DetailsView управления, если источник данных не содержит записей. |
| FooterStyle | Параметры стиля для строки нижнего колонтитула. |
| HeaderStyle | Параметры стиля для строки заголовка. |
| InsertRowStyle | Параметры стиля для строк данных, когда DetailsView элемент управления находится в режиме вставки. |
| PagerStyle | Параметры стиля для строки пейджера. |
| RowStyle | Параметры стиля для строк данных в элементе DetailsView управления. AlternatingRowStyle Если свойство также задано, строки данных отображаются чередующимися между RowStyle параметрами и AlternatingRowStyle параметрами. |
| FieldHeaderStyle | Параметры стиля для столбца заголовка. |
События
Элемент DetailsView управления предоставляет несколько событий, которые можно программовать. Это позволяет запускать пользовательскую подпрограмму всякий раз, когда происходит событие. В следующей таблице перечислены события, поддерживаемые элементом DetailsView управления. Элемент DetailsView управления также наследует эти события от своих базовых классов: DataBinding, DataBound, Disposed, Init, Loadи RenderPreRender.
| Event | Описание |
|---|---|
| ItemCommand | Происходит при нажатии кнопки в элементе DetailsView управления. |
| ItemCreated | Происходит после создания всех DetailsViewRow объектов в элементе DetailsView управления. Это событие часто используется для изменения значений записи перед отображением. |
| ItemDeleted | Происходит при нажатии кнопки "Удалить", но после DetailsView удаления записи из источника данных элемент управления. Это событие часто используется для проверки результатов операции удаления. |
| ItemDeleting | Происходит при нажатии кнопки "Удалить", но перед DetailsView удалением записи из источника данных элемент управления. Это событие часто используется для отмены операции удаления. |
| ItemInserted | Происходит при нажатии кнопки вставки, но после DetailsView вставки записи элемент управления. Это событие часто используется для проверки результатов операции вставки. |
| ItemInserting | Происходит при нажатии кнопки "Вставка", но перед DetailsView вставкам записи элементом управления. Это событие часто используется для отмены операции вставки. |
| ItemUpdated | Происходит при нажатии кнопки "Обновить", но после DetailsView обновления строки элемент управления. Это событие часто используется для проверки результатов операции обновления. |
| ItemUpdating | Происходит при нажатии кнопки "Обновить", но перед обновлением DetailsView записи элементом управления. Это событие часто используется для отмены операции обновления. |
| ModeChanged | Происходит после режима изменения элемента управления (режим редактирования DetailsView , вставки или режима только для чтения). Это событие часто используется для выполнения задачи при DetailsView изменении режима управления. |
| ModeChanging | Происходит перед режимами изменений элемента управления (режим редактирования DetailsView , вставки или только для чтения). Это событие часто используется для отмены изменения режима. |
| PageIndexChanged | Происходит при нажатии одной из кнопок пейджера, но после DetailsView того, как элемент управления обрабатывает операцию разбиения по страницам. Это событие обычно используется, когда необходимо выполнить задачу после перехода пользователя к другой записи в элементе управления. |
| PageIndexChanging | Происходит при нажатии одной из кнопок пейджера, но перед тем, как DetailsView элемент управления обрабатывает операцию разбиения по страницам. Это событие часто используется для отмены операции разбиения по страницам. |
Доступность
Сведения о настройке этого элемента управления таким образом, чтобы он создавал разметку, соответствующую стандартам специальных возможностей, см. в разделе "Специальные возможности" в Visual Studio и ASP.NET и ASP.NET элементы управления и специальные возможности.
Декларативный синтаксис
<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>
Конструкторы
| Имя | Описание |
|---|---|
| DetailsView() |
Инициализирует новый экземпляр класса DetailsView. |
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Возвращает или задает ключ доступа, позволяющий быстро перейти к элементу управления веб-сервера. (Унаследовано от WebControl) |
| Adapter |
Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control) |
| AllowPaging |
Возвращает или задает значение, указывающее, включена ли функция разбиения по страницам. |
| AlternatingRowStyle |
Получает ссылку на TableItemStyle объект, позволяющий задать внешний вид чередующихся строк данных в элементе DetailsView управления. |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control) |
| Attributes |
Возвращает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
| AutoGenerateDeleteButton |
Возвращает или задает значение, указывающее, отображается ли встроенный элемент управления для удаления текущей записи в элементе DetailsView управления. |
| AutoGenerateEditButton |
Возвращает или задает значение, указывающее, отображаются ли встроенные элементы управления для изменения текущей записи в элементе DetailsView управления. |
| AutoGenerateInsertButton |
Возвращает или задает значение, указывающее, отображаются ли встроенные элементы управления для вставки новой записи в DetailsView элемент управления. |
| AutoGenerateRows |
Возвращает или задает значение, указывающее, создаются ли поля строк для каждого поля в источнике данных автоматически и отображаются в элементе DetailsView управления. |
| BackColor |
Возвращает или задает цвет фона элемента управления веб-сервера. (Унаследовано от WebControl) |
| BackImageUrl |
Возвращает или задает URL-адрес изображения, отображаемого в фоновом режиме DetailsView элемента управления. |
| BindingContainer |
Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control) |
| BorderColor |
Возвращает или задает цвет границы веб-элемента управления. (Унаследовано от WebControl) |
| BorderStyle |
Возвращает или задает стиль границы элемента управления веб-сервера. (Унаследовано от WebControl) |
| BorderWidth |
Возвращает или задает ширину границы элемента управления веб-сервера. (Унаследовано от WebControl) |
| BottomPagerRow |
Возвращает объект, представляющий строку нижнего пейджера DetailsViewRow в элементе DetailsView управления. |
| Caption |
Получает или задает текст для отрисовки в элементе заголовка HTML в элементе DetailsView управления. Это свойство предоставляется, чтобы сделать элемент управления более доступным для пользователей вспомогательных технологических устройств. |
| CaptionAlign |
Возвращает или задает горизонтальное или вертикальное положение элемента заголовка HTML в элементе DetailsView управления. Это свойство предоставляется, чтобы сделать элемент управления более доступным для пользователей вспомогательных технологических устройств. |
| CellPadding |
Возвращает или задает объем пространства между содержимым ячейки и границей ячейки. |
| CellSpacing |
Возвращает или задает объем пространства между ячейками. |
| ChildControlsCreated |
Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control) |
| ClientID |
Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения ClientID свойства. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control) |
| CommandRowStyle |
Получает ссылку на TableItemStyle объект, позволяющий задать внешний вид командной строки в элементе DetailsView управления. |
| Context |
HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
Возвращает коллекцию дочерних элементов управления в составном элементе управления с привязкой к данным. (Унаследовано от CompositeDataBoundControl) |
| ControlStyle |
Возвращает стиль элемента управления веб-сервера. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| ControlStyleCreated |
Возвращает значение, указывающее, был ли Style объект создан для ControlStyle свойства. Это свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
| CssClass |
Возвращает или задает класс каскадной таблицы стилей (CSS), отображаемый элементом управления веб-сервера на клиенте. (Унаследовано от WebControl) |
| CurrentMode |
Возвращает текущий режим DetailsView ввода данных элемента управления. |
| DataItem |
Возвращает элемент данных, привязанный к элементу DetailsView управления. |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control) |
| DataItemCount |
Возвращает количество элементов в базовом источнике данных. |
| DataItemIndex |
Возвращает индекс элемента, отображаемого в элементе DetailsView управления из базового источника данных. |
| DataKey |
DataKey Возвращает объект, представляющий первичный ключ отображаемой записи. |
| DataKeyNames |
Возвращает или задает массив, содержащий имена ключевых полей источника данных. |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control) |
| DataMember |
Возвращает или задает имя списка данных, к которым привязывается элемент управления с привязкой к данным, в случаях, когда источник данных содержит несколько отдельных списков элементов данных. (Унаследовано от DataBoundControl) |
| DataSource |
Возвращает или задает объект, из которого элемент управления с привязкой к данным извлекает список элементов данных. (Унаследовано от BaseDataBoundControl) |
| DataSourceID |
Возвращает или задает идентификатор элемента управления, из которого элемент управления с привязкой к данным получает список элементов данных. (Унаследовано от DataBoundControl) |
| DataSourceObject |
Возвращает объект, реализующий IDataSource интерфейс, который предоставляет доступ к содержимому данных объекта. (Унаследовано от DataBoundControl) |
| DefaultMode |
Получение или установка режима записи данных по умолчанию элемента DetailsView управления. |
| DeleteMethod |
Возвращает или задает имя метода на странице, вызываемой при выполнении элемента управления операции удаления. |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control) |
| EditRowStyle |
Получает ссылку на TableItemStyle объект, который позволяет задать внешний вид строк данных, когда DetailsView элемент управления находится в режиме редактирования. |
| EmptyDataRowStyle |
Возвращает ссылку на TableItemStyle объект, позволяющий задать внешний вид пустой строки данных, отображаемой при привязке источника данных к элементу DetailsView управления, не содержит записей. |
| EmptyDataTemplate |
Возвращает или задает определяемое пользователем содержимое для пустой строки данных, отображаемой при DetailsView привязке элемента управления к источнику данных, который не содержит записей. |
| EmptyDataText |
Возвращает или задает текст для отображения в пустой строке данных, отображаемой при DetailsView привязке элемента управления к источнику данных, который не содержит записей. |
| Enabled |
Возвращает или задает значение, указывающее, включен ли элемент управления веб-сервера. (Унаследовано от WebControl) |
| EnableModelValidation |
Возвращает или задает значение, указывающее, включена ли проверка модели данных. |
| EnablePagingCallbacks |
Возвращает или задает значение, указывающее, используются ли функции обратного вызова на стороне клиента для разбиения по страницам в элементе DetailsView управления. |
| EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
| EnableViewState |
Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| FieldHeaderStyle |
Получает ссылку на TableItemStyle объект, позволяющий задать внешний вид столбца заголовка в элементе DetailsView управления. |
| Fields |
Возвращает коллекцию DataControlField объектов, представляющих явно объявленные поля строк в элементе DetailsView управления. |
| Font |
Возвращает свойства шрифта, связанные с элементом управления веб-сервера. (Унаследовано от WebControl) |
| FooterRow |
DetailsViewRow Возвращает объект, представляющий строку нижнего колонтитула в элементе DetailsView управления. |
| FooterStyle |
Получает ссылку на TableItemStyle объект, позволяющий задать внешний вид строки нижнего колонтитула в элементе DetailsView управления. |
| FooterTemplate |
Возвращает или задает определяемое пользователем содержимое для строки нижнего колонтитула в элементе DetailsView управления. |
| FooterText |
Возвращает или задает текст, отображаемый в строке нижнего DetailsView колонтитула элемента управления. |
| ForeColor |
Возвращает или задает цвет переднего плана (обычно цвет текста) элемента управления веб-сервера. (Унаследовано от WebControl) |
| GridLines |
Возвращает или задает стиль линии сетки DetailsView для элемента управления. |
| HasAttributes |
Возвращает значение, указывающее, имеет ли элемент управления набор атрибутов. (Унаследовано от WebControl) |
| HasChildViewState |
Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control) |
| HeaderRow |
DetailsViewRow Возвращает объект, представляющий строку заголовка в элементе DetailsView управления. |
| HeaderStyle |
Получает ссылку на TableItemStyle объект, позволяющий задать внешний вид строки заголовка в элементе DetailsView управления. |
| HeaderTemplate |
Возвращает или задает определяемое пользователем содержимое для строки заголовка в элементе DetailsView управления. |
| HeaderText |
Возвращает или задает текст, отображаемый в строке заголовка DetailsView элемента управления. |
| Height |
Возвращает или задает высоту элемента управления веб-сервера. (Унаследовано от WebControl) |
| HorizontalAlign |
Возвращает или задает горизонтальное выравнивание DetailsView элемента управления на странице. |
| ID |
Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control) |
| Initialized |
Возвращает значение, указывающее, был ли инициализирован элемент управления с привязкой к данным. (Унаследовано от BaseDataBoundControl) |
| InsertMethod |
Возвращает или задает имя метода на странице, вызываемой при выполнении элемента управления операции вставки. |
| InsertRowStyle |
Получает ссылку на TableItemStyle объект, который позволяет задать внешний вид строк данных в элементе DetailsView управления, когда DetailsView элемент управления находится в режиме вставки. |
| IsBoundUsingDataSourceID |
Возвращает значение, указывающее, задано ли DataSourceID свойство. (Унаследовано от BaseDataBoundControl) |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control) |
| IsDataBindingAutomatic |
Возвращает значение, указывающее, является ли привязка данных автоматической. (Унаследовано от BaseDataBoundControl) |
| IsEnabled |
Возвращает значение, указывающее, включен ли элемент управления. (Унаследовано от WebControl) |
| IsTrackingViewState |
Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control) |
| IsUsingModelBinders |
Возвращает значение, указывающее, используется ли привязка модели. (Унаследовано от CompositeDataBoundControl) |
| IsViewStateEnabled |
Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| ItemType |
Возвращает или задает имя типа элемента данных для строго типизированной привязки данных. (Унаследовано от DataBoundControl) |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control) |
| NamingContainer |
Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control) |
| Page |
Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control) |
| PageCount |
Возвращает количество записей в источнике данных. |
| PageIndex |
Возвращает или задает индекс отображаемой записи. |
| PagerSettings |
Возвращает ссылку на PagerSettings объект, позволяющий задать свойства кнопок пейджера в элементе DetailsView управления. |
| PagerStyle |
Получает ссылку на TableItemStyle объект, позволяющий задать внешний вид строки пейджера в элементе DetailsView управления. |
| PagerTemplate |
Возвращает или задает настраиваемое содержимое для строки пейджера в элементе DetailsView управления. |
| Parent |
Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control) |
| RenderingCompatibility |
Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control) |
| RequiresDataBinding |
Возвращает или задает значение, указывающее, следует ли DataBind() вызывать метод. (Унаследовано от BaseDataBoundControl) |
| Rows |
Возвращает коллекцию DetailsViewRow объектов, представляющих строки данных в элементе DetailsView управления. |
| RowsGenerator |
Возвращает или задает объект, реализующий IAutoFieldGenerator интерфейс, чтобы автоматически заполнять строки в представлении. |
| RowStyle |
Получает ссылку на TableItemStyle объект, позволяющий задать внешний вид строк данных в элементе DetailsView управления. |
| SelectArguments |
DataSourceSelectArguments Возвращает объект, который элемент управления, привязанный к данным, используется при получении данных из элемента управления источниками данных. (Унаследовано от DataBoundControl) |
| SelectedValue |
Возвращает значение ключа данных текущей записи в элементе DetailsView управления. |
| SelectMethod |
Имя метода, вызываемого для чтения данных. (Унаследовано от DataBoundControl) |
| Site |
Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от WebControl) |
| Style |
Возвращает коллекцию текстовых атрибутов, которые будут отображаться как атрибут стиля во внешнем теге элемента управления веб-сервера. (Унаследовано от WebControl) |
| SupportsDisabledAttribute |
Возвращает значение, указывающее, должен ли элемент управления задать |
| TabIndex |
Возвращает или задает индекс табуляции элемента управления веб-сервера. (Унаследовано от WebControl) |
| TagKey |
HtmlTextWriterTag Возвращает значение элемента DetailsView управления. |
| TagName |
Возвращает имя тега элемента управления. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| ToolTip |
Возвращает или задает текст, отображаемый при наведении указателя мыши на элемент управления веб-сервера. (Унаследовано от WebControl) |
| TopPagerRow |
Возвращает объект, представляющий строку верхнего пейджера DetailsViewRow в элементе DetailsView управления. |
| UniqueID |
Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control) |
| UpdateMethod |
Возвращает или задает имя метода на странице, вызываемой при выполнении элемента управления операции обновления. |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control) |
| ViewState |
Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control) |
| Visible |
Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде пользовательского интерфейса на странице. (Унаследовано от Control) |
| Width |
Возвращает или задает ширину элемента управления веб-сервера. (Унаследовано от WebControl) |
Методы
| Имя | Описание |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Добавляет атрибуты и стили HTML, которые должны быть отрисованы в указанные HtmlTextWriterTag. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control) |
| ApplyStyle(Style) |
Копирует все небланковые элементы указанного стиля в веб-элемент управления, перезаписыв все существующие элементы стиля элемента управления. Этот метод в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| BeginRenderTracing(TextWriter, Object) |
Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control) |
| ChangeMode(DetailsViewMode) |
Переключает DetailsView элемент управления в указанный режим. |
| ClearCachedClientID() |
Задает кэшированное ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control) |
| ConfirmInitState() |
Задает инициализированное состояние элемента управления, привязанного к данным. (Унаследовано от BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Копирует свойства, не инкапсулированные Style объектом из указанного элемента управления веб-сервера, в элемент управления веб-сервера, из который вызывается этот метод. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateAutoGeneratedRow(AutoGeneratedFieldProperties) |
AutoGeneratedField Создает объект, представляющий автоматически созданное поле строки с помощью указанных свойств поля. |
| CreateAutoGeneratedRows(Object) |
Создает набор автоматически созданных полей строк для указанного элемента данных. |
| CreateChildControls() |
Создает иерархию элементов управления, которая используется для отрисовки составного элемента управления, привязанного к данным, на основе значений, хранящихся в состоянии представления. (Унаследовано от CompositeDataBoundControl) |
| CreateChildControls(IEnumerable, Boolean) |
Создает иерархию элементов управления, используемую для отрисовки DetailsView элемента управления. |
| CreateControlCollection() |
Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от Control) |
| CreateControlStyle() |
Создает объект стиля таблицы по умолчанию для DetailsView элемента управления. |
| CreateDataSourceSelectArguments() |
DataSourceSelectArguments Создает объект, который передается команде Select. |
| CreateFieldSet(Object, Boolean) |
Создает полный набор автоматически созданных и определяемых пользователем полей строк, используемых для создания иерархии элементов управления. |
| CreateRow(Int32, DataControlRowType, DataControlRowState) |
DetailsViewRow Создает объект с помощью указанного индекса элемента, типа строки и состояния строки. |
| CreateTable() |
Создает содержащую таблицу для DetailsView элемента управления. |
| DataBind() |
DataBind() Вызывает метод базового класса. |
| DataBind(Boolean) |
Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control) |
| DeleteItem() |
Удаляет текущую запись из источника данных. |
| Dispose() |
Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control) |
| EnsureDataBound() |
DataBind() Вызывает метод после проверки того, что элемент управления перечислением данных требует привязки данных и указан допустимый элемент управления версиями данных. |
| EnsureID() |
Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| ExtractRowValues(IOrderedDictionary, Boolean, Boolean) |
Извлекает значения каждого поля, отображаемого и сохраняет их в указанном IOrderedDictionary объекте. |
| FindControl(String, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| Focus() |
Задает фокус ввода элементу управления. (Унаследовано от Control) |
| GetCallbackResult() |
Возвращает результат события обратного вызова, предназначенного для элемента управления. |
| GetCallbackScript(IButtonControl, String) |
Возвращает строку обратного вызова, созданную с помощью указанного аргумента. |
| GetData() |
Извлекает DataSourceView объект, который элемент управления с привязкой к данным использует для выполнения операций с данными. (Унаследовано от DataBoundControl) |
| GetDataSource() |
Извлекает IDataSource интерфейс, с которым связан элемент управления с привязкой к данным, если таковой имеется. (Унаследовано от DataBoundControl) |
| GetDesignModeState() |
Возвращает данные во время разработки для элемента управления. (Унаследовано от Control) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetRouteUrl(Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, Object) |
Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetUniqueIDRelativeTo(Control) |
Возвращает префиксированную часть UniqueID свойства указанного элемента управления. (Унаследовано от Control) |
| HasControls() |
Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от Control) |
| HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control) |
| InitializePager(DetailsViewRow, PagedDataSource) |
Создает строку пейджера DetailsView для элемента управления. |
| InitializeRow(DetailsViewRow, DataControlField) |
Инициализирует указанный DetailsViewRow объект. |
| InsertItem(Boolean) |
Вставляет текущую запись в источник данных. |
| IsBindableType(Type) |
Определяет, может ли указанный тип данных быть привязан к полю в элементе DetailsView управления. |
| IsLiteralContent() |
Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control) |
| LoadControlState(Object) |
Загружает состояние свойств в элементе DetailsView управления, которое необходимо сохранить, даже если EnableViewState для свойства задано |
| LoadViewState(Object) |
Загружает ранее сохраненное состояние DetailsView представления элемента управления. |
| MapPathSecure(String) |
Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control) |
| MarkAsDataBound() |
Задает состояние элемента управления в состоянии представления как успешно привязанное к данным. (Унаследовано от DataBoundControl) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MergeStyle(Style) |
Копирует все небланковые элементы указанного стиля в веб-элемент управления, но не перезаписывает существующие элементы стиля элемента управления. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие для элемента управления веб-сервером иерархии пользовательского интерфейса страницы. |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Вызывает событие CreatingModelDataSource. (Унаследовано от DataBoundControl) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnDataBound(EventArgs) |
Вызывает событие DataBound. (Унаследовано от BaseDataBoundControl) |
| OnDataPropertyChanged() |
Повторно привязывает элемент управления, привязанный к данным, после изменения одного из свойств идентификации источника данных базы данных. (Унаследовано от DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Вызывает событие DataSourceViewChanged. |
| OnInit(EventArgs) |
Вызывает событие Init. |
| OnItemCommand(DetailsViewCommandEventArgs) |
Вызывает событие ItemCommand. |
| OnItemCreated(EventArgs) |
Вызывает событие ItemCreated. |
| OnItemDeleted(DetailsViewDeletedEventArgs) |
Вызывает событие ItemDeleted. |
| OnItemDeleting(DetailsViewDeleteEventArgs) |
Вызывает событие ItemDeleting. |
| OnItemInserted(DetailsViewInsertedEventArgs) |
Вызывает событие ItemInserted. |
| OnItemInserting(DetailsViewInsertEventArgs) |
Вызывает событие ItemInserting. |
| OnItemUpdated(DetailsViewUpdatedEventArgs) |
Вызывает событие ItemUpdated. |
| OnItemUpdating(DetailsViewUpdateEventArgs) |
Вызывает событие ItemUpdating. |
| OnLoad(EventArgs) |
Load Обрабатывает событие. (Унаследовано от DataBoundControl) |
| OnModeChanged(EventArgs) |
Вызывает событие ModeChanged. |
| OnModeChanging(DetailsViewModeEventArgs) |
Вызывает событие ModeChanging. |
| OnPageIndexChanged(EventArgs) |
Вызывает событие PageIndexChanged. |
| OnPageIndexChanging(DetailsViewPageEventArgs) |
Вызывает событие PageIndexChanging. |
| OnPagePreLoad(Object, EventArgs) |
Задает инициализированное состояние элемента управления, привязанного к данным, перед загрузкой элемента управления. |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает используемый Stream для чтения файла. (Унаследовано от Control) |
| PerformDataBinding(IEnumerable) |
Привязывает указанный источник данных к элементу DetailsView управления. |
| PerformSelect() |
Извлекает данные из связанного источника данных. (Унаследовано от DataBoundControl) |
| PrepareControlHierarchy() |
Настраивает иерархию DetailsView элементов управления элемента управления. |
| RaiseBubbleEvent(Object, EventArgs) |
Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control) |
| RaiseCallbackEvent(String) |
Создает аргументы для обработчика обратного вызова в методе GetCallbackEventReference . |
| RaisePostBackEvent(String) |
Вызывает соответствующие события для элемента управления при обратной DetailsView отправке на сервер. |
| RemovedControl(Control) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
DetailsView Отображает элемент управления на клиенте с помощью указанного HtmlTextWriter объекта. |
| RenderBeginTag(HtmlTextWriter) |
Отрисовывает HTML-тег открывающего элемента управления указанному средству записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderContents(HtmlTextWriter) |
Отрисовывает содержимое элемента управления указанному средству записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderEndTag(HtmlTextWriter) |
Отрисовывает html-закрывающий тег элемента управления в указанный модуль записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет состояние свойств в DetailsView элементе управления, которое необходимо сохранить, даже если EnableViewState для свойства задано значение |
| SaveViewState() |
Сохраняет текущее состояние DetailsView представления элемента управления. |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetPageIndex(Int32) |
Задает индекс отображаемой в данный момент страницы в элементе DetailsView управления. |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Помечает начальную точку, чтобы начать отслеживание и сохранение изменений состояния представления в элементе DetailsView управления. |
| UpdateItem(Boolean) |
Обновляет текущую запись в источнике данных. |
| ValidateDataSource(Object) |
Проверяет, что объект, к которому привязан элемент управления, привязанный к данным, является тем, с которым он может работать. (Унаследовано от DataBoundControl) |
События
| Имя | Описание |
|---|---|
| CallingDataMethods |
Происходит при вызове методов данных. (Унаследовано от DataBoundControl) |
| CreatingModelDataSource |
Происходит при ModelDataSource создании объекта. (Унаследовано от DataBoundControl) |
| DataBinding |
Происходит, когда серверный элемент управления привязывается к источнику данных. (Унаследовано от Control) |
| DataBound |
Происходит после привязки серверного элемента управления к источнику данных. (Унаследовано от BaseDataBoundControl) |
| Disposed |
Происходит при освобождении серверного элемента управления из памяти, который является последним этапом жизненного цикла управления сервера при запросе страницы ASP.NET. (Унаследовано от Control) |
| Init |
Происходит при инициализации серверного элемента управления, который является первым шагом в его жизненном цикле. (Унаследовано от Control) |
| ItemCommand |
Происходит при нажатии кнопки в элементе DetailsView управления. |
| ItemCreated |
Происходит при создании записи в элементе DetailsView управления. |
| ItemDeleted |
Происходит при нажатии кнопки "Удалить" в элементе DetailsView управления, но после операции удаления. |
| ItemDeleting |
Происходит при нажатии кнопки "Удалить" в элементе DetailsView управления, но перед операцией удаления. |
| ItemInserted |
Происходит при нажатии кнопки вставки в DetailsView элементе управления, но после операции вставки. |
| ItemInserting |
Происходит при нажатии кнопки "Вставка" в DetailsView элементе управления, но перед операцией вставки. |
| ItemUpdated |
Происходит при нажатии кнопки "Обновить" в элементе DetailsView управления, но после операции обновления. |
| ItemUpdating |
Происходит при нажатии кнопки "Обновить" в элементе DetailsView управления, но перед операцией обновления. |
| Load |
Происходит при загрузке серверного элемента управления в Page объект. (Унаследовано от Control) |
| ModeChanged |
Происходит, когда DetailsView элемент управления пытается изменить режим редактирования, вставки и только для чтения, но после CurrentMode обновления свойства. |
| ModeChanging |
Происходит, когда DetailsView элемент управления пытается изменить режим редактирования, вставки и только для чтения, но перед обновлением CurrentMode свойства. |
| PageIndexChanged |
Происходит, когда значение PageIndex свойства изменяется после операции разбиения по страницам. |
| PageIndexChanging |
Происходит при изменении значения PageIndex свойства перед операцией разбиения по страницам. |
| PreRender |
Происходит после Control загрузки объекта, но до отрисовки. (Унаследовано от Control) |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
Методы расширения
| Имя | Описание |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnablePersistedSelection(BaseDataBoundControl) |
Устаревшие..
Позволяет сохранять выбор в элементах управления данными, поддерживающих выбор и разбиение по страницам. |
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными для указанного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для указанного столбца в контейнере именования указанного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатабли для содержащего элемента управления данными. |
| GetDefaultValues(INamingContainer) |
Возвращает коллекцию значений по умолчанию для указанного элемента управления данными. |
| GetMetaTable(INamingContainer) |
Возвращает метаданные таблицы для указанного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable) |
Задает метаданные таблицы для указанного элемента управления данными. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Определяет, доступны ли метаданные таблицы. |
Применяется к
См. также раздел
- IsPrimitive
- AccessDataSource
- AllowPaging
- AutoGenerateRows
- AutoGenerateDeleteButton
- AutoGenerateEditButton
- AutoGenerateInsertButton
- Fields
- Rows
- BoundField
- ButtonField
- CommandField
- CheckBoxField
- GridView
- HyperLinkField
- SqlDataSource
- TemplateField
- Использование параметров с элементами управления источниками данных
