PerformanceCounter.RemoveInstance Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Elimina l'istanza della categoria specificata dalla proprietà PerformanceCounter dell'oggetto InstanceName.
public:
void RemoveInstance();public void RemoveInstance ();member this.RemoveInstance : unit -> unitPublic Sub RemoveInstance ()Eccezioni
Questo contatore è di sola lettura, quindi non è possibile rimuovere qualsiasi istanza associata alla categoria.
-oppure-
L'istanza non è associata correttamente a un contatore prestazioni.
-oppure-
La proprietà InstanceLifetime viene impostata su Process se si utilizza la memoria globale condivisa.
Si è verificato un errore durante l'accesso a un'API di sistema.
Commenti
È possibile rimuovere un'istanza solo per un contatore personalizzato. Tutti i contatori di sistema sono di sola lettura, quindi tenta di rimuovere uno di essi genera un'eccezione.
Nota
Per evitare una possibile condizione di gara quando viene rilasciata la memoria condivisa del contatore delle prestazioni, è consigliabile chiamare il RemoveInstance metodo dal DomainUnload gestore eventi.
Per creare un'istanza della categoria di prestazioni, specificare un instanceName oggetto nel PerformanceCounter costruttore. Se l'istanza di categoria specificata da instanceName esiste già il nuovo oggetto farà riferimento all'istanza di categoria esistente.
Nota
Se il valore della InstanceLifetime proprietà è Process e la categoria del contatore delle prestazioni è stata creata con .NET Framework versione 1.0 o 1.1, viene generata una InvalidOperationException classe. Le categorie di contatori delle prestazioni create con le versioni precedenti usano memoria condivisa globale e il valore per InstanceLifetime deve essere Global. Se la categoria non viene usata dalle applicazioni in esecuzione nelle versioni 1.0 o 1.1 di .NET Framework, eliminare e ricreare la categoria.
