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

Definizione

Rappresenta la raccolta di elementi in un controllo ListView o assegnata a ListViewGroup.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
Ereditarietà
ListView.ListViewItemCollectionListView.ListViewItemCollectionListView.ListViewItemCollectionListView.ListViewItemCollection
Attributi
Implementazioni

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come aggiungere ListView.ListViewItemCollectionelementi a un oggetto.The following code example demonstrates how to add items to a ListView.ListViewItemCollection. Si noti che Items la proprietà ListView1 di è di ListView.ListViewItemCollectiontipo.Note that the Items property of ListView1 is of type ListView.ListViewItemCollection. Per eseguire questo esempio, incollare il codice seguente in un form che contiene un ListView oggetto denominato ListView1 e un TextBox oggetto TextBox1denominato.To run this example, paste the following code into a form that contains a ListView object named ListView1 and a TextBox named TextBox1. Chiamare il InitializeListView metodo dal costruttore del form o Load dal gestore eventi.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

Commenti

Un ListView.ListViewItemCollection oggetto archivia gli elementi visualizzati in ListView un controllo o assegnati a ListViewGroupun oggetto.A ListView.ListViewItemCollection stores the items displayed in a ListView control or assigned to a ListViewGroup. All'interno della ListView classe sono definite altre due raccolte che consentono di determinare quali elementi sono selezionati all'interno di ListView un controllo.There are two other collections defined within the ListView class that enable you to determine what items are selected within a ListView control. La ListView.SelectedListViewItemCollection classe fornisce proprietà e metodi per determinare quali elementi sono selezionati in un ListView controllo, mentre la ListView.SelectedIndexCollection classe consente di determinare quali indici nell'oggetto ListView.ListViewItemCollection di un ListView controllo sono selezionato.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. Oltre alle classi di raccolte di selezione, sono disponibili anche due classi che consentono di determinare quali elementi vengono controllati (quando la CheckBoxes proprietà ListView del controllo è impostata su true) all'interno di questa raccolta.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.

Sono disponibili diversi modi per aggiungere elementi alla raccolta.There are a number of ways to add items to the collection. Il Add metodo aggiunge un singolo elemento alla raccolta.The Add method adds a single item to the collection. Per aggiungere un numero di elementi alla raccolta, è necessario creare una matrice di elementi e passarla al AddRange metodo.To add a number of items to the collection, you create an array of items and pass it to the AddRange method. Se si desidera inserire un elemento in una posizione specifica della raccolta, è possibile utilizzare il Insert metodo.If you want to insert an item at a specific location in the collection, you can use the Insert method. Per rimuovere elementi, è possibile usare il Remove metodo RemoveAt o il metodo se si sa dove si trova l'elemento nella raccolta.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. Il Clear metodo consente di rimuovere tutti gli elementi dalla raccolta anziché utilizzare il Remove metodo per rimuovere un singolo elemento alla volta.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.

Oltre ai metodi e alle proprietà per l'aggiunta e la ListView.ListViewItemCollection rimozione di elementi, fornisce anche metodi per trovare gli elementi nella raccolta.In addition to methods and properties for adding and removing items, the ListView.ListViewItemCollection also provides methods to find items in the collection. Il Contains metodo consente di determinare se un elemento è un membro della raccolta.The Contains method enables you to determine whether an item is a member of the collection. Quando si è certi che l'elemento si trova nella raccolta, è possibile usare il IndexOf metodo per determinare dove si trova l'elemento nella raccolta.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.

Costruttori

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

Inizializza una nuova istanza della classe ListView.ListViewItemCollection.Initializes a new instance of the ListView.ListViewItemCollection class.

Proprietà

Count Count Count Count

Ottiene il numero di elementi nella raccolta.Gets the number of items in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore che indica se la raccolta è di sola lettura.Gets a value indicating whether the collection is read-only.

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

Ottiene o imposta l'elemento presente in corrispondenza dell'indice specificato all'interno dell'insieme.Gets or sets the item at the specified index within the collection.

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

Recupera l'elemento con la chiave specificata.Retrieves the item with the specified key.

Metodi

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

Aggiunge un oggetto ListViewItem esistente all'insieme.Adds an existing ListViewItem to the collection.

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

Crea un elemento con il testo specificato e lo aggiunge all'insieme.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)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.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)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.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)

Crea un elemento con la chiave, il testo e l'immagine specificati e aggiunge un elemento all'insieme.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)

Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge all'insieme.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)

Aggiunge un insieme di elementi all'insieme.Adds a collection of items to the collection.

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

Aggiunge una matrice di oggetti ListViewItem all'insieme.Adds an array of ListViewItem objects to the collection.

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

Rimuove tutti gli elementi dalla raccolta.Removes all items from the collection.

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

Consente di determinare se l'elemento specificato è contenuto nell'insieme.Determines whether the specified item is located in the collection.

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

Determina se l'insieme contiene un elemento con la chiave specificata.Determines whether the collection contains an item with the specified key.

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

Copia l'intero insieme in una posizione specifica all'interno di una matrice esistente.Copies the entire collection into an existing array at a specified location within the array.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.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)

Cerca gli elementi il cui nome corrisponde alla chiave specificata, facoltativamente esegue anche la ricerca di elementi secondari.Searches for items whose name matches the specified key, optionally searching subitems.

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

Restituisce un enumeratore da utilizzare per scorrere l'insieme degli elementi.Returns an enumerator to use to iterate through the item collection.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Restituisce l'indice all'interno dell'insieme dell'elemento specificato.Returns the index within the collection of the specified item.

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

Recupera l'indice dell'elemento con la chiave specificata.Retrieves the index of the item with the specified key.

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

Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.Inserts an existing ListViewItem into the collection at the specified index.

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

Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.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)

Crea un nuovo elemento con l'indice di immagine specificato e lo inserisce nell'insieme in corrispondenza dell'indice specificato.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)

Crea un nuovo elemento con il testo e l'immagine specificati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.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)

Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.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)

Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo aggiunge all'insieme in corrispondenza dell'indice specificato.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()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Rimuove l'elemento specificato dalla raccolta.Removes the specified item from the collection.

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

Rimuove dall'insieme l'elemento presente in corrispondenza dell'indice specificato.Removes the item at the specified index within the collection.

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

Rimuove dall'insieme l'elemento con la chiave specificata.Removes the item with the specified key from the collection.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread safe).

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

Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme dei controlli.Gets 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)

Aggiunge un oggetto esistente all'insieme.Adds an existing object to the collection.

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

Determina se l'elemento specificato è presente nell'insieme.Determines whether the specified item is in the collection.

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

Restituisce l'indice all'interno dell'insieme dell'elemento specificato.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)

Inserisce un oggetto nella raccolta in corrispondenza dell'indice specificato.Inserts an object into the collection at the specified index.

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

Ottiene un valore che indica se la dimensione della raccolta è fissa.Gets a value indicating whether the collection has a fixed size.

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

Ottiene o imposta il gruppo ListViewItem in corrispondenza dell'indice specificato all'interno dell'insieme.Gets or sets the ListViewItem at the specified index within the collection.

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

Rimuove l'elemento specificato dalla raccolta.Removes the specified item from the collection.

Metodi di estensione

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

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

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

Consente la parallelizzazione di una query.Enables parallelization of a query.

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

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche