PerformanceCounterInstaller Classe

Référence

Définition

Espace de noms:: System.Diagnostics

Assembly:: System.Configuration.Install.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie un programme d’installation pour le composant 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

Héritage: Object

MarshalByRefObject

Component

Installer

ComponentInstaller
PerformanceCounterInstaller

Exemples

L’exemple de code suivant montre comment créer un PerformanceCounterInstaller objet et l’ajouter à un 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

Remarques

Les informations suivantes peuvent vous aider à améliorer les performances lors de l’installation des compteurs de performances au démarrage de l’application. Les catégories de compteurs de performances installées avec .NET Framework version 2.0 utilisent des mémoires partagées distinctes, chaque catégorie de compteurs de performances ayant sa propre mémoire. Vous pouvez spécifier la taille de la mémoire partagée distincte en créant un DWORD nommé FileMappingSize dans la clé de Registre HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<nom> de catégorie\Performance. La valeur FileMappingSize est définie sur la taille de mémoire partagée de la catégorie. La taille par défaut est 131072 décimale. Si la valeur FileMappingSize n’est pas présente, la fileMappingSize valeur d’attribut de l’élément performanceCounters spécifié dans le fichier Machine.config est utilisée, ce qui entraîne une surcharge supplémentaire pour le traitement des fichiers de configuration. Vous pouvez améliorer les performances du démarrage de l’application en définissant la taille du mappage de fichiers dans le Registre.

Constructeurs

PerformanceCounterInstaller()

Initialise une nouvelle instance de la classe PerformanceCounterInstaller.

Propriétés

CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
CategoryHelp	Obtient ou définit le message descriptif du compteur de performance.
CategoryName	Obtient ou définit le nom de la catégorie de performance du compteur de performance.
CategoryType	Obtient ou définit le type de catégorie du compteur de performance.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
Context	Obtient ou définit des informations sur l'installation en cours. (Hérité de Installer)
Counters	Obtient une collection de données relative aux compteurs à installer.
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
HelpText	Obtient le texte d’aide pour tous les programmes d’installation de la collection de programmes d’installation. (Hérité de Installer)
Installers	Obtient la collection de programmes d’installation contenue dans ce programme d’installation. (Hérité de Installer)
Parent	Obtient ou définit le programme d'installation contenant la collection à laquelle appartient ce programme d'installation. (Hérité de Installer)
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
UninstallAction	Obtient une valeur qui indique si le compteur de performance doit être supprimé lors de la désinstallation.

Méthodes

Commit(IDictionary)	En cas de substitution dans une classe dérivée, termine la transaction d’installation. (Hérité de Installer)
CopyFromComponent(IComponent)	Copie toutes les propriétés du composant spécifié requis à un compteur de performance lors de l'installation.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Install(IDictionary)	Effectue l'installation.
IsEquivalentInstaller(ComponentInstaller)	Détermine si le programme d'installation spécifié installe le même objet que ce programme d'installation. (Hérité de ComponentInstaller)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
OnAfterInstall(IDictionary)	Déclenche l’événement AfterInstall. (Hérité de Installer)
OnAfterRollback(IDictionary)	Déclenche l’événement AfterRollback. (Hérité de Installer)
OnAfterUninstall(IDictionary)	Déclenche l’événement AfterUninstall. (Hérité de Installer)
OnBeforeInstall(IDictionary)	Déclenche l’événement BeforeInstall. (Hérité de Installer)
OnBeforeRollback(IDictionary)	Déclenche l’événement BeforeRollback. (Hérité de Installer)
OnBeforeUninstall(IDictionary)	Déclenche l’événement BeforeUninstall. (Hérité de Installer)
OnCommitted(IDictionary)	Déclenche l’événement Committed. (Hérité de Installer)
OnCommitting(IDictionary)	Déclenche l’événement Committing. (Hérité de Installer)
Rollback(IDictionary)	Restaure l'état qui était celui de l'ordinateur avant l'installation.
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)
Uninstall(IDictionary)	Supprime une installation.

Événements

AfterInstall	Se produit après l'exécution des méthodes Install(IDictionary) de tous les programmes d'installation de la propriété Installers. (Hérité de Installer)
AfterRollback	Se produit après la restauration des installations de tous les programmes d'installation de la propriété Installers. (Hérité de Installer)
AfterUninstall	Se produit une fois que tous les programmes d'installation de la propriété Installers ont effectué leurs propres opérations de désinstallation. (Hérité de Installer)
BeforeInstall	Se produit avant l’exécution de la méthode Install(IDictionary) de chaque programme d’installation contenu dans la collection de programmes d’installation. (Hérité de Installer)
BeforeRollback	Se produit avant la restauration des programmes d'installation de la propriété Installers. (Hérité de Installer)
BeforeUninstall	Se produit avant que les programmes d'installation de la propriété Installers aient effectué leurs propres opérations de désinstallation. (Hérité de Installer)
Committed	Se produit après la validation de l'installation de tous les programmes d'installation de la propriété Installers. (Hérité de Installer)
Committing	Se produit avant la validation de l’installation des programmes d’installation de la propriété Installers. (Hérité de Installer)
Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)

S’applique à