ListView.ListViewItemCollection.Insert Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inserisce un elemento nella raccolta in corrispondenza dell'indice specificato.

Overload

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.
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.
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.
Insert(Int32, ListViewItem)	Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.
Insert(Int32, String)	Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.
Insert(Int32, String, Int32)	Crea un nuovo elemento con l'indice di immagine specificato e lo inserisce nell'insieme in corrispondenza dell'indice specificato.

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.

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

public virtual System.Windows.Forms.ListViewItem Insert (int index, string key, string text, string imageKey);

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

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

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Parametri

index: Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.

key: String

Proprietà Name dell'elemento.

text: String

Testo dell'elemento.

imageKey: String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Eccezioni

ArgumentOutOfRangeException

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

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

Si applica a

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.

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

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

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

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

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

Parametri

index: Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.

key: String

Proprietà Name dell'elemento.

text: String

Testo dell'elemento.

imageIndex: Int32

Indice dell'immagine associata all'elemento.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Eccezioni

ArgumentOutOfRangeException

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

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

Si applica a

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.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);

public System.Windows.Forms.ListViewItem Insert (int index, string text, string imageKey);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, string? imageKey);

member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Parametri

index: Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.

text: String

Testo di ListViewItem.

imageKey: String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Eccezioni

ArgumentOutOfRangeException

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Si applica a

Insert(Int32, ListViewItem)

Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);

public System.Windows.Forms.ListViewItem Insert (int index, System.Windows.Forms.ListViewItem item);

member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Parametri

index: Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.

item: ListViewItem

Oggetto ListViewItem che rappresenta l'elemento da inserire.

Restituisce

ListViewItem

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

ArgumentOutOfRangeException

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un oggetto esistente ListViewItem in una posizione specifica in ListView.ListViewItemCollection.

Nota

Se la ListView.Sorting proprietà è impostata su un valore diverso SortOrder.None da o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'inserimento dell'elemento.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta per aggiungere l'elemento, utilizzare il Add metodo . Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo . È possibile utilizzare questo metodo se si desidera inserire un nuovo elemento in una raccolta esistente di elementi.

Vedi anche

Si applica a

Insert(Int32, String)

Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);

public System.Windows.Forms.ListViewItem Insert (int index, string text);

public System.Windows.Forms.ListViewItem Insert (int index, string? text);

member this.Insert : int * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String) As ListViewItem

Parametri

index: Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.

text: String

Testo da visualizzare per l'elemento.

Restituisce

ListViewItem

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

ArgumentOutOfRangeException

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un nuovo elemento in una posizione specifica in ListView.ListViewItemCollection. Il testo specificato nel text parametro viene usato per creare un nuovo ListViewItem oggetto che viene quindi inserito nella ListView.ListViewItemCollection posizione specificata.

Nota

Se la ListView.Sorting proprietà è impostata su un valore diverso SortOrder.None da o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'inserimento dell'elemento.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta, utilizzare il Add metodo . Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo . È possibile utilizzare questo metodo se si desidera inserire un nuovo elemento in una raccolta esistente di elementi.

Vedi anche

Si applica a

Insert(Int32, String, Int32)

Crea un nuovo elemento con l'indice di immagine specificato e lo inserisce nell'insieme in corrispondenza dell'indice specificato.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert (int index, string text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, int imageIndex);

member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Parametri

index: Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.

text: String

Testo da visualizzare per l'elemento.

imageIndex: Int32

Indice dell'immagine associata all'elemento.

Restituisce

ListViewItem

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

ArgumentOutOfRangeException

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Nota

Se la ListView.Sorting proprietà è impostata su un valore diverso SortOrder.None da o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'inserimento dell'elemento.

È anche possibile usare questa versione del Insert metodo per 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 immagine per l'elemento, usare l'altra versione del Insert metodo che accetta una stringa come parametro.

Vedi anche

Si applica a

ListView.ListViewItemCollection.Insert Metodo

Definizione

Overload

Insert(Int32, String, String, String)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Insert(Int32, String, String, Int32)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Insert(Int32, String, String)

Parametri

Restituisce

Eccezioni

Si applica a

Insert(Int32, ListViewItem)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

Insert(Int32, String)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

Insert(Int32, String, Int32)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive