ListView.Items Propriété

Définition

Obtient une collection d'objets ListViewDataItem qui représentent les éléments de données de la page de données actuelle dans un contrôle 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)

Valeur de propriété

Un objet qui contient tous les éléments de données de la page de données actuelle dans un contrôle ListView.

Attributs

Exemples

L’exemple suivant montre comment utiliser la Items collection pour accéder à l’élément en cours de modification dans un ListView contrôle. Cet exemple de code fait partie d’un exemple plus grand fourni pour l’événement ItemEditing .

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

Remarques

La Items propriété est utilisée pour stocker les éléments de données dans un ListView contrôle. Le ListView contrôle remplit automatiquement la Items collection en créant un ListViewDataItem objet pour chaque enregistrement dans la page de données active de la source de données. Il ajoute ensuite chaque objet à la collection. Cette propriété est généralement utilisée pour accéder à un élément spécifique dans le contrôle ou pour itérer à l’ensemble de la collection d’éléments.

S’applique à

Voir aussi