InstanceDataCollection.CopyTo(InstanceData[], Int32) Method

Definition

Copies the items in the collection to the specified one-dimensional array at the specified index.

public:
 void CopyTo(cli::array <System::Diagnostics::InstanceData ^> ^ instances, int index);
public void CopyTo (System.Diagnostics.InstanceData[] instances, int index);
override this.CopyTo : System.Diagnostics.InstanceData[] * int -> unit
Public Sub CopyTo (instances As InstanceData(), index As Integer)

Parameters

instances
InstanceData[]

The one-dimensional Array that is the destination of the values copied from the collection.

index
Int32

The zero-based index value at which to add the new instances.

Examples

The following code example uses the CopyTo method to convert an InstanceDataCollection into an array of InstanceData objects. The values of the InstanceName and Sample properties of each element of the array are passed to a function for further processing.

// Display the contents of an InstanceDataCollection.
public static void ProcessInstanceDataCollection(InstanceDataCollection idCol)
{

    InstanceData[] instDataArray = new InstanceData[idCol.Count];

    Console.WriteLine("  InstanceDataCollection for \"{0}\" " +
        "has {1} elements.", idCol.CounterName, idCol.Count);

    // Copy and process the InstanceData array.
    idCol.CopyTo(instDataArray, 0);

    int idX;
    for(idX=0; idX<instDataArray.Length; idX++)
    {
        ProcessInstanceDataObject(instDataArray[idX].InstanceName, instDataArray[idX].Sample);
    }
}
' Display the contents of an InstanceDataCollection.
Sub ProcessInstanceDataCollection(ByVal idCol As InstanceDataCollection)

    Dim instDataArray(idCol.Count - 1) As InstanceData

    Console.WriteLine("  InstanceDataCollection for ""{0}"" " & _
        "has {1} elements.", idCol.CounterName, idCol.Count)

    ' Copy and process the InstanceData array.
    idCol.CopyTo(instDataArray, 0)

    Dim idX As Integer
    For idX = 0 To instDataArray.Length - 1
        ProcessInstanceDataObject(instDataArray(idX).InstanceName, _
            instDataArray(idX).Sample)
    Next idX
End Sub

Applies to