Sie sind hier: Startseite
 Liste aller Codebeispiele

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

 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 Windows PowerShell 5.1 und PowerShell Core 6.1 - Das Praxishandbuch (3. Auflage 2018/8. Auflage Gesamtreihe) Kindle Windows PowerShell 5.1 und PowerShell Core 6.1 - Das Praxishandbuch (3. Auflage 2018/8. Auflage Gesamtreihe) Kindle
Autoren: Dr. Holger Schwichtenberg
erschienen 2018, 1000 Seiten, 42,99 €
ISBN: 978-3-446-45923-6
Bestellung: Amazon.de oder im Buchhandel über ISBN 978-3-446-45923-6

Beratung & Support:

Schulungen zu diesem Thema:

 Anfrage für eine individuelle Schulung zum Thema Visual Basic;C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema:

 Datenbankprogrammierung mit .NET 4.0. Mit Visual Studio 2010 und SQL Server 2008 R2
 .NET 3.5
 Microsoft ASP.NET 4.0 mit C# 2010
 Webanwendungen mit ASP.NET 3.5 und AJAX Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.1 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0/2.1 (Buchversion 5.x, Ebook PDF)
 Windows Scripting Lernen, 2. Auflage
 Windows 8 Apps entwickeln mit C# und XAML - Crashkurs
 Microsoft Visual C# 2010
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Kindle)
 Microsoft SQL Server 2008 R2 - Das Entwicklerbuch
 ASP.NET 4.0 mit Visual C# 2010
 ASP.NET 4.0
 Windows PowerShell - Konzepte, Praxiseinsatz, Erweiterungen
 Microsoft .NET 2.0 Crashkurs - Final Edition
 Essential PowerShell
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 und 2.0-Preview2 (Buchversion 1.4)
 Datenbankprogrammierung mit .NET 4.5. Mit Visual Studio 2012 und SQL Server 2012
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 (PDF)
 Office 2010 Programmierung mit VSTO und .NET 4.0: Word, Excel und Outlook erweitern und anpassen
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications (PDF) mit .NET, C# und Visual Studio
 Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
 Microsoft ASP.NET 2.0 mit Visual Basic 2005 - Das Entwicklerbuch
 .NET 3.5 Crashkurs
 Windows Scripting Lernen, 6. Auflage
 Microsoft .NET 4.5 Update - Crashkurs (EBOOK - PDF)
 Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (DRUCK)
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (DRUCK)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.2 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (PDF)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications (DRUCK) mit .NET, C# und Visual Studio
 Microsoft ASP.NET 2.0 mit C# 2005 - Das Entwicklerbuch
 Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
 Microsoft ASP.NET 3.5 mit Visual C# 2008 - Das Entwicklerbuch
 Einblicke in C# 6.0 (shortcuts 181) Kindle Edition
 .NET 4.0 Crashkurs
 Docker und die Containerwelt - Einstieg und Expertentipps rund um Docker-Container (shortcut)
 Microsoft .NET 4.5 Update - Crashkurs
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Gedruckt)
 Moderne Webanwendungen für .NET-Entwickler: Server-Anwendungen, Web APIs, SPAs & HTML-Cross-Platform-Anwendungen mit ASP.NET, ASP.NET Core, JavaScript/TypeScript und Angular
 C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (Kindle)
 Moderne Datenzugriffslösungen mit Entity Framework 6 (gedruckte Ausgabe)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (DRUCK)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Visual Basic 2010
 Microsoft ASP.NET 4.5 mit C# 2012 - Entwicklerbuch
 Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Das Entwicklerbuch
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 7.x, PDF)
 Windows Scripting (5. Auflage)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Moderne Datenzugriffslösungen mit Entity Framework 6 (EBOOK - PDF, MOBI, EPUB)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (EBOOK - PDF)
 Windows Scripting Lernen 5. Auflage
 Alle unsere aktuellen Fachbücher