Freigeben über


ListView.ListViewItemCollection.Add Methode

Definition

Fügt der Auflistung der Elemente ein Element hinzu.

Überlädt

Add(String)

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

Add(ListViewItem)

Fügt der Auflistung ein vorhandenes ListViewItem hinzu.

Add(String, Int32)

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

Add(String, String)

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

Add(String, String, Int32)

Erstellt ein Element mit dem angegebenen Schlüssel, dem Text und dem 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)

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);
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 für das Element anzuzeigende Text.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem-Objekt.

Hinweise

Sie können diese Version der Add -Methode verwenden, um eine neue ListViewItem zu erstellen, die einem ListView Steuerelement hinzugefügt werden soll. Der Text des neuen ListViewItem , das dem Steuerelement hinzugefügt wurde, basiert auf dem text -Parameter. Wenn Sie ein Image für das Element angeben möchten, verwenden Sie die Version der -Methode, die Add einen Imageindex als Parameter akzeptiert. Wenn Sie über ein vorhandenes ListViewItem verfügen, das Sie der Auflistung hinzufügen möchten, verwenden Sie die Version der -Methode, die Add als Parameter akzeptiert.ListViewItem

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder ListViewItemSorter festgelegt ist, wird die Liste sortiert, nachdem das Element hinzugefügt wurde. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie die Insert -Methode verwenden, um ein Element an einer bestimmten Position in die ListView einzufügen. Verwenden Sie AddRange die -Methode, um dem Steuerelement in einem einzelnen Vorgang einen Satz 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 , um zu verhindern, dass die ListView neu gezeichnet wird, bis alle Elemente hinzugefügt wurden. Beim Hinzufügen von Elementen zu ist ListViewes effizienter, zuerst die Elemente zu sortieren und dann neue Elemente hinzuzufügen.

Weitere Informationen

Gilt für:

Add(ListViewItem)

Fügt der Auflistung ein vorhandenes 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

Der der Auflistung hinzuzufügende ListViewItem.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem-Objekt.

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 manuell erstellt wurde, bevor sie der Auflistung hinzugefügt wurde. 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 als SortOrder.None oder ListViewItemSorter festgelegt ist, wird die Liste sortiert, nachdem das Element hinzugefügt wurde. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie die Insert -Methode verwenden, um ein Element an einer bestimmten Position in die ListView einzufügen. Verwenden Sie AddRange die -Methode, um dem Steuerelement in einem einzelnen Vorgang einen Satz 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 , um zu verhindern, dass die ListView neu gezeichnet wird, bis alle Elemente hinzugefügt wurden. Beim Hinzufügen von Elementen zu ist ListViewes effizienter, zuerst die Elemente zu sortieren und dann neue Elemente hinzuzufügen.

Diese Version der Add -Methode wird auch verwendet, um einem ListViewItemListViewGroupzuzuweisen.

Weitere Informationen

Gilt für:

Add(String, Int32)

Erstellt ein Element mit dem angegebenen Text und dem 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);
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, der für das Element angezeigt werden soll.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem-Objekt.

Hinweise

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

Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder ListViewItemSorter festgelegt ist, wird die Liste sortiert, nachdem das Element hinzugefügt wurde. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie die Insert -Methode verwenden, um ein Element an einer bestimmten Position in die ListView einzufügen. Verwenden Sie AddRange die -Methode, um dem Steuerelement in einem einzelnen Vorgang einen Satz 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 , um zu verhindern, dass die ListView neu gezeichnet wird, bis alle Elemente hinzugefügt wurden. Beim Hinzufügen von Elementen zu ist ListViewes effizienter, zuerst die Elemente zu sortieren und dann neue Elemente hinzuzufügen.

Weitere Informationen

Gilt für:

Add(String, String)

Erstellt ein Element mit dem angegebenen Text und dem 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);
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, der für das Element angezeigt werden soll.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem.

Hinweise

Wenn sortiert ListView wird, wird das Element in der ordnungsgemäß sortierten Reihenfolge hinzugefügt, andernfalls wird es am Ende der Auflistung hinzugefügt.

Gilt für:

Add(String, String, Int32)

Erstellt ein Element mit dem angegebenen Schlüssel, dem Text und dem 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);
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, der für das Element angezeigt werden soll.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem.

Ausnahmen

Die enthaltende ListView befindet sich im virtuellen Modus.

Hinweise

Wenn sortiert ListView wird, wird das Element in der ordnungsgemäß sortierten Reihenfolge hinzugefügt, andernfalls wird es am Ende der Auflistung hinzugefügt. Die Name -Eigenschaft entspricht dem Schlüssel für ein ListViewItem in der ListView.ListViewItemCollection.

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

Gilt für:

Add(String, String, String)

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);
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, der für das Element angezeigt werden soll.

Gibt zurück

Das der Auflistung hinzugefügte ListViewItem.

Hinweise

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

Wenn sortiert ListView wird, wird das Element in der ordnungsgemäß 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 anhand seines Indexes oder anhand des Schlüssels abgerufen werden kann.

Gilt für: