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 di categoria specificata dalla proprietà dell'oggetto PerformanceCounterInstanceName .
public:
void RemoveInstance();public void RemoveInstance();member this.RemoveInstance : unit -> unitPublic Sub RemoveInstance ()Eccezioni
Questo contatore è di sola lettura, pertanto non è possibile rimuovere qualsiasi istanza associata alla categoria.
oppure
L'istanza non è associata correttamente a un contatore delle prestazioni.
oppure
La InstanceLifetime proprietà viene impostata su Process quando si usa la memoria condivisa globale.
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 il tentativo di rimuovere uno di essi genera un'eccezione.
Annotazioni
Per evitare una possibile race condition 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.
Annotazioni
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 un'eccezione InvalidOperationException . Le categorie di contatori delle prestazioni create con le versioni precedenti usano la 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.
