Freigeben über


ListView.Items Eigenschaft

Definition

Ruft eine Auflistung von ListViewDataItem-Objekten ab, die die Datenelemente der aktuellen Datenseite in einem ListView-Steuerelement darstellen.

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)

Eigenschaftswert

Ein Objekt, das alle Datenelemente der aktuellen Datenseite in einem ListView-Steuerelement enthält.

Attribute

Beispiele

Das folgende Beispiel zeigt, wie Sie mithilfe der Items Auflistung auf das Element zugreifen, das in einem ListView Steuerelement bearbeitet wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für das ItemEditing Ereignis bereitgestellt wird.

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

Hinweise

Die Items -Eigenschaft wird verwendet, um die Datenelemente in einem ListView Steuerelement zu speichern. Das ListView Steuerelement füllt die Items Auflistung automatisch auf, indem es ein ListViewDataItem Objekt für jeden Datensatz auf der aktuellen Datenseite in der Datenquelle erstellt. Anschließend wird jedes Objekt der Auflistung hinzugefügt. Diese Eigenschaft wird normalerweise verwendet, um auf ein bestimmtes Element im Steuerelement zuzugreifen oder die vollständige Auflistung von Elementen zu durchlaufen.

Gilt für:

Weitere Informationen