InstanceDataCollection.CopyTo(InstanceData[], Int32) Method

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

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