ListItemCollection.CopyTo(Array, Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Copies the items from the ListItemCollection to the specified Array, starting with the specified index.
public:
virtual void CopyTo(Array ^ array, int index);
public void CopyTo (Array array, int index);
abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit
Public Sub CopyTo (array As Array, index As Integer)
Parameters
- array
- Array
A zero-based Array that receives the copied items from the ListItemCollection.
Implements
Examples
// Copy the items in the ListItemCollection to an array before
// deleting them.
ListItem[] myListItemArray = new ListItem[ListBox1.Items.Count];
ListBox1.Items.CopyTo(myListItemArray, 0);
// Delete all the items from the ListBox.
ListBox1.Items.Clear();
DeleteLabel.Text = "<b>All items in the ListBox were deleted successfully."
+ "</b><br /><b>The deleted items are:";
String listResults="";
foreach(ListItem myItem in myListItemArray)
{
listResults = listResults + myItem.Text + "<br />";
}
ResultsLabel.Text = listResults;
' Copy the items in the ListListBox1.Items to an array before
' deleting them.
Dim myListItemArray(ListBox1.Items.Count - 1) As ListItem
ListBox1.Items.CopyTo(myListItemArray, 0)
' Delete all the items from the ListBox.
ListBox1.Items.Clear()
DeleteLabel.Text = "<b>All items in the ListBox were deleted successfully." & _
"</b><br /><b>The deleted items are:"
Dim listResults As [String] = ""
Dim myItem2 As ListItem
For Each myItem2 In myListItemArray
listResults = listResults & myItem2.Text & "<br />"
Next myItem2
ResultsLabel.Text = listResults
Remarks
Use this method to copy the contents of the ListItemCollection into the specified System.Array, starting at the specified index.
Note
The array
parameter must be a zero-based System.Array.