Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método PerformanceCounterCategory.ReadCategory ()

 

Publicado: octubre de 2016

Lee todos los contadores y el rendimiento objeto instancia datos que está asociados a esta categoría de contador de rendimiento.

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

Public Function ReadCategory As InstanceDataCollectionCollection

Valor devuelto

Type: System.Diagnostics.InstanceDataCollectionCollection

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

Exception Condition
InvalidOperationException

La propiedad CategoryName es null. Puede que no se ha establecido la propiedad.

Win32Exception

Error en una llamada a una API del sistema subyacente.

UnauthorizedAccessException

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

Debe establecer el CategoryName propiedad antes de llamar a ReadCategory.

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

System_CAPS_noteNota

Para leer los contadores de rendimiento en Windows Vista y versiones posteriores, Windows XP Professional x64 Edition o Windows Server 2003, debe ser miembro del grupo usuarios del Monitor de rendimiento o tener privilegios administrativos.

Para evitar tener que elevar sus privilegios para tener acceso a los contadores de rendimiento en Windows Vista y versiones posteriores, agréguese al grupo usuarios del 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 tiene acceso a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a 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.

En el ejemplo de código siguiente se crea un PerformanceCounterCategory para un elemento PerformanceCounterCategory nombre. A continuación, se utiliza ReadCategory para devolver un InstanceDataCollectionCollection que contiene los datos de instancia para todas las instancias de la PerformanceCounter objetos dentro de 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)

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: