ListView.ListViewItemCollection.Add Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt der Auflistung von Elementen ein Element hinzu.

Überlädt

Name	Beschreibung
Add(String)	Erstellt ein Element mit dem angegebenen Text und fügt es der Auflistung hinzu.
Add(ListViewItem)	Fügt der Auflistung eine vorhandene ListViewItem hinzu.
Add(String, Int32)	Erstellt ein Element mit dem angegebenen Text und Bild und fügt es der Auflistung hinzu.
Add(String, String)	Erstellt ein Element mit dem angegebenen Text und Bild und fügt es der Auflistung hinzu.
Add(String, String, Int32)	Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt der Auflistung ein Element hinzu.
Add(String, String, String)	Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt es der Auflistung hinzu.

Add(String)

Quelle:

ListView.ListViewItemCollection.cs

Erstellt ein Element mit dem angegebenen Text und fügt es der Auflistung hinzu.

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

Parameter

text

String

Der text, der für das Element angezeigt werden soll.

Gibt zurück

ListViewItem

Das ListViewItem , das der Auflistung hinzugefügt wurde.

Hinweise

Sie können diese Version der Add Methode verwenden, um ein neues ListViewItem Steuerelement zu ListView erstellen. Der Text des neuen ListViewItem , dem Steuerelement hinzugefügten Elements basiert auf dem text Parameter. Wenn Sie ein Bild für das Element angeben möchten, verwenden Sie die Version der Add Methode, die einen Bildindex als Parameter akzeptiert. Wenn Sie über eine Vorhandene verfügen ListViewItem , die Sie der Auflistung hinzufügen möchten, verwenden Sie die Version der Methode, die Add einen ListViewItem als Parameter akzeptiert.

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert festgelegt ist als SortOrder.None oder wenn die ListViewItemSorter Eigenschaft festgelegt wird, wird die Liste nach dem Hinzufügen des Elements sortiert. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie mit der Insert Methode ein Element an ListView einer bestimmten Position einfügen. Verwenden Sie die AddRange Methode, um dem Steuerelement in einem einzigen Vorgang eine Gruppe von Elementen hinzuzufügen. Wenn Sie die Add Methode verwenden möchten, um dem Steuerelement eine große Anzahl von Elementen hinzuzufügen, verwenden Sie die BeginUpdate Methoden und EndUpdate methoden, um zu verhindern, dass die ListView Aktualisierung ausgeführt wird, bis alle Elemente hinzugefügt werden. Beim Hinzufügen von Elementen zu einem ListViewElement ist es effizienter, die Elemente zuerst zu sortieren und dann neue Elemente hinzuzufügen.

Weitere Informationen

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

Add(ListViewItem)

Quelle:

ListView.ListViewItemCollection.cs

Fügt der Auflistung eine vorhandene ListViewItem hinzu.

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

Parameter

value

ListViewItem

Das ListViewItem , das der Auflistung hinzugefügt werden soll.

Gibt zurück

ListViewItem

Das ListViewItem , das der Auflistung hinzugefügt wurde.

Hinweise

Sie können diese Version der Add Methode verwenden, um der Auflistung eine vorhandene ListViewItem Hinzuzufügen. Diese Version der Methode wird in der Add Regel verwendet, um Elemente aus anderen ListView Steuerelementen wiederzuverwenden oder wenn die ListViewItem Methode manuell erstellt wurde, bevor sie der Auflistung hinzugefügt wird. Wenn Sie ein neues ListViewItem erstellen möchten, anstatt ein vorhandenes Element zu verwenden, verwenden Sie die anderen Versionen der Add Methode.

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert festgelegt ist als SortOrder.None oder wenn die ListViewItemSorter Eigenschaft festgelegt wird, wird die Liste nach dem Hinzufügen des Elements sortiert. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie mit der Insert Methode ein Element an ListView einer bestimmten Position einfügen. Verwenden Sie die AddRange Methode, um dem Steuerelement in einem einzigen Vorgang eine Gruppe von Elementen hinzuzufügen. Wenn Sie die Add Methode verwenden möchten, um dem Steuerelement eine große Anzahl von Elementen hinzuzufügen, verwenden Sie die BeginUpdate Methoden und EndUpdate methoden, um zu verhindern, dass die ListView Aktualisierung ausgeführt wird, bis alle Elemente hinzugefügt werden. Beim Hinzufügen von Elementen zu einem ListViewElement ist es effizienter, die Elemente zuerst zu sortieren und dann neue Elemente hinzuzufügen.

Diese Version der Add Methode wird auch verwendet, um einem ListViewItem .ListViewGroup

Weitere Informationen

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

Add(String, Int32)

Quelle:

ListView.ListViewItemCollection.cs

Erstellt ein Element mit dem angegebenen Text und Bild und fügt es der Auflistung hinzu.

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

Parameter

text

String

Der Text des Elements.

imageIndex

Int32

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

Gibt zurück

ListViewItem

Das ListViewItem , das der Auflistung hinzugefügt wurde.

Hinweise

Sie können diese Version der Add Methode verwenden, um ein neues ListViewItem zu erstellen, das dem ListView Steuerelement hinzugefügt werden soll. Der Text des neuen ListViewItem , dem Steuerelement hinzugefügten Elements basiert auf dem text Parameter. Sie können auch ein Bild für das Element angeben, indem Sie den Index des ImageList zugewiesenen Elements und ListView.SmallImageList eigenschaften ListView.LargeImageList an den imageIndex Parameter übergeben. (In der Regel verwenden die ListView.LargeImageList eigenschaften ListView.SmallImageList die gleichen Indexpositionen, um verwandte Bilder anzuzeigen.) Wenn Sie keinen Bildindex für das Element angeben möchten, verwenden Sie die Version der Methode, die Add nur eine Zeichenfolge als Parameter akzeptiert. Wenn Sie über eine Vorhandene verfügen ListViewItem , die Sie der Auflistung hinzufügen möchten, verwenden Sie die Version der Methode, die Add einen ListViewItem als Parameter akzeptiert.

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert festgelegt ist als SortOrder.None oder wenn die ListViewItemSorter Eigenschaft festgelegt wird, wird die Liste nach dem Hinzufügen des Elements sortiert. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie mit der Insert Methode ein Element an ListView einer bestimmten Position einfügen. Verwenden Sie die AddRange Methode, um dem Steuerelement in einem einzigen Vorgang eine Gruppe von Elementen hinzuzufügen. Wenn Sie die Add Methode verwenden möchten, um dem Steuerelement eine große Anzahl von Elementen hinzuzufügen, verwenden Sie die BeginUpdate Methoden und EndUpdate methoden, um zu verhindern, dass die ListView Aktualisierung ausgeführt wird, bis alle Elemente hinzugefügt werden. Beim Hinzufügen von Elementen zu einem ListViewElement ist es effizienter, die Elemente zuerst zu sortieren und dann neue Elemente hinzuzufügen.

Weitere Informationen

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

Add(String, String)

Quelle:

ListView.ListViewItemCollection.cs

Erstellt ein Element mit dem angegebenen Text und Bild und fügt es der Auflistung hinzu.

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

Parameter

text

String

Der Text des Elements.

imageKey

String

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

Gibt zurück

ListViewItem

Die ListViewItem der Auflistung hinzugefügte.

Hinweise

Wenn die ListView Sortierung erfolgt, wird das Element in der korrekt sortierten Reihenfolge hinzugefügt. Andernfalls wird es am Ende der Auflistung hinzugefügt.

Add(String, String, Int32)

Quelle:

ListView.ListViewItemCollection.cs

Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt der Auflistung ein Element hinzu.

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

Parameter

key

String

Name des Elements.

text

String

Der Text des Elements.

imageIndex

Int32

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

Gibt zurück

ListViewItem

Die ListViewItem der Auflistung hinzugefügte.

Ausnahmen

InvalidOperationException

Das Enthalten ListView befindet sich im virtuellen Modus.

Hinweise

Wenn die ListView Sortierung erfolgt, wird das Element in der korrekt sortierten Reihenfolge hinzugefügt. Andernfalls wird es am Ende der Auflistung hinzugefügt. Die Name Eigenschaft entspricht dem Schlüssel für eine ListViewItem in der ListView.ListViewItemCollection.

Die Add Methode legt die Name Eigenschaft auf den angegebenen Schlüssel fest, sodass das Element von seinem Index oder schlüssel abgerufen werden kann.

Add(String, String, String)

Quelle:

ListView.ListViewItemCollection.cs

Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt es der Auflistung hinzu.

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

Parameter

key

String

Name des Elements.

text

String

Der Text des Elements.

imageKey

String

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

Gibt zurück

ListViewItem

Die ListViewItem der Auflistung hinzugefügte.

Hinweise

Die Name Eigenschaft entspricht dem Schlüssel für eine ListViewItem in der ListView.ListViewItemCollection.

Wenn die ListView Sortierung erfolgt, wird das Element in der korrekt sortierten Reihenfolge hinzugefügt. Andernfalls wird es am Ende der Auflistung hinzugefügt. Die Add Methode legt die Name Eigenschaft des Elements auf den angegebenen Schlüssel fest, sodass das Element von seinem Index oder schlüssel abgerufen werden kann.