Freigeben über


ListView.ListViewItemCollection.Insert Methode

Definition

Fügt ein Element am angegebenen Index in die Auflistung ein.

Überlädt

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.

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.

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.

Insert(Int32, ListViewItem)

Fügt ein bestehendes ListViewItem am angegebenen Index in die Auflistung ein.

Insert(Int32, String)

Erstellt ein neues Element und fügt es am angegebenen Index in die Auflistung ein.

Insert(Int32, String, Int32)

Erstellt ein neues Element mit dem angegebenen Bildtext und fügt es an der angegebenen Indexposition in die Auflistung ein.

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.

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

Parameter

index
Int32

Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.

key
String

Der Name des Elements.

text
String

Der Text des Elements.

imageKey
String

Der Schlüssel des Bilds, der für das Element angezeigt werden soll.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem.

Ausnahmen

Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.

Hinweise

Die Insert -Methode legt die Name -Eigenschaft des Elements auf den angegebenen Schlüssel fest, sodass das Element mit seinem Index oder nach Schlüssel abgerufen werden kann.

Gilt für:

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.

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

Parameter

index
Int32

Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.

key
String

Der Name des Elements.

text
String

Der Text des Elements.

imageIndex
Int32

Der Index des Bilds, der für das Element angezeigt werden soll.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem.

Ausnahmen

Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.

Hinweise

Die Insert -Methode legt die Name -Eigenschaft des Elements auf den angegebenen Schlüssel fest, sodass das Element mit seinem Index oder nach Schlüssel abgerufen werden kann.

Gilt für:

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.

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

Parameter

index
Int32

Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.

text
String

Der Text der ListViewItem.

imageKey
String

Der Schlüssel des Bilds, der für das Element angezeigt werden soll.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem.

Ausnahmen

Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.

Gilt für:

Insert(Int32, ListViewItem)

Fügt ein bestehendes ListViewItem am angegebenen Index in die Auflistung ein.

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

Parameter

index
Int32

Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.

item
ListViewItem

Das ListViewItem, das das einzufügende Element darstellt.

Gibt zurück

Das ListViewItem, das in die Auflistung eingefügt wurde.

Ausnahmen

Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.

Hinweise

Mit dieser Version der Insert -Methode können Sie ein vorhandenes ListViewItem an einer bestimmten Position im ListView.ListViewItemCollectioneinfügen.

Hinweis

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder festgelegt ist, wird die ListViewItemSorter Liste nach dem Einfügen des Elements sortiert.

Verwenden Sie die Add -Methode, um ein Element hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben, um das Element hinzuzufügen. Wenn Sie der Auflistung ein Array von Elementen hinzufügen möchten, verwenden Sie die AddRange -Methode. Sie können diese Methode verwenden, wenn Sie ein neues Element in eine vorhandene Auflistung von Elementen einfügen möchten.

Weitere Informationen

Gilt für:

Insert(Int32, String)

Erstellt ein neues Element und fügt es am angegebenen Index in die Auflistung ein.

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

Parameter

index
Int32

Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.

text
String

Der für das Element anzuzeigende Text.

Gibt zurück

Das ListViewItem, das in die Auflistung eingefügt wurde.

Ausnahmen

Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.

Hinweise

Mit dieser Version der Insert -Methode können Sie ein neues Element an einer bestimmten Position im ListView.ListViewItemCollectioneinfügen. Der im text Parameter angegebene Text wird verwendet, um eine neue ListViewItem zu erstellen, die dann an der angegebenen Position in die ListView.ListViewItemCollection eingefügt wird.

Hinweis

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder festgelegt ist, wird die ListViewItemSorter Liste nach dem Einfügen des Elements sortiert.

Verwenden Sie die Add -Methode, um ein Element hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben. Wenn Sie der Auflistung ein Array von Elementen hinzufügen möchten, verwenden Sie die AddRange -Methode. Sie können diese Methode verwenden, wenn Sie ein neues Element in eine vorhandene Auflistung von Elementen einfügen möchten.

Weitere Informationen

Gilt für:

Insert(Int32, String, Int32)

Erstellt ein neues Element mit dem angegebenen Bildtext und fügt es an der angegebenen Indexposition in die Auflistung ein.

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

Parameter

index
Int32

Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.

text
String

Der für das Element anzuzeigende Text.

imageIndex
Int32

Der Index des Bilds, der für das Element angezeigt werden soll.

Gibt zurück

Das ListViewItem, das in die Auflistung eingefügt wurde.

Ausnahmen

Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.

Hinweise

Mit dieser Version der Insert -Methode können Sie ein neues Element an einer bestimmten Position im ListView.ListViewItemCollectioneinfügen. Der im text Parameter angegebene Text wird verwendet, um eine neue ListViewItem zu erstellen, die dann an der angegebenen Position in die ListView.ListViewItemCollection eingefügt wird.

Hinweis

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder festgelegt ist, wird die ListViewItemSorter Liste nach dem Einfügen des Elements sortiert.

Sie können diese Version der Insert -Methode auch verwenden, um ein Image für das Element anzugeben, indem Sie den Index der ImageList zugewiesenen Eigenschaften und ListView.SmallImageList an ListView.LargeImageList den imageIndex Parameter übergeben. (In der Regel verwenden die ListView.LargeImageList Eigenschaften und ListView.SmallImageList dieselben Indexpositionen, um verwandte Bilder anzuzeigen.) Wenn Sie keinen Imageindex für das Element angeben möchten, verwenden Sie die andere Version der Methode, die Insert eine Zeichenfolge als Parameter akzeptiert.

Verwenden Sie die Add -Methode, um ein Element hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben. Wenn Sie der Auflistung ein Array von Elementen hinzufügen möchten, verwenden Sie die AddRange -Methode.

Weitere Informationen

Gilt für: