DetailsView.DataItem Propriedade
Definição
Obtém o item de dados associado ao controle DetailsView.Gets the data item bound to the DetailsView control.
public:
virtual property System::Object ^ DataItem { System::Object ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual object DataItem { get; }
[<System.ComponentModel.Browsable(false)>]
member this.DataItem : obj
Public Overridable ReadOnly Property DataItem As Object
Valor da propriedade
Um Object que representa o item de dados associado ao controle DetailsView.An Object that represents the data item bound to the DetailsView control.
Implementações
- Atributos
Exemplos
O exemplo de código a seguir demonstra como usar a DataItem propriedade para determinar o valor de um campo no item de dados.The following code example demonstrates how to use the DataItem property to determine the value of a field in the data item.
<%@ Page language="C#" %>
<%@ 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 void CustomerDetailView_DataBound(object sender,
EventArgs e)
{
DataRowView rowView = (DataRowView)CustomerDetailView.DataItem;
if (rowView.Row[0].ToString() == "SpecialID")
{
CustomerDetailView.FieldHeaderStyle.BackColor =
System.Drawing.Color.Red;
}
}
</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>
<%@ 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>
Comentários
Use a DataItem propriedade para acessar o item de dados associado ao DetailsView controle.Use the DataItem property to access the data item bound to the DetailsView control. O item de dados geralmente é usado para acessar diretamente os valores de campo do registro atual.The data item is often used to access the field values of the current record directly. O tipo do Object retornado por essa propriedade varia dependendo da fonte de dados.The type of the Object returned by this property varies depending on the data source. Por exemplo, quando um SqlDataSource controle está associado ao DetailsView controle, um DataRowView objeto é retornado.For example, when a SqlDataSource control is bound to the DetailsView control, a DataRowView object is returned.
Observação
Essa propriedade só estará disponível após a ocorrência da vinculação de dados.This property is available only after data binding has occurred. Antes que a vinculação de dados ocorra, essa propriedade retorna null .Before data binding occurs, this property returns null. Essa propriedade também não é aplicável quando o DetailsView controle está no modo de inserção e retorna null .This property is also not applicable when the DetailsView control is in insert mode and returns null.