PerformanceCounterInstaller Classe
Définition
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
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) |