Code-Beispiel

Werte in Performance Counter schreiben

Ein Beispiel zum Einsatz der Klasse System.Diagnostics.PerformanceCounter aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Die Klasse PerformanceCounter ermöglicht auch auf einfache Weise, Werte in benutzerdefinierte Indikatoren zu schreiben. Dabei können auch verschiedene Instanzen erzeugt werden.

Instanz anlegen
Um eine Instanz zu erzeugen, wird bei der Instanziierung der PerformanceCounter-Klasse einfach ein dritter Parameter angegeben. Wenn der Parameter fehlt oder mit einem Leerstring belegt ist, werden die Daten direkt in den Indikator geschrieben.

Dim PC As New
PerformanceCounter("KATEGORIE", "OBJEKTNAME", "INSTANZ")

Werte schreiben
Im Standardfall ermöglicht ein PerformanceCounter-Objekt nur den Lesezugriff. Der Schreibzugriff muss erst mit Setzen des Attributs Readonly auf False aktiviert werden. Danach können die Werte mit folgenden Attributen und Methoden verändert werden:
  • Das Attribut RawValue ermöglicht es, den Indikator auf einen bestimmten Wert zu setzen.
  • Die Methode Increment() erhöht den Wert um eins.
  • Die Methode IncrementBy(ZAHL) erhöht den Wert um eine bestimmte Zahl.
  • Die Methode Decrement() vermindert den Wert um eins. Eine Methode, um den Wert direkt um mehr als eins zu vermindern, gibt es nicht.

Löschen einer Instanz
Eine Instanz wird durch Ausführung der Methode RemoveInstance() gelöscht, ohne dass dies Auswirkungen auf andere Instanzen, den zugehörigen Indikator oder dessen Kategorie hätte.

PC.RemoveInstance()

Beispiel
Das folgende Beispiel verändert die Indikator-Instanz

\\Mars\Website IT-Visions.de(Geschützte Seiten für Leser)\Aktuelle Benutzeranzahl.

Zunächst wird der Wert auf einen Startwert von 50 gesetzt, dann in fünf Schritten um jeweils eins erhöht. Nach einer Erhöhung um 20 erfolgt dann das schrittweise Runterzählen um fünf. Die Dialogboxen geben Ihnen die Möglichkeit, die Veränderungen im Systemmonitor zu verfolgen.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' --- Werte in Performance Counter schreiben
Sub PerfCount_Schreiben()
Const KATEGORIE = "Website IT-Visions"
Const OBJEKTNAME2 = "Aktuelle Benutzeranzahl"
Const INSTANZ1 = "Geschützte Seiten für Leser"
Const INSTANZ2 = "Chat"

Dim a As Integer

' --- Zugriff auf Instanz
Dim PC As New PerformanceCounter(KATEGORIE, OBJEKTNAME2, INSTANZ1)
' --- Schreibschutz aufheben
PC.ReadOnly = False


' --- Startwert vorgeben!
PC.RawValue = 50
MsgBox("Anzahl der Benutzer: " & PC.RawValue & _
Chr(13) & "Betrachten Sie die Veränderung im Systemmonitor!")

' --- Wert verändern
For a = 1 To 5
PC.Increment()
MsgBox("Anzahl der Benutzer: " & PC.RawValue & _
Chr(13) & "Betrachten Sie die Veränderung im Systemmonitor!")
Next

' --- Wert weiter erhöhen
PC.IncrementBy(20)
MsgBox("Anzahl der Benutzer: " & PC.RawValue & _
Chr(13) & "Betrachten Sie die Veränderung im Systemmonitor!")

' --- Wert verändern
For a = 1 To 5
PC.Decrement()
MsgBox("Anzahl der Benutzer: " & PC.RawValue & _
Chr(13) & "Betrachten Sie die Veränderung im Systemmonitor!")
Next

' --- Entfernt die Instanz
PC.RemoveInstance()
End Sub

