ListBox.ObjectCollection.Add-Methode

Wenn die Sorted-Eigenschaft von ListBox auf true festgelegt ist, wird das Element gemäß der alphabetischen Reihenfolge in die Liste eingefügt. Andernfalls wird das Element am Ende der Liste eingefügt. Um ein Element am angegebenen Index in das Listenfeld einzufügen, verwenden Sie die Insert-Methode. Um eine Gruppe von Elementen auf einmal in das Listenfeld einzufügen, verwenden Sie die AddRange-Methode. Wenn Sie der Liste eine große Zahl von Elementen mit der Add-Methode hinzufügen möchten, verwenden Sie die BeginUpdate-Methode und die EndUpdate-Methode, damit die ListBox nicht jedes Mal, wenn der Liste ein Element hinzugefügt wird, neu gezeichnet wird, bis alle Elemente der Liste hinzugefügt sind. Wenn Sie einer ListBox Elemente hinzufügen, ist es effizienter, diese zunächst zu sortieren und anschließend neue Elemente hinzuzufügen.

Wenn der Auflistung ein Objekt hinzugefügt wird, überprüft ListBox zuerst, ob die DisplayMember-Eigenschaft der ListControl-Klasse den Namen eines Members des angegebenen Objekts enthält, auf das zum Abrufen des Elementtexts verwiesen wird. Wenn für die DisplayMember-Eigenschaft kein Member angegeben ist, ruft ListBox die ToString-Methode des Objekts auf, um den Text abzurufen, der in der Liste angezeigt werden soll.

Im folgenden Codebeispiel wird veranschaulicht, wie ein ListBox-Steuerelement erstellt wird, das mehrere Elemente in Spalten anzeigt und in dessen Liste mehrere Elemente ausgewählt werden können. Im Code für das Beispiel werden der ListBox 50 Elemente mithilfe der Add-Methode der ListBox.ObjectCollection-Klasse hinzugefügt. Anschließend werden drei Elemente aus der Liste mithilfe der SetSelected-Methode ausgewählt. Im Code werden dann über die SelectedItems-Eigenschaft Werte aus der ListBox.SelectedObjectCollection-Auflistung sowie über die SelectedIndices-Eigenschaft Werte aus ListBox.SelectedIndexCollection angezeigt. In diesem Beispiel muss sich der Code in einem Form befinden und aus diesem aufgerufen werden.

private void button1_Click(object sender, System.EventArgs e)
{
   // Create an instance of the ListBox.
   ListBox listBox1 = new ListBox();
   // Set the size and location of the ListBox.
   listBox1.Size = new System.Drawing.Size(200, 100);
   listBox1.Location = new System.Drawing.Point(10,10);
   // Add the ListBox to the form.
   this.Controls.Add(listBox1);
   // Set the ListBox to display items in multiple columns.
   listBox1.MultiColumn = true;
   // Set the selection mode to multiple and extended.
   listBox1.SelectionMode = SelectionMode.MultiExtended;

   // Shutdown the painting of the ListBox as items are added.
   listBox1.BeginUpdate();
   // Loop through and add 50 items to the ListBox.
   for (int x = 1; x <= 50; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());
   }
   // Allow the ListBox to repaint and display the new items.
   listBox1.EndUpdate();

   // Select three items from the ListBox.
   listBox1.SetSelected(1, true);
   listBox1.SetSelected(3, true);
   listBox1.SetSelected(5, true);

   // Display the second selected item in the ListBox to the console.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems[1].ToString());
   // Display the index of the first selected item in the ListBox.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices[0].ToString());             
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz