PerformanceCounterInstaller Classe

Referência

Definição

Namespace:: System.Diagnostics

Assembly:: System.Configuration.Install.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica um instalador para o 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

Herança: Object

MarshalByRefObject

Component

Installer

ComponentInstaller
PerformanceCounterInstaller

Exemplos

O exemplo de código a seguir demonstra como criar um PerformanceCounterInstaller objeto e adicioná-lo a um 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

Comentários

As informações a seguir podem ajudar a fornecer uma melhoria de desempenho ao instalar contadores de desempenho na inicialização do aplicativo. As categorias de contador de desempenho instaladas com .NET Framework versão 2.0 usam memórias compartilhadas separadas, com cada categoria de contador de desempenho tendo sua própria memória. Você pode especificar o tamanho da memória compartilhada separada criando um DWORD chamado FileMappingSize na chave do Registro HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<nome> da categoria\Desempenho. O valor FileMappingSize é definido como o tamanho da memória compartilhada da categoria. O tamanho padrão é 131072 decimal. Se o valor FileMappingSize não estiver presente, o valor do fileMappingSize atributo para o performanceCounters elemento especificado no arquivo Machine.config será usado, causando sobrecarga adicional para o processamento do arquivo de configuração. Você pode realizar uma melhoria de desempenho para a inicialização do aplicativo definindo o tamanho do mapeamento de arquivo no Registro.

Construtores

PerformanceCounterInstaller()

Inicializa uma nova instância da classe PerformanceCounterInstaller.

Propriedades

CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
CategoryHelp	Obtém ou define a mensagem descritiva para o contador de desempenho.
CategoryName	Obtém ou define o nome da categoria de desempenho para o contador de desempenho.
CategoryType	Obtém ou define o tipo de categoria do contador de desempenho.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
Context	Obtém ou define informações sobre a instalação atual. (Herdado de Installer)
Counters	Obtém uma coleção de dados referentes aos contadores a instalar.
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
HelpText	Obtém o texto de ajuda para todos os instaladores na coleção de instalador. (Herdado de Installer)
Installers	Obtém a coleção de instaladores que contém esse instalador. (Herdado de Installer)
Parent	Obtém ou define o instalador que contém a coleção à qual o instalador pertence. (Herdado de Installer)
Site	Obtém ou define o ISite do Component. (Herdado de Component)
UninstallAction	Obtém um valor que indica se o contador de desempenho deve ser removido no momento da desinstalação.

Métodos

Commit(IDictionary)	Quando substituído em uma classe derivada, conclui a transação de instalação. (Herdado de Installer)
CopyFromComponent(IComponent)	Copia todas as propriedades do componente especificado que são necessárias no tempo de instalação para um contador de desempenho.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
Install(IDictionary)	Realiza a instalação.
IsEquivalentInstaller(ComponentInstaller)	Determina se o instalador especificado instala o mesmo objeto como este instalador. (Herdado de ComponentInstaller)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnAfterInstall(IDictionary)	Aciona o evento AfterInstall. (Herdado de Installer)
OnAfterRollback(IDictionary)	Aciona o evento AfterRollback. (Herdado de Installer)
OnAfterUninstall(IDictionary)	Aciona o evento AfterUninstall. (Herdado de Installer)
OnBeforeInstall(IDictionary)	Aciona o evento BeforeInstall. (Herdado de Installer)
OnBeforeRollback(IDictionary)	Aciona o evento BeforeRollback. (Herdado de Installer)
OnBeforeUninstall(IDictionary)	Aciona o evento BeforeUninstall. (Herdado de Installer)
OnCommitted(IDictionary)	Aciona o evento Committed. (Herdado de Installer)
OnCommitting(IDictionary)	Aciona o evento Committing. (Herdado de Installer)
Rollback(IDictionary)	Restaura o computador para o estado em que estava antes da instalação.
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)
Uninstall(IDictionary)	Remove uma instalação.

Eventos

AfterInstall	Ocorre depois que os métodos do Install(IDictionary) de todos os instaladores na propriedade Installers foram executados. (Herdado de Installer)
AfterRollback	Ocorre após as instalações de todos os instaladores na propriedade Installers serem revertidas. (Herdado de Installer)
AfterUninstall	Ocorre depois que todos os instaladores na propriedade Installers realizam suas operações de desinstalação. (Herdado de Installer)
BeforeInstall	Ocorre antes do método Install(IDictionary) de cada instalador no instalador em que a coleção foi executada. (Herdado de Installer)
BeforeRollback	Ocorre antes que os instaladores na propriedade Installers sejam revertidos. (Herdado de Installer)
BeforeUninstall	Ocorre antes dos instaladores na propriedade Installers executarem suas operações de desinstalação. (Herdado de Installer)
Committed	Ocorre depois que todos os instaladores na propriedade Installers confirmaram suas instalações. (Herdado de Installer)
Committing	Ocorre antes que os instaladores na propriedade Installers façam commit de suas instalações. (Herdado de Installer)
Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)

Aplica-se a

Compartilhar via