Programmcodebeispiele CSharp (C#)

using System;
using System.Diagnostics;
using System.Threading;
using System.Windows.Forms;

using FCL_Buch;

namespace FCLBuch._SystemDiagnostics {

public class Samples_Performance {
public void PerformanceCounter_Schreiben() {

// Werte in Performance-Counter schreiben
string kategorie = "Website IT-Visions";
string objectName2 = "Aktuelle Benutzeranzahl";
string instance1 = "Geschützte Seiten für Leser";

// Zugriff auf Instanz
PerformanceCounter pc = new PerformanceCounter(kategorie, objectName2, instance1);
// Schreibschutz aufheben
pc.ReadOnly = false;

// Startwert vorgeben!
pc.RawValue = 50;
MessageBox.Show("Anzahl der Benutzer: " + pc.RawValue + "\r\n" + "Betrachten Sie die Veränderung im Systemmonitor!");

// Wert verändern
for ( int i=1; i<5; i++ ) {
pc.Increment();
MessageBox.Show("Anzahl der Benutzer: " + pc.RawValue + "\r\n" + "Betrachten Sie die Veränderung im Systemmonitor!");
}

// Wert weiter erhöhen
pc.IncrementBy(20);
MessageBox.Show("Anzahl der Benutzer: " + pc.RawValue + "\r\n" + "Betrachten Sie die Veränderung im Systemmonitor!");

// Wert verändern
for ( int i=1; i<5; i++ ) {
pc.Decrement();
MessageBox.Show("Anzahl der Benutzer: " + pc.RawValue + "\r\n" + "Betrachten Sie die Veränderung im Systemmonitor!");
}

// Entfernt die Instanz
pc.RemoveInstance();
}
}
}

 

Querverweise

 Liste aller Codebeispiele  Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.Diagnostics.PerformanceCounter'  Übersicht über den FCL-Namensraum 'System.Diagnostics'  .NET & Visual Studio Community Portal

Buchtipp

Buchcover PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch (5. Auflage Oktober 2022 (9. Auflage Gesamtreihe)) PowerShell 7 und Windows PowerShell 5 – das Praxishandbuch
Autoren: Dr. Holger Schwichtenberg
erschienen 10/2022, 1426 Seiten
ISBN: 3446472967

Beratung & Support

Schulungen zu diesem Thema

 Visual Basic .NET - Aufbauwissen
 Grundlagen der objektorientierten Programmierung anhand von C# oder Visual Basic .NET
 Unit Testing / Testgetriebene Entwicklung / Test Driven Development (TDD) von .NET-Anwendungen (C# oder Visual Basic .NET)
 Visual Basic 6.0 (VB6.0)
 Objektorientierte Entwurfsmuster (Design-Pattern/Architektur-Pattern) mit .NET (C#, Visual Basic .NET)
 Visual Basic .NET - Basiswissen
 Windows Modern Apps/Windows Universal Apps entwickeln mit der Windows Runtime (WinRT), XAML und .NET/C#/Visual Basic
 Visual Basic Script (VBScript/VBS) - Sprachsyntax und Praxiseinsatz
 Word-Programmierung mit Visual Basic for Applications (VBA)
 Visual Studio Tools for Microsoft Office (VSTO) - Microsoft Office-Programmierung mit .NET und C# oder Visual Basic in Visual Studio
 Multi-Threading in .NET mit C#/Visual Basic .NET und/oder C++ und C++/CLI
 C# für Umsteiger von Visual Basic .NET
 Objektorientierte Programmierung (OOP) mit C#, Java, C++, Visual Basic.NET o.ä.
 Excel-Programmierung mit Visual Basic for Applications (VBA)
 Visual Basic .NET für Umsteiger von VBA/VB 4/5/6
 Visual Basic 2005 (Visual Basic 8.0)
 .NET und C# für Umsteiger von klassischem Visual Basic/COM
 Outlook-Programmierung mit Visual Basic for Applications (VBA)
 Das Component Object Model - für Script- und Visual Basic-Entwickler
 C#-Basiswissen (Grundlagen der Programmiersprache C#)
 .NET Akademie: Unit Testing und Test Driven Development (TDD) mit .NET/C# (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 7.0/7.1/7.2/7.3
 Task Parallel Library (TPL) - Parallelprogrammierung/Multi-Threading in .NET/C#
 Event Driven Design (mit .NET/C# oder Java)
 Neuerung in der CLR 2.0 und C# 2005
 Neuerungen in C# 6.0
 .NET Akademie: Blazor-Hands-On: Echte Single-Page-Web-Apps mit .NET und C# entwickeln (3-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 3.0 (Visual C# 2008)
 Refactoring von Programmcode in C, C++, C#, Java, Kotlin, JavaScript, TypeScript, Python, Go oder Rust
 Windows 8/Windows 8.1 für Entwickler: Programmierung mit der Windows Runtime (WinRT) - Erstellen von Windows Apps mit C#/XAML und/oder JavaScript/HTML
 Anfrage für eine individuelle Schulung zum Thema Visual Basic C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema

  Blazor 8.0: Moderne Webanwendungen und hybride Cross-Platform-Apps mit .NET 8.0, C# 12.0 und Visual Studio 2022
  C# 12.0 Crashkurs
  C# 11.0 Crashkurs
  C# 10.0 Crashkurs
  C# 9.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET 5.0, .NET Core und Xamarin
  ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
  C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
  C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
  Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
  Windows Store Apps entwickeln mit C# und XAML - Crashkurs
  Microsoft ASP.NET 4.0 mit C# 2010 - Entwicklerbuch
  Microsoft Viusal C# 2010
  Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
  ASP.NET 4.0 mit Visual C# 2010
  Visual Basic 2010
  Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Entwicklerbuch
 Alle unsere aktuellen Fachbücher  E-Book-Abo für ab 99 Euro im Jahr