ListView.ListViewItemCollection ListView.ListViewItemCollection ListView.ListViewItemCollection ListView.ListViewItemCollection Class

Definition

Stellt die Auflistung von Elementen dar, die in einem ListView-Steuerelement enthalten oder einer ListViewGroup zugewiesen sind.Represents the collection of items in a ListView control or assigned to a ListViewGroup.

public: ref class ListView::ListViewItemCollection : System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class ListView.ListViewItemCollection : System.Collections.IList
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class ListView.ListViewItemCollection
Implements IList
Vererbung
ListView.ListViewItemCollectionListView.ListViewItemCollectionListView.ListViewItemCollectionListView.ListViewItemCollection
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Elemente zu einem ListView.ListViewItemCollectionhinzugefügt werden.The following code example demonstrates how to add items to a ListView.ListViewItemCollection. Beachten Sie, Items dass die ListView1 -Eigenschaft von ListView.ListViewItemCollectionvom Typ ist.Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. Fügen Sie den folgenden Code in ein Formular ListView ein, das ein ListView1 -Objekt mit dem Namen und ein TextBox mit TextBox1dem Namen enthält, um dieses Beispiel auszuführen.To run this example, paste the following code into a form that contains a ListView object named ListView1 and a TextBox named TextBox1. Ruft die InitializeListView -Methode aus dem Konstruktor oder Load Ereignishandler des Formulars auf.Call the InitializeListView method from the form's constructor or Load event handler.

// This method adds two columns to the ListView, setting the Text 
// and TextAlign, and Width properties of each ColumnHeader.  The 
// HeaderStyle property is set to NonClickable since the ColumnClick 
// event is not handled.  Finally the method adds ListViewItems and 
// SubItems to each column.
void InitializeListView()
{
   this->ListView1 = gcnew System::Windows::Forms::ListView;
   this->ListView1->BackColor = System::Drawing::SystemColors::Control;
   this->ListView1->Dock = System::Windows::Forms::DockStyle::Top;
   this->ListView1->Location = System::Drawing::Point( 0, 0 );
   this->ListView1->Name = "ListView1";
   this->ListView1->Size = System::Drawing::Size( 292, 130 );
   this->ListView1->TabIndex = 0;
   this->ListView1->View = System::Windows::Forms::View::Details;
   this->ListView1->MultiSelect = true;
   this->ListView1->HideSelection = false;
   this->ListView1->HeaderStyle = ColumnHeaderStyle::Nonclickable;
   ColumnHeader^ columnHeader1 = gcnew ColumnHeader;
   columnHeader1->Text = "Breakfast Item";
   columnHeader1->TextAlign = HorizontalAlignment::Left;
   columnHeader1->Width = 146;
   ColumnHeader^ columnHeader2 = gcnew ColumnHeader;
   columnHeader2->Text = "Price Each";
   columnHeader2->TextAlign = HorizontalAlignment::Center;
   columnHeader2->Width = 142;
   this->ListView1->Columns->Add( columnHeader1 );
   this->ListView1->Columns->Add( columnHeader2 );
   array<String^>^foodList = {"Juice","Coffee","Cereal & Milk","Fruit Plate","Toast & Jelly","Bagel & Cream Cheese"};
   array<String^>^foodPrice = {"1.09","1.09","2.19","2.49","1.49","1.49"};
   for ( int count = 0; count < foodList->Length; count++ )
   {
      ListViewItem^ listItem = gcnew ListViewItem( foodList[ count ] );
      listItem->SubItems->Add( foodPrice[ count ] );
      ListView1->Items->Add( listItem );

   }
   this->Controls->Add( ListView1 );
}
  // This method adds two columns to the ListView, setting the Text 
  // and TextAlign, and Width properties of each ColumnHeader.  The 
  // HeaderStyle property is set to NonClickable since the ColumnClick 
  // event is not handled.  Finally the method adds ListViewItems and 
  // SubItems to each column.
  private void InitializeListView()
  {
      this.ListView1 = new System.Windows.Forms.ListView();
      this.ListView1.BackColor = System.Drawing.SystemColors.Control;
      this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
      this.ListView1.Location = new System.Drawing.Point(0, 0);
      this.ListView1.Name = "ListView1";
      this.ListView1.Size = new System.Drawing.Size(292, 130);
      this.ListView1.TabIndex = 0;
      this.ListView1.View = System.Windows.Forms.View.Details;
      this.ListView1.MultiSelect = true;
      this.ListView1.HideSelection = false;
      this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
      
      ColumnHeader columnHeader1 = new ColumnHeader();
      columnHeader1.Text = "Breakfast Item";
      columnHeader1.TextAlign = HorizontalAlignment.Left;
      columnHeader1.Width = 146;

      ColumnHeader columnHeader2 = new ColumnHeader();
      columnHeader2.Text = "Price Each";
      columnHeader2.TextAlign = HorizontalAlignment.Center;
      columnHeader2.Width = 142;

      this.ListView1.Columns.Add(columnHeader1);
      this.ListView1.Columns.Add(columnHeader2);

      string[] foodList = new string[]{"Juice", "Coffee", 
          "Cereal & Milk", "Fruit Plate", "Toast & Jelly", 
          "Bagel & Cream Cheese"};
      string[] foodPrice = new string[]{"1.09", "1.09", "2.19", 
          "2.49", "1.49", "1.49"};
      
      for(int count=0; count < foodList.Length; count++)
      {
          ListViewItem listItem = new ListViewItem(foodList[count]);
          listItem.SubItems.Add(foodPrice[count]);
          ListView1.Items.Add(listItem);
      }
      this.Controls.Add(ListView1);
  }
  
