PerformanceCounterInstaller Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica um instalador para o PerformanceCounter componente.
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
Exemplos
O exemplo de código seguinte demonstra como criar um PerformanceCounterInstaller objeto e adicioná-lo a um InstallerCollection.
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
Observações
A informação seguinte pode ajudar a melhorar o desempenho ao instalar contadores de desempenho no arranque da aplicação. As categorias de contadores de desempenho instaladas com a versão 2.0 do .NET Framework usam memórias partilhadas separadas, sendo que cada categoria de contador de desempenho tem a sua própria memória. Pode especificar o tamanho da memória partilhada separada criando um DWORD chamado FileMappingSize na chave do registo HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<nome> da categoria\Performance. O valor FileMappingSize é definido para o tamanho da memória partilhada da categoria. O tamanho padrão é 131072 decimal. Se o valor FileMappingSize não estiver presente, o fileMappingSize valor do atributo para o performanceCounters elemento especificado no ficheiro de Machine.config é utilizado, causando sobrecarga adicional para o processamento de ficheiros de configuração. Pode obter uma melhoria de desempenho no arranque da aplicação definindo o tamanho do mapeamento do ficheiro no registo.
Construtores
| Name | Description |
|---|---|
| PerformanceCounterInstaller() |
Inicializa uma nova instância da PerformanceCounterInstaller classe. |
Propriedades
| Name | Description |
|---|---|
| CanRaiseEvents |
Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component) |
| CategoryHelp |
Recebe 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 relacionados com os contadores para instalar. |
| DesignMode |
Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component) |
| Events |
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| HelpText |
Recebe o texto de ajuda para todos os instaladores na coleção de instaladores. (Herdado de Installer) |
| Installers |
Fica com a coleção de instaladores que este instalador contém. (Herdado de Installer) |
| Parent |
Obtém ou define o instalador que contém a coleção a que este instalador pertence. (Herdado de Installer) |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| UninstallAction |
Recebe um valor que indica se o contador de desempenho deve ser removido no momento da desinstalação. |
Métodos
| Name | Description |
|---|---|
| Commit(IDictionary) |
Quando é sobreposto numa classe derivada, completa a transação de instalação. (Herdado de Installer) |
| CopyFromComponent(IComponent) |
Copia todas as propriedades do componente especificado que são necessárias no momento da instalação para um contador de desempenho. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos utilizados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos. (Herdado de Component) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Devolve 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() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| Install(IDictionary) |
Realiza a instalação. |
| IsEquivalentInstaller(ComponentInstaller) |
Determina se o instalador especificado instala o mesmo objeto que este instalador. (Herdado de ComponentInstaller) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| OnAfterInstall(IDictionary) |
Eleva o AfterInstall evento. (Herdado de Installer) |
| OnAfterRollback(IDictionary) |
Eleva o AfterRollback evento. (Herdado de Installer) |
| OnAfterUninstall(IDictionary) |
Eleva o AfterUninstall evento. (Herdado de Installer) |
| OnBeforeInstall(IDictionary) |
Eleva o BeforeInstall evento. (Herdado de Installer) |
| OnBeforeRollback(IDictionary) |
Eleva o BeforeRollback evento. (Herdado de Installer) |
| OnBeforeUninstall(IDictionary) |
Eleva o BeforeUninstall evento. (Herdado de Installer) |
| OnCommitted(IDictionary) |
Eleva o Committed evento. (Herdado de Installer) |
| OnCommitting(IDictionary) |
Eleva o Committing evento. (Herdado de Installer) |
| Rollback(IDictionary) |
Restaura o computador ao estado em que estava antes da instalação. |
| ToString() |
Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component) |
| Uninstall(IDictionary) |
Remove uma instalação. |
evento
| Name | Description |
|---|---|
| AfterInstall |
Acontece depois de os Install(IDictionary) métodos de todos os instaladores da Installers propriedade terem sido executados. (Herdado de Installer) |
| AfterRollback |
Acontece depois de as instalações de todos os instaladores Installers na propriedade serem revertidas. (Herdado de Installer) |
| AfterUninstall |
Ocorre depois de todos os instaladores da propriedade realizarem Installers as operações de desinstalação. (Herdado de Installer) |
| BeforeInstall |
Ocorre antes de o Install(IDictionary) método de cada instalador na coleção de instaladores ter sido executado. (Herdado de Installer) |
| BeforeRollback |
Acontece antes de os instaladores Installers da propriedade serem recuados. (Herdado de Installer) |
| BeforeUninstall |
Ocorre antes de os instaladores Installers da propriedade realizarem as operações de desinstalação. (Herdado de Installer) |
| Committed |
Acontece depois de todos os instaladores Installers da propriedade terem concluído as suas instalações. (Herdado de Installer) |
| Committing |
Ocorre antes de os instaladores Installers da propriedade realizarem as instalações. (Herdado de Installer) |
| Disposed |
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |