ListView.Items Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtém uma coleção de objetos ListViewDataItem que representam os itens de dados da página de dados atual em um controle ListView.

public:
 virtual property System::Collections::Generic::IList<System::Web::UI::WebControls::ListViewDataItem ^> ^ Items { System::Collections::Generic::IList<System::Web::UI::WebControls::ListViewDataItem ^> ^ get(); };

[System.ComponentModel.Browsable(false)]
public virtual System.Collections.Generic.IList<System.Web.UI.WebControls.ListViewDataItem> Items { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Items : System.Collections.Generic.IList<System.Web.UI.WebControls.ListViewDataItem>

Public Overridable ReadOnly Property Items As IList(Of ListViewDataItem)

Valor da propriedade

IList<ListViewDataItem>

Um objeto que contém todos os itens de dados da página atual de dados em um controle ListView.

Atributos

BrowsableAttribute

Exemplos

O exemplo a seguir mostra como usar a Items coleção para acessar o item que está sendo editado em um ListView controle. Este exemplo de código faz parte de um exemplo maior fornecido para o ItemEditing evento.

void ProductsListView_ItemEditing(Object sender, ListViewEditEventArgs e)
{
  ListViewItem item = ProductsListView.Items[e.NewEditIndex];
  Label dateLabel = (Label)item.FindControl("DiscontinuedDateLabel");
  
  if (String.IsNullOrEmpty(dateLabel.Text))
    return;
  
  //Verify if the item is discontinued.
  DateTime discontinuedDate = DateTime.Parse(dateLabel.Text);
  if (discontinuedDate < DateTime.Now)
  {
    Message.Text = "You cannot edit a discontinued item.";
    e.Cancel = true;
    ProductsListView.SelectedIndex = -1;
  }       
}

Sub ProductsListView_ItemEditing(ByVal sender As Object, ByVal e As ListViewEditEventArgs)
  Dim item As ListViewItem = ProductsListView.Items(e.NewEditIndex)
  Dim dateLabel As Label = CType(item.FindControl("DiscontinuedDateLabel"), Label)
    
  If String.IsNullOrEmpty(dateLabel.Text) Then _
    Return
    
  'Verify if the item is discontinued.
  Dim discontinuedDate As DateTime = DateTime.Parse(dateLabel.Text)
  If discontinuedDate < DateTime.Now Then
    Message.Text = "You cannot edit a discontinued item."
    e.Cancel = True
    ProductsListView.SelectedIndex = -1
  End If
End Sub

Comentários

A Items propriedade é usada para armazenar os itens de dados em um ListView controle . O ListView controle preenche automaticamente a Items coleção criando um ListViewDataItem objeto para cada registro na página atual de dados na fonte de dados. Em seguida, ele adiciona cada objeto à coleção. Essa propriedade geralmente é usada para acessar um item específico no controle ou para iterar por meio da coleção completa de itens.

Confira também

• ListViewDataItem
• ListViewItem
• DataPager
• Controle de servidor Web ListView