Partilhar via


ListView.Items Propriedade

Definição

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

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

Atributos

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.

Aplica-se a

Confira também