Partilhar via


ListView.Items Propriedade

Definição

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

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 ListView controle.

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 dos dados na fonte de dados. Em seguida, adiciona cada objeto à coleção. Essa propriedade geralmente é usada para acessar um item específico no controle ou para iterar a coleção completa de itens.

Aplica-se a

Confira também