ListView.Items Właściwość

Definicja

Pobiera kolekcję ListViewDataItem obiektów reprezentujących elementy danych bieżącej strony danych w ListView kontrolce.Gets a collection of ListViewDataItem objects that represent the data items of the current page of data in a ListView control.

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)

Wartość właściwości

IList<ListViewDataItem>

Obiekt, który zawiera wszystkie elementy danych bieżącej strony danych w ListView kontrolce.An object that contains all the data items of the current page of data in a ListView control.

Atrybuty

Przykłady

Poniższy przykład pokazuje, jak używać kolekcji w Items celu uzyskania dostępu do elementu, który jest edytowany w ListView kontrolce.The following example shows how to use the Items collection to access the item that is being edited in a ListView control. Ten przykład kodu jest częścią większego przykładu dostarczonego dla ItemEditing zdarzenia.This code example is part of a larger example provided for the ItemEditing event.

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

Uwagi

ItemsWłaściwość służy do przechowywania elementów danych w ListView formancie.The Items property is used to store the data items in a ListView control. ListViewFormant automatycznie wypełnia Items kolekcję, tworząc jeden ListViewDataItem obiekt dla każdego rekordu na bieżącej stronie danych w źródle danych.The ListView control automatically populates the Items collection by creating one ListViewDataItem object for each record in the current page of data in the data source. Następnie dodaje każdy obiekt do kolekcji.It then adds each object to the collection. Ta właściwość jest zazwyczaj używana do uzyskiwania dostępu do określonego elementu w formancie lub do iteracji, chociaż kompletna Kolekcja elementów.This property is usually used to access a specific item in the control or to iterate though the complete collection of items.

Dotyczy

Zobacz też