ListViewDataItem.DataItem Propriedade
Definição
Obtém ou define o objeto de dados subjacente ao qual o objeto ListViewItem está associado.Gets or sets the underlying data object that the ListViewItem object is bound to.
public:
virtual property System::Object ^ DataItem { System::Object ^ get(); void set(System::Object ^ value); };
public virtual object DataItem { get; set; }
public override object DataItem { get; set; }
member this.DataItem : obj with get, set
Public Overridable Property DataItem As Object
Public Overrides Property DataItem As Object
Valor da propriedade
O objeto de dados subjacente ao qual o objeto ListViewItem está associado.The underlying data object that the ListViewItem object is bound to.
Exemplos
O exemplo a seguir mostra como usar a DataItem propriedade para recuperar um valor de campo.The following example shows how to use the DataItem property to retrieve a field value. Em seguida, o valor é usado para selecionar previamente um item em um DropDownList controle que é exibido quando um item está no modo de edição.The value is then used to pre-select an item in a DropDownList control that is displayed when an item is in edit mode. Este exemplo de código faz parte de um exemplo maior que é fornecido para a ListViewDataItem classe.This code example is part of a larger example that is provided for the ListViewDataItem class.
protected void ContactsListView_ItemDataBound(object sender, ListViewItemEventArgs e)
{
//Verify there is an item being edited.
if (ContactsListView.EditIndex >= 0)
{
//Get the item object.
ListViewDataItem dataItem = (ListViewDataItem)e.Item;
// Check for an item in edit mode.
if (dataItem.DisplayIndex == ContactsListView.EditIndex)
{
// Preselect the DropDownList control with the Title value
// for the current item.
// Retrieve the underlying data item. In this example
// the underlying data item is a DataRowView object.
DataRowView rowView = (DataRowView)dataItem.DataItem;
// Retrieve the Title value for the current item.
String title = rowView["Title"].ToString();
// Retrieve the DropDownList control from the current row.
DropDownList list = (DropDownList)dataItem.FindControl("TitlesList");
// Find the ListItem object in the DropDownList control with the
// title value and select the item.
ListItem item = list.Items.FindByText(title);
list.SelectedIndex = list.Items.IndexOf(item);
}
}
}
Protected Sub ContactsListView_ItemDataBound(ByVal sender As Object, ByVal e As ListViewItemEventArgs)
'Verify there is an item being edited.
If ContactsListView.EditIndex >= 0 Then
'Get the item object.
Dim dataItem As ListViewDataItem = CType(e.Item, ListViewDataItem)
' Check for an item in edit mode.
If dataItem.DisplayIndex = ContactsListView.EditIndex Then
' Preselect the DropDownList control with the Title value
' for the current item.
' Retrieve the underlying data item. In this example
' the underlying data item is a DataRowView object.
Dim rowView As DataRowView = CType(dataItem.DataItem, DataRowView)
' Retrieve the Title value for the current item.
Dim title As String = rowView("Title").ToString()
' Retrieve the DropDownList control from the current row.
Dim list As DropDownList = CType(dataItem.FindControl("TitlesList"), DropDownList)
' Find the ListItem object in the DropDownList control with the
' title value and select the item.
Dim item As ListItem = list.Items.FindByText(title)
list.SelectedIndex = list.Items.IndexOf(item)
End If
End If
End Sub
Comentários
A DataItem propriedade está disponível somente durante e após o ItemDataBound evento de um ListView controle.The DataItem property is available only during and after the ItemDataBound event of a ListView control.