PerformanceCounter.RemoveInstance Método
Definição
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.
Exclui a instância de categoria especificada pela propriedade do PerformanceCounter objeto InstanceName .
public:
void RemoveInstance();public void RemoveInstance();member this.RemoveInstance : unit -> unitPublic Sub RemoveInstance ()Exceções
Esse contador é somente leitura, portanto, 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 ao usar memória Process compartilhada global.
Ocorreu um erro ao acessar uma API do sistema.
Comentários
Você pode remover uma instância apenas para um contador personalizado. Todos os contadores do sistema são somente leitura, portanto, tentar remover um deles gera uma exceção.
Observação
Para evitar uma possível condição de corrida quando a memória compartilhada do contador de desempenho for liberada, é recomendável que o RemoveInstance método seja chamado do DomainUnload manipulador 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 fará referência à instância de categoria existente.
Observação
Se o valor da InstanceLifetime propriedade for Process e a categoria de contador de desempenho tiver sido criada com o .NET Framework versão 1.0 ou 1.1, será gerada uma InvalidOperationException . As categorias de contador de desempenho criadas com versões anteriores usam memória compartilhada global e o valor deve InstanceLifetime ser Global. Se a categoria não for usada por aplicativos em execução nas versões 1.0 ou 1.1 do .NET Framework, exclua e recrie a categoria.
