Exemplarische Vorgehensweise: Ändern und Abrufen von Leistungsindikatorwerten

  • Artikel

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

Die Verfahren in dieser exemplarischen Vorgehensweise wird das Arbeiten mit den Werten eines Leistungsindikators mithilfe der Methoden der Klasse PerformanceCounter veranschaulichen. Ein Leistungsindikator ist die Möglichkeit Windows Leistungsdaten verschiedener Systemressourcen erfasst. Windows enthält vordefinierte Indikatoren, in Kategorien, mit denen Sie interagieren können organisiert. Die Werte, die Sie von einem Indikator abrufen können sein, unformatierte Werte oder berechnete Werte, die im Laufe der Zeit ändern. Es gibt mehrere Möglichkeiten, erhöhen und verringern Sie den aktuellen Wert eines Leistungsindikators.

Im Verlauf der in dieser exemplarischen Vorgehensweise werden Sie:

  • Erstellen und Konfigurieren einer Komponente PerformanceCounter Interaktion mit einem vom System bereitgestellten Indikator.

  • Erstellen Sie eine Windows-Anwendung, die Elemente der Benutzeroberfläche enthält, die Werte von einem Indikator abrufen und anzeigen.

  • Schreiben Sie Code, der mithilfe der RawValue-Eigenschaft festzulegen und den Rohwert des Indikators abzurufen.

  • Schreiben Sie Code, der verwendet die Increment, IncrementByund M:System.Diagnostics.PerformanceCounter.Decrement Methoden ändern den Wert des Leistungsindikators und den neuen Wert abzurufen.

Hinweis

Ihr Computer möglicherweise unterschiedliche Namen oder Pfade für einige der Visual Studio-Benutzer Elemente der Benutzeroberfläche in den folgenden Anweisungen angezeigt. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Arbeiten mit Einstellungen.

Eine Windows-Anwendung erstellen

  1. Im Menü Datei neueauf, und klicken Sie dann auf Project.

  2. In the New Project dialog box, create a Visual Basic or Visual C# Windows Application. Benennen Sie das Projekt PerformanceCounterExample.

  3. Fügen Sie von Registerkarte Windows FormsToolbox folgende Steuerelemente zur Anwendung:

    • Zwei Bezeichnungen

    • Einem Textfeld

    • Fünf Schaltflächen

  4. Legen Sie die folgenden Eigenschaften für Ihre Steuerelemente:

    Steuerelement

    -Eigenschaft

    Wert

    Label1

    Name

    lblCounterValue

     

    Text

    (leer)

    Label2

    Name

    lblSystemCounterValue

     

    Text

    (leer)

    TextBox1

    Name

    txtValue

     

    Text

    (leer)

    Button1

    Name

    btnSetRawValue

     

    Text

    Unformatierter Wert des benutzerdefinierten Zählers festlegen

    Button2

    Name

    btnGetNextValue

     

    Text

    Nächsten Wert des Systemzählers abrufen

    Button3

    Name

    btnIncrement

     

    Text

    Den benutzerdefinierten Zähler um 1 erhöhen

    Button4

    Name

    btnDecrement

     

    Text

    Verringern des benutzerdefinierten Zählers 1

    Button5

    Name

    btnIncrementBy

     

    Text

    Custom Counter durch einen Wert erhöhen

  5. Ordnen Sie die Steuerelemente, wie Sie.

  6. Speichern Sie Ihre Arbeit.

Erstellen und konfigurieren die PerformanceCounter-Komponente

  1. Server-Explorer öffnen Sie und greifen Sie auf Server Knoten zu. Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Zugriff und Initialize Server Explorer/Database Explorer.

  2. Suchen Sie die Liste für Ihren Computer unter dem Knoten Server und erweitern Sie ihn. Sie sehen Einträge für Leistungsindikatoren, Warteschlangen für Nachrichten, Ereignisprotokolle und Dienste.

  3. Erweitern Sie den Leistungsindikatoren Knoten, und suchen Sie den Knoten Prozessor.

  4. Suchen Sie den % Processor Time Knoten, und erweitern Sie ihn.

  5. Ziehen Sie den Leistungsindikator _Total in das Formular. Eine konfigurierte für den Leistungsindikator PerformanceCounter_Total-Komponente wird Ihrem Projekt hinzugefügt. Die Komponente heißt PerformanceCounter1 Visual Basic und in performanceCounter1 Visual C#.

Um den unformatierten Wert des Leistungsindikators System abzurufen

  • Doppelklicken Sie im Designer auf die nächsten Wert des Systemleistungsindikators -Schaltfläche, um Click-Ereignishandler erstellen. Diese Methode meldet den berechneten Wert des Leistungsindikators, nicht den unformatierten Wert. Fügen Sie folgenden Code abrufen und anzeigen den nächsten Wert des Leistungsindikators der PerformanceCounter-Instanz überwacht wird:

                                Private
                            Sub btnGetNextValue_Click() Handles btnGetNextValue.Click
   lblSystemCounterValue.Text = 
      "The current value of the system counter is: " &
      PerformanceCounter1.NextValue().ToString()
EndSub

    private void btnGetNextValue_Click(object sender, System.EventArgs e)
{
   lblSystemCounterValue.Text = 
      "The current value of the system counter is: " 
      + performanceCounter1.NextValue().ToString();
}

Der restlichen Prozeduren arbeiten Sie mit einer benutzerdefinierten Kategorie und Leistungsindikator.

So erstellen Sie einen benutzerdefinierten Leistungsindikator und Kategorie

  1. Klicken Sie im Ansicht auf Designer auf den Designer für Form1.

  2. Im Designer Server-Explorer öffnen Sie, und greifen Sie auf den Knoten Server. Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Zugriff und Initialize Server Explorer/Database Explorer.

  3. Suchen Sie die Liste für Ihren Computer unter dem Knoten Server und erweitern Sie ihn.

  4. Klicken Sie mit der rechten Maustaste auf den Knoten Leistungsindikatoren , und klicken Sie dann auf neue Kategorie erstellen.

    Das Dialogfeld Performance Counter Builder mit angezeigt wird.

  5. Geben Sie der Category Name MyNewCategory.

  6. Klicken Sie auf neue in einen neuen Indikator hinzuzufügen, und nennen Sie es MyNewCounter. Klicken Sie auf OK um die neue Kategorie und Indikator zu erstellen.

    Hinweis

    Sie benötigen die Berechtigung, in der Registrierung für dieses Schritt zu schreiben.Wenden Sie sich an den Systemadministrator, wenn Sie den neuen Indikator erstellen können.

  7. In Server-Explorer wechseln Sie zu den neuen Indikator, und ziehen Sie es auf das Formular. Das Projekt, für den neuen Indikator PerformanceCounter konfiguriert wird eine neue Komponente MyNewCounter hinzugefügt.

    Hinweis

    Diese Schritte erstellen auf Ihrem Computer den Leistungsindikator.Wenn Sie diese Anwendung bereitstellen, müssten Sie den Leistungsindikator auf den Zielcomputer zu erstellen.Hierzu können Sie ein Installationsprogramm zum Projekt hinzufügen.Wählen Sie das PerformanceCounter -Objekt, und klicken Sie auf Installer hinzufügen im Eigenschaftenfenster .(Ist dieser Befehl nicht zur Verfügung stehen, klicken Sie mit der rechten Maustaste auf das Eigenschaftenfenster , und klicken Sie dann auf Befehle.) Weitere Informationen finden Sie unter Einführung in Installationskomponenten.

Um den unformatierten Wert des benutzerdefinierten Zählers festzulegen

  1. Wählen Sie in den Designer der PerformanceCounter2 Visual Basic oder performanceCounter2 in Visual C#.

  2. Legen Sie die ReadOnly -Eigenschaft, um false.

  3. Doppelklicken Sie auf die Schaltfläche btnSetRawValue , um den Click-Ereignishandler im Code-Editor erstellen.

  4. Fügen Sie den folgenden Code, um den Rohwert des Indikators setzen Sie erstellt haben und den Wert des Indikators im ersten der Label-Steuerelemente anzuzeigen.

                                Private
                            Sub btnSetRawValue_Click() Handles btnSetRawValue.Click
   PerformanceCounter2.RawValue = CLng(txtValue.Text)
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
EndSub

    private void btnSetRawValue_Click(object sender, System.EventArgs e)
{
   performanceCounter2.RawValue = long.Parse(txtValue.Text);
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();

    }

Erhöhen Sie den benutzerdefinierten Zählerwert um eins und anzeigen

  1. Doppelklicken Sie im Designer auf erhöhen the Custom Counter durch 1 -Schaltfläche, um den Click-Ereignishandler im Code-Editor erstellen.

  2. Fügen Sie den folgenden Code um einen Ihrer benutzerdefinierten Leistungsindikator hinzuzufügen und den Wert des Indikators im ersten der Label-Steuerelemente anzuzeigen.

                                Private
                            Sub btnIncrement_Click() Handles btnIncrement.Click
   PerformanceCounter2.Increment()
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
EndSub

    private void btnIncrement_Click(object sender, System.EventArgs e)
{
   performanceCounter2.Increment();
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();

    }

Zum Verringern des benutzerdefinierten Zählers und seinen Wert anzeigen

  1. Doppelklicken Sie im Designer auf verkleinern the Custom Counter durch 1 -Schaltfläche, um den Click-Ereignishandler im Code-Editor erstellen.

  2. Fügen Sie den folgenden Code hinzu, zum Verringern des Wert des Leistungsindikators um eine und den Wert des Indikators im ersten der Label-Steuerelemente anzuzeigen.

                                Private
                            Sub btnDecrement_Click() Handles btnDecrement.Click
   PerformanceCounter2.Decrement()
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
EndSub

    private void btnDecrement_Click(object sender, System.EventArgs e)
{
   performanceCounter2.Decrement();
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();

    }

Zum Erhöhen des benutzerdefinierten Zählers um einen benutzerdefinierten Wert

  1. Doppelklicken Sie im Designer auf das Increase Custom Counter durch eine Wert Schaltfläche, um den Click-Ereignishandler im Code-Editor zu erstellen.

  2. Fügen Sie den folgenden Code, um den Wert des Indikators in das Textfeld eingegebenen Wert zu erhöhen und den Wert des Indikators im ersten der Label-Steuerelemente anzuzeigen.

                                Private
                            Sub btnIncrementBy_Click() Handles btnIncrementBy.Click
   PerformanceCounter2.IncrementBy(CLng(txtValue.Text))
   lblCounterValue.Text = PerformanceCounter2.NextValue().ToString()
EndSub

    private void btnIncrementBy_Click(object sender, System.EventArgs e)
{
   performanceCounter2.IncrementBy(long.Parse(txtValue.Text));
   lblCounterValue.Text = performanceCounter2.NextValue().ToString();
}

Ihre Anwendung testen

  1. Speichern Sie die Dateien.

  2. Drücken Sie F5, um kompilieren und Starten der Anwendung.

  3. Klicken Sie auf nächsten Wert des Systemleistungsindikators um den aktuellen Wert des Leistungsindikators Processor-Kategorie abrufen. Da Sie den Wert mithilfe der NextValue()-Methode abrufen, wird der erste Aufruf 0 zurück.

    Den aktuellen Wert im Bezeichnungsfeld angezeigte Beschriftung sollte angezeigt werden.

  4. Geben Sie 25 in das Textfeld und klicken Sie auf festlegen Wert des benutzerdefinierten Basisindikator.

    Das Bezeichnungsfeld müsste aktualisiert werden, um anzugeben, dass der unformatierte Wert jetzt 25 ist.

  5. Klicken Sie auf der Increase Custom Counter durch 1 Schaltfläche.

    Der Wert im Bezeichnungsfeld sollten um 1 erhöhen.

  6. Klicken Sie auf der verkleinern Custom Counter durch 1 Schaltfläche.

    Der Wert im Bezeichnungsfeld sollten durch 1 verringern.

  7. Geben Sie 25 in das Textfeld und klicken Sie auf Increase Custom Counter durch einen Wert.

    Der Wert im Bezeichnungsfeld sollten um 25 erhöhen.

    Sie können auch den Leistungsindikator im Windows-Leistungstool anzeigen.

Den Leistungsindikator in der Windows-Leistungstool anzeigen

  1. Öffnen Sie das Leistung -Tool, das Teil der Microsoft Management Console ist. Finden Sie in das Hilfe zu die Schritte zum Öffnen der Systemmonitor Betriebssystem.

  2. Klicken Sie mit der rechten Maustaste auf die Indikatorliste unter dem Leistungsdiagramm, und klicken Sie dann auf Leistungsindikatoren hinzufügen.

  3. Wählen Sie MyNewCategory Leistung Objektliste und MyNewCounter aus der Leistungsindikatorenliste aus. Klicken Sie auf hinzufügen um fertig zu stellen.

  4. Klicken Sie auf Bericht anzeigen auf der Symbolleiste den Wert der Zähler angezeigt.

Siehe auch

Konzepte

Einführung in die Überwachung von Leistungsschwellenwerten

Weitere Ressourcen

Überwachen von Leistungsschwellenwerten

Leistung Exemplarische