' This method adds two columns to the ListView, setting the Text 
' and TextAlign, and Width properties of each ColumnHeader.  The 
' HeaderStyle property is set to NonClickable since the ColumnClick 
' event is not handled.  Finally the method adds ListViewItems and 
' SubItems to each column.
Private Sub InitializeListView()
    Me.ListView1 = New System.Windows.Forms.ListView
    Me.ListView1.BackColor = System.Drawing.SystemColors.Control
    Me.ListView1.Dock = System.Windows.Forms.DockStyle.Top
    Me.ListView1.Location = New System.Drawing.Point(0, 0)
    Me.ListView1.Name = "ListView1"
    Me.ListView1.Size = New System.Drawing.Size(292, 130)
    Me.ListView1.TabIndex = 0
    Me.ListView1.View = System.Windows.Forms.View.Details
    Me.ListView1.MultiSelect = True
    Me.ListView1.HideSelection = False
    ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable
    Dim columnHeader1 As New ColumnHeader
    With columnHeader1
        .Text = "Breakfast Item"
        .TextAlign = HorizontalAlignment.Left
        .Width = 146
    End With
    Dim columnHeader2 As New ColumnHeader
    With columnHeader2
        .Text = "Price Each"
        .TextAlign = HorizontalAlignment.Center
        .Width = 142
    End With

    Me.ListView1.Columns.Add(columnHeader1)
    Me.ListView1.Columns.Add(columnHeader2)
    Dim foodList() As String = New String() {"Juice", "Coffee", _
        "Cereal & Milk", "Fruit Plate", "Toast & Jelly", _
        "Bagel & Cream Cheese"}
    Dim foodPrice() As String = New String() {"1.09", "1.09", _
        "2.19", "2.49", "1.49", "1.49"}
    Dim count As Integer
    For count = 0 To foodList.Length - 1
        Dim listItem As New ListViewItem(foodList(count))
        listItem.SubItems.Add(foodPrice(count))
        ListView1.Items.Add(listItem)
    Next
    Me.Controls.Add(Me.ListView1)
End Sub

Hinweise

Ein ListView.ListViewItemCollection speichert die Elemente, die in ListView einem-Steuerelement angezeigt ListViewGroupoder einem zugewiesen werden.A ListView.ListViewItemCollection stores the items displayed in a ListView control or assigned to a ListViewGroup. In der ListView -Klasse sind zwei weitere Sammlungen definiert, mit denen Sie bestimmen können, welche Elemente innerhalb eines ListView -Steuer Elements ausgewählt werden.There are two other collections defined within the ListView class that enable you to determine what items are selected within a ListView control. Die ListView.SelectedListViewItemCollection -Klasse stellt Eigenschaften und Methoden bereit, um zu bestimmen, welche ListView Elemente in einem- ListView.SelectedIndexCollection Steuerelement ausgewählt werden, während die-Klasse ListView.ListViewItemCollection Ihnen ermöglicht ListView , zu bestimmen, welche Indizes in der eines Steuer Elements gewählte.The ListView.SelectedListViewItemCollection class provides properties and methods for determining what items are selected in a ListView control, while the ListView.SelectedIndexCollection class enables you to determine what indexes within the ListView.ListViewItemCollection of a ListView control are selected. Zusätzlich zu den Auflistungs Auflistungs Klassen gibt es auch zwei Klassen, mit denen Sie bestimmen können, welche Elemente CheckBoxes in dieser Auflistung ListView geprüft werden (wenn truedie-Eigenschaft des Steuer Elements auf festgelegt ist).In addition to selection collection classes, there are also two classes that enable you to determine what items are checked (when the CheckBoxes property of the ListView control is set to true) within this collection.

Es gibt eine Reihe von Möglichkeiten, der Auflistung Elemente hinzuzufügen.There are a number of ways to add items to the collection. Die Add -Methode fügt der Auflistung ein einzelnes Element hinzu.The Add method adds a single item to the collection. Wenn Sie der Auflistung eine Reihe von Elementen hinzufügen möchten, erstellen Sie ein Array von Elementen, und übergeben AddRange Sie es an die-Methode.To add a number of items to the collection, you create an array of items and pass it to the AddRange method. Wenn Sie ein Element an einer bestimmten Position in der Auflistung einfügen möchten, können Sie die Insert -Methode verwenden.If you want to insert an item at a specific location in the collection, you can use the Insert method. Zum Entfernen von Elementen können Sie entweder die Remove -Methode oder die RemoveAt -Methode verwenden, wenn Sie wissen, wo sich das Element in der Auflistung befindet.To remove items, you can use either the Remove method or the RemoveAt method if you know where the item is located in the collection. Mit Clear der-Methode können Sie alle Elemente aus der Auflistung entfernen, anstatt die Remove -Methode zu verwenden, um ein einzelnes Element gleichzeitig zu entfernen.The Clear method enables you to remove all items from the collection instead of using the Remove method to remove a single item at a time.

Zusätzlich zu den Methoden und Eigenschaften zum Hinzufügen und Entfernen von Elementen ListView.ListViewItemCollection stellt das auch Methoden zum Suchen von Elementen in der Auflistung bereit.In addition to methods and properties for adding and removing items, the ListView.ListViewItemCollection also provides methods to find items in the collection. Mit Contains der-Methode können Sie feststellen, ob ein Element ein Member der Auflistung ist.The Contains method enables you to determine whether an item is a member of the collection. Wenn Sie wissen, dass sich das Element in der Auflistung befindet, können Sie die IndexOf -Methode verwenden, um zu bestimmen, wo sich das Element in der Auflistung befindet.Once you know that the item is located in the collection, you can use the IndexOf method to determine where the item is located in the collection.

Konstruktoren

ListView.ListViewItemCollection(ListView) ListView.ListViewItemCollection(ListView) ListView.ListViewItemCollection(ListView) ListView.ListViewItemCollection(ListView)

Initialisiert eine neue Instanz der ListView.ListViewItemCollection-Klasse.Initializes a new instance of the ListView.ListViewItemCollection class.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Elemente in der Auflistung ab.Gets the number of items in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.Gets a value indicating whether the collection is read-only.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft das Element am angegebenen Index in der Auflistung ab oder legt dieses fest.Gets or sets the item at the specified index within the collection.

Item[String] Item[String] Item[String] Item[String]

Ruft das Element mit dem angegebenen Schlüssel ab.Retrieves the item with the specified key.

Methoden

Add(ListViewItem) Add(ListViewItem) Add(ListViewItem) Add(ListViewItem)

Fügt der Auflistung ein vorhandenes ListViewItem hinzu.Adds an existing ListViewItem to the collection.

Add(String) Add(String) Add(String) Add(String)

Erstellt ein Element mit dem angegebenen Text und fügt es der Auflistung hinzu.Creates an item with the specified text and adds it to the collection.

Add(String, Int32) Add(String, Int32) Add(String, Int32) Add(String, Int32)

Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu.Creates an item with the specified text and image and adds it to the collection.

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32) Add(String, String, Int32) Add(String, String, Int32) Add(String, String, Int32)

Erstellt ein Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt der Auflistung ein Element hinzu.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String) Add(String, String, String) Add(String, String, String) Add(String, String, String)

Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt es der Auflistung hinzu.Creates an item with the specified key, text, and image, and adds it to the collection.

AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection) AddRange(ListView+ListViewItemCollection)

Fügt der Auflistung eine Auflistung von Elementen hinzu.Adds a collection of items to the collection.

AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[]) AddRange(ListViewItem[])

Fügt der Auflistung ein Array von ListViewItem-Objekten hinzu.Adds an array of ListViewItem objects to the collection.

Clear() Clear() Clear() Clear()

Entfernt alle Elemente aus der Auflistung.Removes all items from the collection.

Contains(ListViewItem) Contains(ListViewItem) Contains(ListViewItem) Contains(ListViewItem)

Bestimmt, ob das angegebene Element in der Auflistung enthalten ist.Determines whether the specified item is located in the collection.

ContainsKey(String) ContainsKey(String) ContainsKey(String) ContainsKey(String)

Bestimmt, ob die Auflistung ein Element mit dem angegebenen Schlüssel enthält.Determines whether the collection contains an item with the specified key.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Kopiert die gesamte Auflistung an eine angegebene Position in einem vorhandenen Array.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Find(String, Boolean) Find(String, Boolean) Find(String, Boolean) Find(String, Boolean)

Sucht nach Elementen, deren Name mit dem angegebenen Schlüssel übereinstimmt; optional wird nach Unterelementen gesucht.Searches for items whose name matches the specified key, optionally searching subitems.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen Enumerator zurück, mit dem die Elementauflistung durchlaufen werden soll.Returns an enumerator to use to iterate through the item collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(ListViewItem) IndexOf(ListViewItem) IndexOf(ListViewItem) IndexOf(ListViewItem)

Gibt den Index des angegebenen Elements in der Auflistung zurück.Returns the index within the collection of the specified item.

IndexOfKey(String) IndexOfKey(String) IndexOfKey(String) IndexOfKey(String)

Ruft den Index des Elements mit dem angegebenen Schlüssel ab.Retrieves the index of the item with the specified key.

Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem)

Fügt ein bestehendes ListViewItem am angegebenen Index in die Auflistung ein.Inserts an existing ListViewItem into the collection at the specified index.

Insert(Int32, String) Insert(Int32, String) Insert(Int32, String) Insert(Int32, String)

Erstellt ein neues Element und fügt es am angegebenen Index in die Auflistung ein.Creates a new item and inserts it into the collection at the specified index.

Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32)

Erstellt ein neues Element mit dem angegebenen Bildtext und fügt es an der angegebenen Indexposition in die Auflistung ein.Creates a new item with the specified image index and inserts it into the collection at the specified index.

Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String)

Erstellt ein neues Element mit dem dem angegebenen Text und dem angegebenen Bild und fügt es am angegebenen Index in die Auflistung ein.Creates a new item with the specified text and image and inserts it in the collection at the specified index.

Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32)

Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es am angegebenen Index in die Auflistung ein.Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String)

Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es der Auflistung am angegebenen Index hinzu.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(ListViewItem) Remove(ListViewItem) Remove(ListViewItem) Remove(ListViewItem)

Entfernt das angegebene Element aus der Auflistung.Removes the specified item from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt das Element am angegebenen Index in der Auflistung.Removes the item at the specified index within the collection.

RemoveByKey(String) RemoveByKey(String) RemoveByKey(String) RemoveByKey(String)

Entfernt das Element mit dem angegebenen Schlüssel aus der Auflistung.Removes the item with the specified key from the collection.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist (threadsicher).Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kannGets an object that can be used to synchronize access to the collection of controls.

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Fügt der Auflistung ein vorhandenes Objekt hinzu.Adds an existing object to the collection.

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Bestimmt, ob das angegebene Element in der Auflistung vorhanden ist.Determines whether the specified item is in the collection.

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Gibt den Index des angegebenen Elements in der Auflistung zurück.Returns the index within the collection of the specified item.

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Fügt ein Objekt am angegebenen Index in die Auflistung ein.Inserts an object into the collection at the specified index.

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Ruft einen Wert ab, der angibt, ob die Auflistung eine feste Größe aufweist.Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Ruft eine ListViewItem am angegebenen Index in der Auflistung ab oder legt diese fest.Gets or sets the ListViewItem at the specified index within the collection.

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Entfernt das angegebene Element aus der Auflistung.Removes the specified item from the collection.

Erweiterungsmethoden

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch