PerformanceCounter.RemoveInstance Método
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.
Elimina a instância de categoria especificada pela PerformanceCounter propriedade do objeto InstanceName .
public:
void RemoveInstance();public void RemoveInstance();member this.RemoveInstance : unit -> unitPublic Sub RemoveInstance ()Exceções
Este contador é apenas de leitura, pelo que qualquer instância associada à categoria não pode ser removida.
-ou-
A instância não está corretamente associada a um contador de desempenho.
-ou-
A InstanceLifetime propriedade é definida para Process quando se utiliza memória partilhada global.
Ocorreu um erro ao aceder a uma API do sistema.
Observações
Só podes remover uma instância para um contador personalizado. Todos os contadores do sistema são apenas leitura, por isso tentar remover um deles lança uma exceção.
Note
Para evitar uma possível condição de corrida quando a memória partilhada do contador de desempenho for libertada, recomenda-se que o RemoveInstance método seja chamado a partir do DomainUnload handler de eventos.
Para criar uma instância de categoria de desempenho, especifique um instanceName no PerformanceCounter construtor. Se a instância de categoria especificada por instanceName já existir, o novo objeto irá referenciar a instância de categoria existente.
Note
Se o valor da propriedade InstanceLifetime for Process e a categoria contador de desempenho foi criada com .NET Framework versão 1.0 ou 1.1, é lançado um InvalidOperationException. As categorias de contadores de desempenho criadas com versões anteriores usam memória partilhada global, e o valor para InstanceLifetime deve ser Global. Se a categoria não for usada por aplicações a correr nas versões 1.0 ou 1.1 do .NET Framework, elimine e recrie a categoria.