DetailsView.DataItem Property
Gets the data item bound to the DetailsView control.
Assembly: System.Web (in System.Web.dll)
Property Value
Type: System.ObjectAn Object that represents the data item bound to the DetailsView control.
Implements
IDataItemContainer.DataItemUse the DataItem property to access the data item bound to the DetailsView control. The data item is often used to access the field values of the current record directly. The type of the Object returned by this property varies depending on the data source. For example, when a SqlDataSource control is bound to the DetailsView control, a DataRowView object is returned.
Note |
|---|
This property is available only after data binding has occurred. Before data binding occurs, this property returns null. This property is also not applicable when the DetailsView control is in insert mode and returns null. |
The following code example demonstrates how to use the DataItem property to determine the value of a field in the data item.
<%@ Page language="VB" %> <%@ import namespace="System.Data"%> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> Protected Sub CustomerDetailView_DataBound( _ ByVal sender As Object, ByVal e As EventArgs) Dim rowView As DataRowView = _ CType(CustomerDetailView.DataItem, DataRowView) If rowView.Row(0).ToString() = "SpecialID" Then CustomerDetailView.FieldHeaderStyle.BackColor = _ System.Drawing.Color.Red End If End Sub </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>DetailsView ModeChanging Example</title> </head> <body> <form id="Form1" runat="server"> <h3>DetailsView ModeChanging Example</h3> <asp:detailsview id="CustomerDetailView" datasourceid="DetailsViewSource" datakeynames="CustomerID" autogeneraterows="true" autogenerateeditbutton="true" OnDataBound="CustomerDetailView_DataBound" allowpaging="true" runat="server"> <fieldheaderstyle backcolor="Navy" forecolor="White"/> </asp:detailsview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the web.config file. --> <asp:SqlDataSource ID="DetailsViewSource" runat="server" ConnectionString= "<%$ ConnectionStrings:NorthWindConnectionString%>" InsertCommand="INSERT INTO [Customers]([CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName, @Address, @City, @PostalCode, @Country)" SelectCommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"> </asp:SqlDataSource> </form> </body> </html>
Available since 2.0
