ListView.ListViewItemCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge un elemento all'insieme di elementi.

Overload

Nome	Descrizione
Add(String)	Crea un elemento con il testo specificato e lo aggiunge alla raccolta.
Add(ListViewItem)	Aggiunge un oggetto esistente ListViewItem alla raccolta.
Add(String, Int32)	Crea un elemento con il testo e l'immagine specificati e lo aggiunge alla raccolta.
Add(String, String)	Crea un elemento con il testo e l'immagine specificati e lo aggiunge alla raccolta.
Add(String, String, Int32)	Crea un elemento con la chiave, il testo e l'immagine specificati e aggiunge un elemento alla raccolta.
Add(String, String, String)	Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge alla raccolta.

Add(String)

Origine:

ListView.ListViewItemCollection.cs

Crea un elemento con il testo specificato e lo aggiunge alla raccolta.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ListViewItem Add(string? text);

abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

Parametri

text

String

Testo da visualizzare per l'elemento.

Restituisce

ListViewItem

Oggetto ListViewItem aggiunto alla raccolta.

Commenti

È possibile utilizzare questa versione del Add metodo per creare un nuovo ListViewItem oggetto da aggiungere a un ListView controllo . Il testo del nuovo ListViewItem oggetto aggiunto al controllo è basato sul text parametro . Se si desidera specificare un'immagine per l'elemento, usare la versione del Add metodo che accetta un indice di immagine come parametro. Se si dispone di un oggetto esistente ListViewItem che si desidera aggiungere alla raccolta, utilizzare la versione del Add metodo che accetta un oggetto ListViewItem come parametro.

Se la ListView.Sorting proprietà è impostata su un valore diverso da SortOrder.None o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'aggiunta dell'elemento. In caso contrario, l'elemento viene inserito alla fine dell'elenco. Se l'elenco non è ordinato, è possibile utilizzare il Insert metodo per inserire un elemento in ListView in una posizione specifica. Per aggiungere un set di elementi al controllo in una singola operazione, utilizzare il AddRange metodo . Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate metodi e EndUpdate per impedire l'aggiornamento ListView finché non vengono aggiunti tutti gli elementi. Quando si aggiungono elementi a , ListViewè più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.

Vedi anche

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(ListViewItem)

Origine:

ListView.ListViewItemCollection.cs

Aggiunge un oggetto esistente ListViewItem alla raccolta.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);

public virtual System.Windows.Forms.ListViewItem Add(System.Windows.Forms.ListViewItem value);

abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

Parametri

value

ListViewItem

Oggetto ListViewItem da aggiungere alla raccolta.

Restituisce

ListViewItem

Oggetto ListViewItem aggiunto alla raccolta.

Commenti

È possibile utilizzare questa versione del Add metodo per aggiungere un oggetto esistente ListViewItem alla raccolta. Questa versione del Add metodo viene in genere utilizzata per riutilizzare gli elementi di altri ListView controlli o se è ListViewItem stato creato manualmente prima di aggiungerlo alla raccolta. Se si desidera creare un nuovo ListViewItem elemento anziché usare un elemento esistente, utilizzare le altre versioni del Add metodo .

Se la ListView.Sorting proprietà è impostata su un valore diverso da SortOrder.None o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'aggiunta dell'elemento. In caso contrario, l'elemento viene inserito alla fine dell'elenco. Se l'elenco non è ordinato, è possibile utilizzare il Insert metodo per inserire un elemento in ListView in una posizione specifica. Per aggiungere un set di elementi al controllo in una singola operazione, utilizzare il AddRange metodo . Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate metodi e EndUpdate per impedire l'aggiornamento ListView finché non vengono aggiunti tutti gli elementi. Quando si aggiungono elementi a , ListViewè più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.

Questa versione del Add metodo viene usata anche per assegnare un oggetto ListViewItem a un oggetto ListViewGroup.

Vedi anche

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, Int32)

Origine:

ListView.ListViewItemCollection.cs

Crea un elemento con il testo e l'immagine specificati e lo aggiunge alla raccolta.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string? text, int imageIndex);

abstract member Add : string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

Parametri

text

String

Testo dell'elemento.

imageIndex

Int32

Indice dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

Oggetto ListViewItem aggiunto alla raccolta.

Commenti

È possibile utilizzare questa versione del Add metodo per creare un nuovo ListViewItem oggetto da aggiungere al ListView controllo . Il testo del nuovo ListViewItem oggetto aggiunto al controllo è basato sul text parametro . È anche possibile specificare un'immagine per l'elemento passando l'indice dell'oggetto ImageList assegnato alle ListView.LargeImageList proprietà e ListView.SmallImageList al imageIndex parametro . In genere, le ListView.LargeImageList proprietà e ListView.SmallImageList usano le stesse posizioni di indice per visualizzare le immagini correlate. Se non si vuole specificare un indice di immagine per l'elemento, usare la versione del Add metodo che accetta solo una stringa come parametro. Se si dispone di un oggetto esistente ListViewItem che si desidera aggiungere alla raccolta, utilizzare la versione del Add metodo che accetta un oggetto ListViewItem come parametro.

Se la ListView.Sorting proprietà è impostata su un valore diverso da SortOrder.None o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'aggiunta dell'elemento. In caso contrario, l'elemento viene inserito alla fine dell'elenco. Se l'elenco non è ordinato, è possibile utilizzare il Insert metodo per inserire un elemento in ListView in una posizione specifica. Per aggiungere un set di elementi al controllo in una singola operazione, utilizzare il AddRange metodo . Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate metodi e EndUpdate per impedire l'aggiornamento ListView finché non vengono aggiunti tutti gli elementi. Quando si aggiungono elementi a , ListViewè più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.

Vedi anche

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, String)

Origine:

ListView.ListViewItemCollection.cs

Crea un elemento con il testo e l'immagine specificati e lo aggiunge alla raccolta.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string? text, string? imageKey);

abstract member Add : string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

Parametri

text

String

Testo dell'elemento.

imageKey

String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

Oggetto ListViewItem aggiunto alla raccolta.

Commenti

Se l'oggetto ListView è ordinato, l'elemento viene aggiunto nell'ordine ordinato correttamente; in caso contrario, viene aggiunto alla fine dell'insieme.

Add(String, String, Int32)

Origine:

ListView.ListViewItemCollection.cs

Crea un elemento con la chiave, il testo e l'immagine specificati e aggiunge un elemento alla raccolta.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, int imageIndex);

abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItem

Parametri

key

String

Nome dell'elemento.

text

String

Testo dell'elemento.

imageIndex

Int32

Indice dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

Oggetto ListViewItem aggiunto alla raccolta.

Eccezioni

InvalidOperationException

L'oggetto contenitore ListView è in modalità virtuale.

Commenti

Se l'oggetto ListView è ordinato, l'elemento viene aggiunto nell'ordine ordinato correttamente; in caso contrario, viene aggiunto alla fine dell'insieme. La Name proprietà corrisponde alla chiave di un ListViewItem oggetto ListView.ListViewItemCollectionin .

Il Add metodo imposta la Name proprietà sulla chiave specificata, in modo che l'elemento possa essere recuperato dall'indice o dalla chiave.

Add(String, String, String)

Origine:

ListView.ListViewItemCollection.cs

Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge alla raccolta.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, string? imageKey);

abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

Parametri

key

String

Nome dell'elemento.

text

String

Testo dell'elemento.

imageKey

String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

Oggetto ListViewItem aggiunto alla raccolta.

Commenti

La Name proprietà corrisponde alla chiave di un ListViewItem oggetto ListView.ListViewItemCollectionin .

Se l'oggetto ListView è ordinato, l'elemento viene aggiunto nell'ordine ordinato correttamente; in caso contrario, viene aggiunto alla fine dell'insieme. Il Add metodo imposta la Name proprietà dell'elemento sulla chiave specificata, in modo che l'elemento possa essere recuperato dal relativo indice o dalla chiave.