PerformanceCounterInstaller Classe

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics

Assembly:: System.Configuration.Install.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica un programma di installazione per il 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

Ereditarietà: Object

MarshalByRefObject

Component

Installer

ComponentInstaller
PerformanceCounterInstaller

Esempio

Nell'esempio di codice seguente viene illustrato come creare un PerformanceCounterInstaller oggetto e aggiungerlo a un oggetto 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

Commenti

Le informazioni seguenti potrebbero contribuire a migliorare le prestazioni durante l'installazione dei contatori delle prestazioni all'avvio dell'applicazione. Le categorie di contatori delle prestazioni installate con .NET Framework versione 2.0 usano memorie condivise separate, con ogni categoria di contatori delle prestazioni con una propria memoria. È possibile specificare le dimensioni della memoria condivisa separata creando un DWORD denominato FileMappingSize nella chiave del Registro di sistema HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<nome> categoria\Prestazioni. Il valore FileMappingSize viene impostato sulle dimensioni della memoria condivisa della categoria. La dimensione predefinita è 131072 decimale. Se il valore FileMappingSize non è presente, viene utilizzato il fileMappingSize valore dell'attributo per l'elemento specificato nel file Machine.config, causando un sovraccarico aggiuntivo per l'elaborazione performanceCounters dei file di configurazione. È possibile ottenere un miglioramento delle prestazioni per l'avvio dell'applicazione impostando le dimensioni del mapping dei file nel Registro di sistema.

Costruttori

PerformanceCounterInstaller()

Inizializza una nuova istanza della classe PerformanceCounterInstaller.

Proprietà

CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
CategoryHelp	Ottiene o imposta il messaggio descrittivo del contatore delle prestazioni.
CategoryName	Ottiene o imposta il nome di categoria delle prestazioni del contatore delle prestazioni.
CategoryType	Ottiene o imposta il tipo di categoria del contatore delle prestazioni.
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
Context	Ottiene o imposta le informazioni sull'installazione corrente. (Ereditato da Installer)
Counters	Ottiene un insieme di dati pertinenti ai contatori da installare.
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
HelpText	Ottiene il testo della Guida per tutti i programmi di installazione della raccolta Installer. (Ereditato da Installer)
Installers	Ottiene la raccolta dei programmi di installazione contenuti nel programma. (Ereditato da Installer)
Parent	Ottiene o imposta il programma di installazione contenente la raccolta cui appartiene questo programma di installazione. (Ereditato da Installer)
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
UninstallAction	Ottiene un valore che indica se il contatore delle prestazioni deve essere rimosso in fase di disinstallazione.

Metodi

Commit(IDictionary)	Quando ne viene eseguito l'override in una classe derivata, completa la transazione di installazione. (Ereditato da Installer)
CopyFromComponent(IComponent)	Copia tutte le proprietà del componente specificato che sono richieste in fase di installazione del contatore delle prestazioni.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite. (Ereditato da Component)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
Install(IDictionary)	Esegue l'installazione.
IsEquivalentInstaller(ComponentInstaller)	Determina se il programma di installazione specificato consente di installare lo stesso oggetto del programma di installazione corrente. (Ereditato da ComponentInstaller)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnAfterInstall(IDictionary)	Genera l'evento AfterInstall. (Ereditato da Installer)
OnAfterRollback(IDictionary)	Genera l'evento AfterRollback. (Ereditato da Installer)
OnAfterUninstall(IDictionary)	Genera l'evento AfterUninstall. (Ereditato da Installer)
OnBeforeInstall(IDictionary)	Genera l'evento BeforeInstall. (Ereditato da Installer)
OnBeforeRollback(IDictionary)	Genera l'evento BeforeRollback. (Ereditato da Installer)
OnBeforeUninstall(IDictionary)	Genera l'evento BeforeUninstall. (Ereditato da Installer)
OnCommitted(IDictionary)	Genera l'evento Committed. (Ereditato da Installer)
OnCommitting(IDictionary)	Genera l'evento Committing. (Ereditato da Installer)
Rollback(IDictionary)	Ripristina lo stato in cui si trovava il computer prima dell'installazione.
ToString()	Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
Uninstall(IDictionary)	Rimuove un'installazione.

Eventi

AfterInstall	Si verifica dopo l'esecuzione dei metodi Install(IDictionary) di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
AfterRollback	Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
AfterUninstall	Si verifica dopo l'esecuzione delle operazioni di disinstallazione di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
BeforeInstall	Si verifica dopo l'esecuzione del metodo Install(IDictionary) di ogni programma di installazione contenuto nella raccolta Installer. (Ereditato da Installer)
BeforeRollback	Si verifica prima del rollback dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
BeforeUninstall	Si verifica prima dell'esecuzione delle operazioni di disinstallazione dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
Committed	Si verifica dopo l'esecuzione del commit delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
Committing	Si verifica prima dell'esecuzione del commit delle installazioni dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)

Si applica a