Exportar (0) Imprimir
Expandir todo

InstanceDataCollectionCollection.Item (Propiedad)

Actualización: noviembre 2007

Obtiene los datos de instancia para el contador especificado.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

public InstanceDataCollection Item[
	string counterName
] { get; }
/** @property */
public InstanceDataCollection get_Item(
	String counterName
)

JScript no admite propiedades indizadas.

Parámetros

counterName
Tipo: System.String
Nombre del contador de rendimiento.

Valor de propiedad

Tipo: System.Diagnostics.InstanceDataCollection
Elemento de InstanceDataCollection por el que se indiza el objeto InstanceDataCollectionCollection.

ExcepciónCondición
ArgumentNullException

El valor del parámetro counterName es null.

El parámetro counterName no distingue entre mayúsculas y minúsculas.

Cada objeto InstanceDataCollection de la colección contiene los datos de rendimiento para todos los contadores de una instancia. Los datos se indizan por nombre de contador y, a continuación, por nombre de instancia. El indizador utiliza el parámetro counterName para recorrer los contadores asociados a esta recolección de datos de instancia.

En el código de ejemplo siguiente se acepta un nombre de categoría de la clase PerformanceCounter y un nombre de contador de la línea de comandos. Obtiene la colección InstanceDataCollectionCollection para el objeto PerformanceCounterCategory. A continuación, si PerformanceCounter existe, el ejemplo utiliza la propiedad Item (a la que se hace referencia como indizador) para obtener la colección InstanceDataCollection asociada y muestra los nombres de instancia de la colección.

public static void Main(string[] args)
{
    // The following values can be used as arguments.
    string categoryName = "Process";
    string counterName = "Private Bytes";

    InstanceDataCollectionCollection idColCol;

    // Copy the supplied arguments into the local variables.
    try
    {
        categoryName = args[0];
        counterName = args[1];
    }
    catch
    {
        // Ignore the exception from non-supplied arguments.
    }

    try
    {
        // Get the InstanceDataCollectionCollection for this category.
        PerformanceCounterCategory pcc = new PerformanceCounterCategory(categoryName);
        idColCol = pcc.ReadCategory();
    }
    catch(Exception ex)
    {
        Console.WriteLine("An error occurred getting the InstanceDataCollection for " +
            "category \"{0}\"."+ "\n" +ex.Message, categoryName);
        return;
    }

    // Check if this counter name exists using the Contains
    // method of the InstanceDataCollectionCollection.
    if (!idColCol.Contains(counterName))
    {
        Console.WriteLine("Counter \"{0}\" does not exist in category \"{1}\".", counterName, categoryName);
        return;
    }
    else
    {
        // Now get the counter's InstanceDataCollection object using the
        // indexer (Item property) for the InstanceDataCollectionCollection.
        InstanceDataCollection countData = idColCol[counterName];

        ICollection idColKeys = countData.Keys;
        string[] idColKeysArray = new string[idColKeys.Count];
        idColKeys.CopyTo(idColKeysArray, 0);

        Console.WriteLine("Counter \"{0}\" of category \"{1}\" " +
            "has {2} instances.", counterName, categoryName, idColKeys.Count);

        // Display the instance names for this counter.
        int index;
        for(index=0; index<idColKeysArray.Length; index++)
        {
            Console.WriteLine("{0,4} -- {1}", index+1, idColKeysArray[index]);
        }
    }
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft