Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ListView.ListViewItemCollection.AddRange-Methode: (ListViewItem[])

 

Veröffentlicht: Oktober 2016

Fügt ein Array von ListViewItem -Objekte der Auflistung.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void AddRange(
	ListViewItem[] items
)

Parameter

items
Type: System.Windows.Forms.ListViewItem[]

Ein Array von ListViewItem-Objekten, die der Auflistung hinzugefügt werden sollen.

Exception Condition
ArgumentNullException

items ist null.

Sie können diese Methode verwenden, Elemente aus einem anderen wiederverwenden ListView Steuerelement. Wenn Sie ein einzelnes hinzufügen möchten ListViewItem, verwenden Sie die Add Methode. Sie können auch die Insert Methode, wenn Sie ein einzelnes hinzufügen möchten ListViewItem an einer bestimmten Position in der Auflistung.

Sie können diese Methode auch verwenden, auf mehrere weisen ListViewItem -Objekte eine ListViewGroup.

Wenn die ListView.Sorting Eigenschaft auf einen Wert festgelegt ist als SortOrder.None oder, wenn die ListViewItemSorter -Eigenschaft festgelegt ist, die Liste nach dem Hinzufügen der Elemente sortiert. Andernfalls werden die Elemente am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie die Insert Methode zum Einfügen von Elementen in der ListView an bestimmten Positionen.

Das folgende Beispiel erstellt eine ListView -Steuerelement mit drei ListViewItem angegebenen Objekte und drei ListViewItem.ListViewSubItem für jedes Element angegebenen Objekte. Im Beispiel wird auch erstellt ColumnHeader Objekte die Unterelemente in der Detailansicht angezeigt. Zwei ImageList Objekte werden auch erstellt, im Beispiel zum Bereitstellen von Abbildern für die ListViewItem Objekte. Diese ImageList Objekte werden hinzugefügt, um die LargeImageList und SmallImageList Eigenschaften. Das Beispiel verwendet die folgenden Eigenschaften bei der Erstellung der ListView Steuerelement:

Dieses Beispiel ist es erforderlich, dass Sie den Code hinzugefügt haben eine Form und -Methode im Beispiel aus dem Konstruktor oder eine andere Methode auf dem Formular erstellt. Das Beispiel erfordert auch, dass Bilder mit dem Namen MySmallImage1, MySmallImage2, MyLargeImage1, und MyLargeImage2 befinden sich im Stammverzeichnis von Laufwerk C.

private void CreateMyListView()
{
	// Create a new ListView control.
	ListView listView1 = new ListView();
	listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

	// Set the view to show details.
	listView1.View = View.Details;
	// Allow the user to edit item text.
	listView1.LabelEdit = true;
	// Allow the user to rearrange columns.
	listView1.AllowColumnReorder = true;
	// Display check boxes.
	listView1.CheckBoxes = true;
	// Select the item and subitems when selection is made.
	listView1.FullRowSelect = true;
	// Display grid lines.
	listView1.GridLines = true;
	// Sort the items in the list in ascending order.
	listView1.Sorting = SortOrder.Ascending;

	// Create three items and three sets of subitems for each item.
	ListViewItem item1 = new ListViewItem("item1",0);
	// Place a check mark next to the item.
	item1.Checked = true;
	item1.SubItems.Add("1");
	item1.SubItems.Add("2");
	item1.SubItems.Add("3");
	ListViewItem item2 = new ListViewItem("item2",1);
	item2.SubItems.Add("4");
	item2.SubItems.Add("5");
	item2.SubItems.Add("6");
	ListViewItem item3 = new ListViewItem("item3",0);
	// Place a check mark next to the item.
	item3.Checked = true;
	item3.SubItems.Add("7");
	item3.SubItems.Add("8");
	item3.SubItems.Add("9");

	// Create columns for the items and subitems.
	// Width of -2 indicates auto-size.
	listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

	//Add the items to the ListView.
          		listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

	// Create two ImageList objects.
	ImageList imageListSmall = new ImageList();
	ImageList imageListLarge = new ImageList();

	// Initialize the ImageList objects with bitmaps.
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

	//Assign the ImageList objects to the ListView.
	listView1.LargeImageList = imageListLarge;
	listView1.SmallImageList = imageListSmall;

	// Add the ListView to the control collection.
	this.Controls.Add(listView1);
}

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: