Esta documentación está archivada y no tiene mantenimiento.

PerformanceCounterCategory.ReadCategory (Método)

Lee todos los datos sobre el contador y la instancia de objeto de rendimiento asociados a esta categoría de contador de rendimiento.

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

public InstanceDataCollectionCollection ReadCategory ()
public InstanceDataCollectionCollection ReadCategory ()
public function ReadCategory () : InstanceDataCollectionCollection

Valor devuelto

InstanceDataCollectionCollection que contiene los datos sobre el contador y la instancia de objeto de rendimiento asociados a la categoría.

Tipo de excepciónCondición

InvalidOperationException

El valor de la propiedad CategoryName es referencia de objeto null (Nothing en Visual Basic). Es posible que no se haya establecido la propiedad.

Win32Exception

Se ha producido un error en la llamada a una API del sistema subyacente.

Debe establecer la propiedad CategoryName antes de llamar a ReadCategory.

La lectura de la toda categoría de una sola vez puede ser tan eficaz como la lectura un solo contador, por la forma en que el sistema proporciona los datos.

En el ejemplo de código siguiente se crea una PerformanceCounterCategory para el nombre de PerformanceCounterCategory especificado. A continuación, se utiliza el método ReadCategory para que se devuelva una InstanceDataCollectionCollection con los datos de todas las instancias de los objetos PerformanceCounter en la PerformanceCounterCategory.


' Process the InstanceDataCollectionCollection for this category.
Dim pcc As New PerformanceCounterCategory(categoryName)
Dim idColCol As InstanceDataCollectionCollection = pcc.ReadCategory()
Dim idColArray(idColCol.Count - 1) As InstanceDataCollection

Console.WriteLine("InstanceDataCollectionCollection for ""{0}"" " & _
    "has {1} elements.", categoryName, idColCol.Count)

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

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0
Mostrar: