Gewusst wie: Schreiben von Werten in Leistungsindikatoren

Aktualisiert: November 2007

Zum Schreiben eines Werts in einen Leistungsindikator erhöhen Sie den aktuellen Rohwert des Leistungsindikators um eine positive oder negative Zahl. Hierzu verwenden Sie die IncrementBy-Methode in der PerformanceCounter-Klasse.

Hinweis:
Durch Erhöhen um eine negative Zahl wird der Leistungsindikator um den absoluten Wert der Zahl verringert. Eine Erhöhung um den Wert 3 vergrößert z. B. den Rohwert des Leistungsindikators um Drei. Eine Erhöhung um den Wert -3 verringert den Rohwert des Leistungsindikators um Drei.

Außerdem können Sie Leistungsindikatorwerte auch mit der Increment-Methode und der Decrement-Methode um Eins erhöhen oder verringern. Diese Methoden werden wesentlich schneller verarbeitet als IncrementBy.

Sie können nur Werte für benutzerdefinierte Leistungsindikatoren inkrementieren. Die Interaktion mit Systemleistungsindikatoren über eine Instanz der PerformanceCounter-Komponente ist auf den schreibgeschützten Modus beschränkt. Vor dem Inkrementieren eines benutzerdefinierten Leistungsindikators müssen Sie die ReadOnly-Eigenschaft der Komponenteninstanz, mit der Sie den Zugriff vornehmen, auf false festlegen.

Hinweis:
Es bestehen Sicherheitsbeschränkungen, die sich auf die Möglichkeit der Verwendung von Leistungsindikatoren auswirken. Weitere Informationen hierzu finden Sie unter Einführung in die Überwachung von Leistungsschwellenwerten.

Hinweis:
Die PerformanceCounter-Klasse wird in Microsoft Windows NT, Version 4.0, nicht vollständig unterstützt. Sie können in den Systemleistungsindikatoren lesen, Sie können jedoch keine benutzerdefinierten Indikatoren erstellen, in diese schreiben oder sie löschen.

So schreiben Sie Werte in Leistungsindikatoren

1. Erstellen Sie eine PerformanceCounter-Instanz, und konfigurieren Sie sie für die Interaktion mit der gewünschten Kategorie und dem gewünschten Leistungsindikator. Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Instanzen von PerformanceCounter-Komponenten oder unter Gewusst wie: Konfigurieren von Instanzen von PerformanceCounter-Komponenten.

2. Schreiben Sie den Wert mithilfe einer der folgenden Methoden:

   Ziel	Aufzurufende Methode	Parameter
   Erhöhen des Rohwerts um Eins	Increment	Keines
   Verringern des Rohwerts um Eins	Decrement	Keines
   Erhöhen des Rohwerts um mehr als Eins	IncrementBy	Eine positive ganze Zahl
   Verringern des Rohwerts um mehr als Eins	IncrementBy	Eine negative ganze Zahl
   Zurücksetzen des Rohwerts auf eine beliebige ganze Zahl, statt ihn zu erhöhen	RawValue	Eine positive oder negative ganze Zahl

   Im folgenden Codebeispiel werden die verschiedenen Möglichkeiten gezeigt, Leistungsindikatorwerte festzulegen. Dabei wird davon ausgegangen, dass Sie mit einer Windows Forms-Anwendung arbeiten, die das Textfeld txtValue und drei Schaltflächen enthält: eine, die den Rohwert um die in das Textfeld eingegebene Zahl erhöht, eine, die den Rohwert um Eins verringert, und eine, die den Rohwert des Leistungsindikators auf den im Textfeld angegebenen Wert festlegt.

   Private Sub btnIncrement_Click(ByVal sender As System.Object, _
      ByVal e As System.EventArgs) Handles btnIncrement.Click
       PerformanceCounter1.ReadOnly = False
       PerformanceCounter1.IncrementBy(CLng(txtValue.Text))
   End Sub
   
   Private Sub btnDecrement_Click(ByVal sender As System.Object, _
      ByVal e As System.EventArgs) Handles btnDecrement.Click
       PerformanceCounter1.ReadOnly = False
       PerformanceCounter1.Decrement()
   End Sub
   
   Private Sub btnSetValue_Click(ByVal sender As System.Object, _
      ByVal e As System.EventArgs) Handles btnSetValue.Click
       PerformanceCounter1.ReadOnly = False
       PerformanceCounter1.RawValue = CLng(txtValue.Text)
   End Sub
   

    protected void btnIncrement_Click(object sender, EventArgs e)
       {
           performanceCounter1.ReadOnly = false;
           performanceCounter1.IncrementBy(long.Parse(txtValue.Text));
       }
   
       protected void btnDecrement_Click(object sender, EventArgs e)
       {
           performanceCounter1.ReadOnly = false;
           performanceCounter1.Decrement();
       }
   
       protected void btnSetValue_Click(object sender, EventArgs e)
       {
           performanceCounter1.ReadOnly = false;
           performanceCounter1.RawValue = long.Parse(txtValue.Text);
       }
   

Siehe auch

Konzepte

Einführung in die Überwachung von Leistungsschwellenwerten

Abrufen von Leistungsindikatorwerten