PerformanceCounter.RemoveInstance PerformanceCounter.RemoveInstance PerformanceCounter.RemoveInstance PerformanceCounter.RemoveInstance Method

Definizione

Elimina l'istanza della categoria specificata dalla proprietà PerformanceCounter dell'oggetto InstanceName.Deletes the category instance specified by the PerformanceCounter object InstanceName property.

public:
 void RemoveInstance();
public void RemoveInstance ();
member this.RemoveInstance : unit -> unit
Public Sub RemoveInstance ()

Eccezioni

Questo contatore è di sola lettura, quindi non è possibile rimuovere qualsiasi istanza associata alla categoria.This counter is read-only, so any instance that is associated with the category cannot be removed.

-oppure--or- L'istanza non è associata correttamente a un contatore prestazioni.The instance is not correctly associated with a performance counter.

-oppure--or- La proprietà InstanceLifetime viene impostata su Process se si utilizza la memoria globale condivisa.The InstanceLifetime property is set to Process when using global shared memory.

Si è verificato un errore durante l'accesso a un'API di sistema.An error occurred when accessing a system API.

Commenti

È possibile rimuovere un'istanza solo per un contatore personalizzato.You can remove an instance only for a custom counter. Tutti i contatori di sistema sono di sola lettura, pertanto il tentativo di rimuovere uno di essi genera un'eccezione.All system counters are read-only, so attempting to remove one of them throws an exception.

Nota

Per evitare una possibile race condition quando viene rilasciata la memoria condivisa del contatore delle prestazioni, è RemoveInstance consigliabile chiamare il metodo DomainUnload dal gestore eventi.To avoid a possible race condition when the performance counter shared memory is released, it is recommended that the RemoveInstance method be called from the DomainUnload event handler.

Per creare un'istanza di categoria prestazioni, specificare instanceName un oggetto PerformanceCounter nel costruttore.To create a performance category instance, specify an instanceName on the PerformanceCounter constructor. Se l'istanza di categoria specificata instanceName da esiste già, il nuovo oggetto fa riferimento all'istanza di categoria esistente.If the category instance specified by instanceName already exists the new object will reference the existing category instance.

Nota

Se il valore InstanceLifetime della proprietà è Process e la categoria del contatore delle prestazioni è stata creata con .NET Framework versione 1,0 o 1,1 InvalidOperationException , viene generata un'eccezione.If the value for the InstanceLifetime property is Process and the performance counter category was created with .NET Framework version 1.0 or 1.1, an InvalidOperationException is thrown. Le categorie di contatori delle prestazioni create con versioni precedenti utilizzano la memoria condivisa globale e InstanceLifetime il valore Globaldi deve essere.Performance counter categories created with earlier versions use global shared memory, and the value for InstanceLifetime must be Global. Se la categoria non viene utilizzata dalle applicazioni in esecuzione nelle versioni 1,0 o 1,1 del .NET Framework, eliminare e ricreare la categoria.If the category is not used by applications running on versions 1.0 or 1.1 of the .NET Framework, delete and recreate the category.

Sicurezza

PerformanceCounterPermission
per la scrittura della categoria del contatore delle prestazioni.for writing the performance counter category. Enumerazione associata: Write.Associated enumeration: Write.

Si applica a