PerformanceCounterInstaller Clase

Referencia

Definición

Espacio de nombres:: System.Diagnostics

Ensamblado:: System.Configuration.Install.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Especifica un instalador para el componente PerformanceCounter .

public ref class PerformanceCounterInstaller : System::Configuration::Install::ComponentInstaller

public class PerformanceCounterInstaller : System.Configuration.Install.ComponentInstaller

type PerformanceCounterInstaller = class
    inherit ComponentInstaller

Public Class PerformanceCounterInstaller
Inherits ComponentInstaller

Herencia: Object

MarshalByRefObject

Component

Installer

ComponentInstaller
PerformanceCounterInstaller

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un PerformanceCounterInstaller objeto y agregarlo a .InstallerCollection

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

[RunInstaller(true)]
ref class MyPerformanceCounterInstaller: public Installer
{
public:
   MyPerformanceCounterInstaller()
   {
      try
      {
         // Create an instance of 'PerformanceCounterInstaller'.
         PerformanceCounterInstaller^ myPerformanceCounterInstaller =
            gcnew PerformanceCounterInstaller;
         // Set the 'CategoryName' for performance counter.
         myPerformanceCounterInstaller->CategoryName =
            "MyPerformanceCounter";
         CounterCreationData^ myCounterCreation = gcnew CounterCreationData;
         myCounterCreation->CounterName = "MyCounter";
         myCounterCreation->CounterHelp = "Counter Help";
         // Add a counter to collection of  myPerformanceCounterInstaller.
         myPerformanceCounterInstaller->Counters->Add( myCounterCreation );
         Installers->Add( myPerformanceCounterInstaller );
      }
      catch ( Exception^ e ) 
      {
          this->Context->LogMessage( "Error occurred : " + e->Message );
      }
   }
};

using System;
using System.Configuration.Install;
using System.Diagnostics;
using System.ComponentModel;

[RunInstaller(true)]
public class MyPerformanceCounterInstaller : Installer
{
    public MyPerformanceCounterInstaller()
    {
        try
        {
            // Create an instance of 'PerformanceCounterInstaller'.
            PerformanceCounterInstaller myPerformanceCounterInstaller =
               new PerformanceCounterInstaller();
            // Set the 'CategoryName' for performance counter.
            myPerformanceCounterInstaller.CategoryName =
               "MyPerformanceCounter";
            CounterCreationData myCounterCreation = new CounterCreationData();
            myCounterCreation.CounterName = "MyCounter";
            myCounterCreation.CounterHelp = "Counter Help";
            // Add a counter to collection of  myPerformanceCounterInstaller.
            myPerformanceCounterInstaller.Counters.Add(myCounterCreation);
            Installers.Add(myPerformanceCounterInstaller);
        }
        catch (Exception e)
        {
            this.Context.LogMessage("Error occurred :" + e.Message);
        }
    }
    public static void Main()
    {
    }
}

Imports System.Configuration.Install
Imports System.Diagnostics
Imports System.ComponentModel

<RunInstaller(True)> _
Public Class MyPerformanceCounterInstaller
    Inherits Installer
    Public Sub New()
        Try
            ' Create an instance of 'PerformanceCounterInstaller'.
            Dim myPerformanceCounterInstaller As New PerformanceCounterInstaller()
            ' Set the 'CategoryName' for performance counter.
            myPerformanceCounterInstaller.CategoryName = "MyPerformanceCounter"
            Dim myCounterCreation As New CounterCreationData()
            myCounterCreation.CounterName = "MyCounter"
            myCounterCreation.CounterHelp = "Counter Help"
            ' Add a counter to collection of  myPerformanceCounterInstaller.
            myPerformanceCounterInstaller.Counters.Add(myCounterCreation)
            Installers.Add(myPerformanceCounterInstaller)
        Catch e As Exception
            Me.Context.LogMessage("Error occurred :" + e.Message)
        End Try
    End Sub
    Public Shared Sub Main()
    End Sub
End Class

Comentarios

