PerformanceCounterCategory.ReadCategory Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Paquete:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounterCategory.cs

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

public:
 System::Diagnostics::InstanceDataCollectionCollection ^ ReadCategory();

public System.Diagnostics.InstanceDataCollectionCollection ReadCategory ();

member this.ReadCategory : unit -> System.Diagnostics.InstanceDataCollectionCollection

Public Function ReadCategory () As InstanceDataCollectionCollection

Devoluciones

InstanceDataCollectionCollection

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

Excepciones

InvalidOperationException

La propiedad CategoryName es null. Es posible que no se haya establecido la propiedad.

Win32Exception

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

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos para intentar leer un contador de rendimiento.

Ejemplos

En el ejemplo de código siguiente se crea un PerformanceCounterCategory objeto para un nombre especificado PerformanceCounterCategory . A continuación, usa ReadCategory para devolver un InstanceDataCollectionCollection objeto que contiene datos de instancia para todas las instancias de los PerformanceCounter objetos dentro de PerformanceCounterCategory.

// Process the InstanceDataCollectionCollection for this category.
PerformanceCounterCategory pcc = new PerformanceCounterCategory(categoryName);
InstanceDataCollectionCollection idColCol = pcc.ReadCategory();
InstanceDataCollection[] idColArray = new InstanceDataCollection[idColCol.Count];

Console.WriteLine("InstanceDataCollectionCollection for \"{0}\" " +
    "has {1} elements.", categoryName, idColCol.Count);

' 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)

Comentarios

Debe establecer la CategoryName propiedad antes de llamar a ReadCategory.

Leer toda la categoría a la vez puede ser tan eficaz como leer un solo contador debido a la forma en que el sistema proporciona los datos.

Nota

Para leer contadores de rendimiento de una sesión de inicio de sesión no interactiva en Windows Vista y versiones posteriores, Windows XP Professional x64 Edition o Windows Server 2003, debe ser miembro del grupo Usuarios de Monitor de rendimiento o tener privilegios administrativos.

Para evitar tener que elevar los privilegios para acceder a los contadores de rendimiento en Windows Vista y versiones posteriores, agréguese al grupo usuarios de Monitor de rendimiento.

En Windows Vista y versiones posteriores, el Control de cuentas de usuario (UAC) determina los privilegios de un usuario. Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador. De forma predeterminada, se le asignará el rol de usuario estándar. Para ejecutar el código que accede a los contadores de rendimiento, primero debe elevar los privilegios del usuario estándar al administrador. Para ello, inicie una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indique que desea ejecutarla como administrador.

Consulte también

• InstanceDataCollectionCollection
• InstanceDataCollection
• InstanceData