SO WIRD'S GEMACHT: Hinzufügen und Entfernen von Leistungsindikatorinstanzen

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Sie können hinzufügen und entfernen Instanzen dynamisch, arbeiten mit Leistungsindikatoren und Kategorien. Beispielsweise können Sie für jeden Benutzer einer webbasierten Verkaufsanwendung eine Instanz hinzufügen, so dass Sie Informationen über Ihre Aktionen verfolgen und entfernen die Instanz Ablauf die Sitzung des Benutzers konnte.

Zum Hinzufügen von Instanzen einen unformatierten Wert für einen Leistungsindikator festlegen. Wenn keine Instanz für den Indikator vorhanden ist, wird eine Instanz zum ersten Mal erstellt, dass die RawValue-Eigenschaft festgelegt, und alle nachfolgende Aktionen auf den unformatierten Wert werden als die Instanz wenn keine weiteren Auswirkungen auf angegeben ist. Sie können weitere Instanzen erstellen, indem einen neuen Instanznamen angeben und dann einen Wert nach.

Hinweis

Der Vorgang der Wert der Instanz festlegen, anstatt angeben des Namens eine neue Instanz erstellt die Instanz.

Im Gegensatz zu Leistungsindikatoren, die eine vorhandene Kategorie außer als Teil der Kategorie erstellen, hinzugefügt werden können können Instanzen hinzugefügt und benutzerdefinierte Kategorien jederzeit entfernt werden. InstanceName-Eigenschaft können Sie zwischen einer Instanz und einer anderen wechseln.

RemoveInstance-Methode können Sie eine Instanz eines benutzerdefinierten Leistungsindikators aus dem Speicher entfernt. Z. B. verwalten angenommen einer webbasierten Verkaufsanwendung eine Kategorie namens OrderInProgress verwendet und in, die Sie Instanzen für aktuellen Warenkorb der einzelnen Benutzer. Wenn ein Benutzer zunächst ein Element zu Ihrem Warenkorb hinzufügt, erstellt die Anwendung eine neue Instanz für diesen Benutzer. Wenn der Benutzer die Bestellung abschließt, löscht die Anwendung die Instanz. Im Verlauf der Bestellung aktualisieren Sie die Instanz mit Leistungsindikatoren, z. B. NumberofItemsinCart, TimeSinceCreation und NumberofItemsAddedPerSecond.

Sie können nicht Instanzen von den Leistungsindikatoren entfernen, die standardmäßig Bestandteil von Windows sind. Wenn Ihre Komponente PerformanceCounter nicht auf eine gültige Instanz bezieht, wird diese Methode eine Ausnahme ausgelöst.

Hinweis

PerformanceCounter-Klasse wird in Microsoft Windows NT Version 4.0 nicht vollständig unterstützt.Sie können aus den Systemindikatoren lesen, jedoch kann nicht erstellen, schreiben oder Löschen von benutzerdefinierte Leistungsindikatoren.

Eine Leistungsindikatorinstanz hinzu

1. Erstellen Sie normalerweise Ihre Kategorien und Leistungsindikatoren. Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Erstellen von Leistungsindikatorkategorien.

2. Legen Sie die InstanceName -Eigenschaft auf einen eindeutigen Namen für die Instanz, und legen Sie die Instanz RawValue-Eigenschaft.

   Der folgende Code veranschaulicht eine vorhandene Leistungsindikatorkategorie mehrere Instanzen erstellen:

                               ' Assumes the category and counter have already been created.
                               Dim myCounter AsNew System.Diagnostics.PerformanceCounter(
      "cat", "counter", "instance1", False)
   ' Set the raw value to automatically create instance1.
   myCounter.RawValue = 100
   ' State that you will now be working with a different instance.
   myCounter.InstanceName = "instance2"' Setting the value actually creates instance2.
   myCounter.RawValue = 200
   

                               // Assumes category and counter have been created.
           System.Diagnostics.PerformanceCounter myCounter =
              new System.Diagnostics.PerformanceCounter(
              "cat", "counter", "instance1", false);
           // Set the raw value to automatically create instance1.
           myCounter.RawValue = 100;
           // State that you will now be working with a different instance.
           myCounter.InstanceName = "instance2";
           // Setting the value actually creates instance2.
           myCounter.RawValue = 200;
   
   

Um eine Leistungsindikatorinstanz entfernen

1. Erstellen Sie eine Instanz der PerformanceCounter-Komponente, mit dem Leistungsindikator verbunden ist, aus dem Sie eine Instanz entfernen möchten. Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Erstellen von Instanzen von PerformanceCounter-Komponenten.

2. Legen Sie die InstanceName-Eigenschaft auf die zu löschende Instanz fest.

3. Rufen Sie die RemoveInstance-Methode in der Komponente.

   Das folgende Beispiel veranschaulicht eine Instanz aufgerufen Verweis aus einem Leistungsindikator entfernen:

                               ' Assumes that you have configured PerformanceCounter1 to
                               ' interact with the appropriate counter.
   PerformanceCounter1.InstanceName = "Reference"
   PerformanceCounter1.RemoveInstance()
   

                               // Assumes that you have configured PerformanceCounter1 to
                               // interact with the appropriate counter.
           PerformanceCounter1.InstanceName = "Reference";
           PerformanceCounter1.RemoveInstance();
   

Siehe auch

Aufgaben

SO WIRD'S GEMACHT: Erstellen von Instanzen von PerformanceCounter-Komponenten

Konzepte

Kategorie- und Indikatorverwaltung