La siguiente información puede ayudar a proporcionar una mejora del rendimiento al instalar contadores de rendimiento en el inicio de la aplicación. Las categorías de contadores de rendimiento instaladas con .NET Framework versión 2.0 usan memorias compartidas independientes, con cada categoría de contador de rendimiento con su propia memoria. Puede especificar el tamaño de la memoria compartida independiente mediante la creación de un DWORD denominado FileMappingSize en la clave del Registro HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\nombre> de< categoría\Performance. El valor FileMappingSize se establece en el tamaño de memoria compartida de la categoría. El tamaño predeterminado es 131072 decimal. Si el valor FileMappingSize no está presente, se usa el valor de fileMappingSize atributo del elemento especificado en el archivo Machine.config, lo que provoca una sobrecarga adicional para el performanceCounters procesamiento de archivos de configuración. Puede realizar una mejora del rendimiento para el inicio de la aplicación estableciendo el tamaño de asignación de archivos en el Registro.

Constructores

PerformanceCounterInstaller()

Inicializa una nueva instancia de la clase PerformanceCounterInstaller.

Propiedades

CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
CategoryHelp	Obtiene o establece el mensaje descriptivo para el contador de rendimiento.
CategoryName	Obtiene o establece el nombre de la categoría (CategoryName) de rendimiento para el contador de rendimiento.
CategoryType	Obtiene o establece el tipo de categoría del contador de rendimiento.
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
Context	Obtiene o establece información sobre la instalación actual. (Heredado de Installer)
Counters	Obtiene una colección de datos relacionados con los contadores que se van a instalar.
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
HelpText	Obtiene el texto de ayuda de todos los instaladores que se encuentran en la colección de instaladores. (Heredado de Installer)
Installers	Obtiene la colección de instaladores que contiene este instalador. (Heredado de Installer)
Parent	Obtiene o establece el instalador que contiene la colección a la que pertenece este instalador. (Heredado de Installer)
Site	Obtiene o establece ISite de Component. (Heredado de Component)
UninstallAction	Obtiene un valor que indica si el contador de rendimiento debe quitarse en el momento de la desinstalación.

Métodos

Commit(IDictionary)	Cuando se reemplaza en una clase derivada, finaliza la transacción de instalación. (Heredado de Installer)
CopyFromComponent(IComponent)	Copia todas las propiedades del componente especificado requeridas por el contador de rendimiento en el momento de su instalación.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
Install(IDictionary)	Realiza la instalación.
IsEquivalentInstaller(ComponentInstaller)	Determina si el instalador especificado instala el mismo objeto que este instalador. (Heredado de ComponentInstaller)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnAfterInstall(IDictionary)	Genera el evento AfterInstall. (Heredado de Installer)
OnAfterRollback(IDictionary)	Genera el evento AfterRollback. (Heredado de Installer)
OnAfterUninstall(IDictionary)	Genera el evento AfterUninstall. (Heredado de Installer)
OnBeforeInstall(IDictionary)	Genera el evento BeforeInstall. (Heredado de Installer)
OnBeforeRollback(IDictionary)	Genera el evento BeforeRollback. (Heredado de Installer)
OnBeforeUninstall(IDictionary)	Genera el evento BeforeUninstall. (Heredado de Installer)
OnCommitted(IDictionary)	Genera el evento Committed. (Heredado de Installer)
OnCommitting(IDictionary)	Genera el evento Committing. (Heredado de Installer)
Rollback(IDictionary)	Restaura el estado en el que estaba el equipo antes de la instalación.
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)
Uninstall(IDictionary)	Quita una instalación.

Eventos

AfterInstall	Se produce después de ejecutarse los métodos Install(IDictionary) de todos los instaladores de la propiedad Installers. (Heredado de Installer)
AfterRollback	Se produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers. (Heredado de Installer)
AfterUninstall	Se produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer)
BeforeInstall	Se produce antes de ejecutarse el método Install(IDictionary) de cada instalador en la colección de instaladores. (Heredado de Installer)
BeforeRollback	Se produce antes de deshacerse los instaladores de la propiedad Installers. (Heredado de Installer)
BeforeUninstall	Se produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer)
Committed	Se produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer)
Committing	Se produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer)
Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Se aplica a

Compartir a través de