PerformanceCounter.RemoveInstance Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacchetto:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

Elimina l'istanza della categoria specificata dalla proprietà PerformanceCounter dell'oggetto InstanceName.

public:
 void RemoveInstance();

public void RemoveInstance ();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Eccezioni

InvalidOperationException

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.

Win32Exception

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.