ListView.Items Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

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

IList<ListViewDataItem>

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

Attribute

BrowsableAttribute

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 für das ItemEditing Ereignis.

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 ein ListViewDataItem -Objekt für jeden Datensatz auf der aktuellen Datenseite in der Datenquelle erstellt wird. Anschließend wird jedes Objekt der Auflistung hinzugefügt. Diese Eigenschaft wird in der Regel verwendet, um auf ein bestimmtes Element im Steuerelement zuzugreifen oder die vollständige Auflistung von Elementen zu durchlaufen.

Weitere Informationen

• ListViewDataItem
• ListViewItem
• DataPager
• ListView-Webserversteuerelement