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.Delete (String)

 

Publicado: octubre de 2016

Quita la categoría y sus contadores asociados desde el equipo local.

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

Public Shared Sub Delete (
	categoryName As String
)

Parámetros

categoryName
Type: System.String

El nombre de la categoría de contador de rendimiento personalizados para eliminar.

Exception Condition
ArgumentNullException

El parámetro categoryName es null.

ArgumentException

El categoryName parámetro tiene una sintaxis no válida. Podría contener caracteres de barra diagonal inversa ("\") o tiene longitud supere los 80 caracteres.

Win32Exception

Error en una llamada a una API del sistema subyacente.

InvalidOperationException

No se puede eliminar la categoría porque no es una categoría personalizada.

UnauthorizedAccessException

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

Puede eliminar categorías de contador de rendimiento personalizado sólo desde el sistema. No se puede eliminar un contador de una categoría. Para ello, elimine la categoría y volver a crearla con los contadores que desea conservar. Para evitar una excepción, confirme que la categoría existe antes de intentar eliminarlo.

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.

El siguiente ejemplo de código utiliza el Delete método para eliminar un PerformanceCounterCategory y PerformanceCounter objetos que contiene.

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""

    ' Copy the supplied argument into the local variable.
    Try
        categoryName = args(0)
    Catch ex As Exception
        Console.WriteLine("Missing argument identifying category to be deleted.")
    End Try

    ' Delete the specified category.
    Try
        If (PerformanceCounterCategory.Exists(categoryName)) Then
            PerformanceCounterCategory.Delete(categoryName)
            Console.WriteLine( _
                "Category ""{0}"" deleted from this computer.", categoryName)
        Else
            Console.WriteLine("Category name not found")
        End If

    Catch ex As Exception
        Console.WriteLine("Unable to delete " & _
            "category ""{0}"" from this computer:" & vbCrLf & _
            ex.Message, categoryName)
    End Try
End Sub

PerformanceCounterPermission

for reading performance counter categories. Associated enumeration: F:System.Diagnostics.PerformanceCounterPermissionAccess.Administer.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: