Procedura: configurare istanze del componente PerformanceCounter

Aggiornamento: novembre 2007

Nei componenti PerformanceCounter creati è necessario impostare diverse proprietà. Esse determinano il contatore con cui il componente interagisce. Di seguito sono elencate le proprietà da impostare:

• CategoryName, che determina l’oggetto prestazioni con cui il componente interagisce. Tutti i contatori delle prestazioni in Windows sono raggruppati per categorie, ad esempio Memory, Processes e Processor.

• CounterName, che identifica il contatore all'interno della categoria specificata con cui il componente interagisce.

• InstanceName, che identifica l’istanza della categoria con cui il componente interagisce. Notare che molte categorie non contengono istanze. Pertanto, questa proprietà potrebbe rimanere vuota, a indicare che il contatore ha una sola istanza.

  Nota:

  Se è stata impostata una categoria non definita dall’utente, si dovrà scegliere tra i contatori e le istanze esistenti. Nelle categorie personalizzate si possono creare solo nuovi contatori e nuove istanze. Non è possibile, ad esempio, creare un nuovo contatore nella categoria Memory, ma se si crea una nuova categoria chiamata Orders, all’interno di essa si potranno definire tutti i contatori e le istanze necessari.

• MachineName, che identifica il server su cui si trova il contatore delle prestazioni con il quale deve interagire il componente. Per indicare il computer locale, impostare la proprietà su " " oppure lasciarla vuota in modo da configurarla su tale valore per impostazione predefinita.

• ReadOnly, che determina se è possibile scrivere nei contatori personalizzati creati. Per impostazione predefinita, tutte le istanze del componente PerformanceCounter configurate per l'uso dei contatori di Windows esistenti sono in sola lettura e non consentono di modificare i valori contenuti nei contatori. Quando tuttavia si configura un'istanza del componente per l'uso di un contatore personalizzato, è possibile accettare l'impostazione predefinita per l'uso in sola lettura o impostare il valore della proprietà su false per consentire la scrittura dei valori.

  Nota:
  La scrittura di contatori è consentita solo sul computer locale. Se si desidera leggere i valori del contatore, si potrà scegliere un computer qualsiasi cui sia possibile accedere.

Per configurare un’istanza del componente PerformanceCounter

1. Creare un'istanza del componente PerformanceCounter. Per ulteriori informazioni, vedere Procedura: creare istanze del componente PerformanceCounter.

2. Indicare il contatore con cui il componente deve interagire impostando le proprietà elencate di seguito.

   Proprietà	Impostazione
   MachineName	Qualunque server cui si abbia accesso.
   CategoryName	Qualunque categoria esistente sul server.
   CounterName	Qualsiasi contatore nella categoria selezionata.

3. Se il contatore con cui si interagisce contiene diverse istanze, impostare l'istanza appropriata come valore della proprietà InstanceName.

4. Se si utilizza un contatore personalizzato e si desidera l'accesso in scrittura, impostare la proprietà ReadOnly su false.

   Nota:
   È possibile specificare tali proprietà nella finestra Proprietà, nel codice oppure utilizzando forme speciali del costruttore dell'istanza del componente PerformanceCounter.

   Nell'esempio che segue viene mostrato come impostare tali valori a livello di codice per connettersi a un contatore delle prestazioni esistente di Windows chiamato "aborted transactions" sul server locale.

   ' Connect to an existing Windows counter and category
   Dim abortedTransactions As New PerformanceCounter()
   abortedTransactions.CategoryName = _
      "distributed transaction coordinator"
   abortedTransactions.CounterName = "aborted transactions"
   abortedTransactions.MachineName = "."
   ' Connect to a custom counter and category in writable mode
   PerformanceCounterCategory.Create("orders", "desc", _
   PerformanceCounterCategoryType.SingleInstance, "milk", "desc")
   Dim myCounter2 As New PerformanceCounter("orders", "milk", False)
   

        // Connect to an existing Windows counter and category
           System.Diagnostics.PerformanceCounter abortedTransactions =
              new System.Diagnostics.PerformanceCounter();
           abortedTransactions.CategoryName =
              "distributed transaction coordinator";
           abortedTransactions.CounterName = "aborted transactions";
           abortedTransactions.MachineName = ".";
           // Connect to a custom counter and category in writable mode
           System.Diagnostics.PerformanceCounterCategory.Create(
              "orders", "desc", PerformanceCounterCategoryType.SingleInstance,
              "milk", "desc");
           System.Diagnostics.PerformanceCounter myCounter2 =
              new System.Diagnostics.PerformanceCounter("orders", "milk", false);
   

Nota:
In questo codice "." rappresenta il computer locale.

Vedere anche

Attività

Procedura: creare istanze del componente PerformanceCounter

Procedura: creare contatori delle prestazioni personalizzati

Concetti

Gestione di categorie e contatori