BenchmarkDotNet für C# (.NET): Komplettguide mit Beispielen

Was ist BenchmarkDotNet und warum wird es benötigt?

BenchmarkDotNet ist eine leistungsstarke, plattformübergreifende Open-Source-Bibliothek für .NET, die für die präzise Messung der Code-Performance (Benchmarking) entwickelt wurde. In der Softwareentwicklung stellt sich oft die Frage, welcher Ansatz schneller ist: Welcher Sortieralgorithmus ist effizienter? Welche Methode zur String-Formatierung ist besser? Wie wirken sich verschiedene Datenstrukturen auf die Geschwindigkeit aus? BenchmarkDotNet löst diese Aufgabe auf professionellem Niveau.

Warum ist es notwendig? Manuelle Zeitmessungen mit Stopwatch sind fehleranfällig: Hintergrundprozesse der JIT-Kompilierung, Garbage Collection (GC), CPU-Cache-Warming und Ungenauigkeiten des Systemtimers verfälschen die Ergebnisse. BenchmarkDotNet automatisiert folgende Schritte:

• Warmup: Der Code wird vor der Messung mehrmals ausgeführt, damit JIT-Compiler und CPU-Cache einen stabilen Zustand erreichen.
• Iterationen: Die Methode wird mehrfach ausgeführt und statistisch ausgewertet.
• Statistische Analyse: Berechnung von Mittelwert, Median, Standardabweichung, Minimum und Maximum.
• Isolation: Jeder Benchmark läuft in einem eigenen Prozess, um Wechselwirkungen zu vermeiden.
• Diagnose: Neben der Zeit werden auch Speicherallokation (Allocated), GC-Durchläufe und andere Metriken gemessen.

Ohne BenchmarkDotNet riskieren Sie unzuverlässige Ergebnisse und falsche Optimierungsentscheidungen.

Installation von BenchmarkDotNet

Die Installation der BenchmarkDotNet-Bibliothek in ein .NET-Projekt (C#, F#, VB.NET) erfolgt über den NuGet-Paketmanager. Es gibt drei Hauptwege:

1. Über die .NET CLI (empfohlen)

Öffnen Sie ein Terminal im Stammverzeichnis Ihres Projekts und führen Sie folgenden Befehl aus:

dotnet add package BenchmarkDotNet

2. Über die Package Manager Console in Visual Studio

Öffnen Sie Tools -> NuGet Package Manager -> Package Manager Console und führen Sie aus:

Install-Package BenchmarkDotNet

3. Über die NuGet-GUI in Visual Studio

Klicken Sie mit der rechten Maustaste auf Ihr Projekt im Solution Explorer, wählen Sie "Manage NuGet Packages", suchen Sie nach "BenchmarkDotNet" und klicken Sie auf "Install".

Wichtig: Für korrekte Ergebnisse muss das Projekt in der Release-Konfiguration erstellt werden. Die Debug-Konfiguration optimiert den Code nicht, was zu verfälschten Messungen führt.

Schnellstart mit Codebeispiel

Schreiben wir einen einfachen Benchmark, der zwei Methoden zur String-Verkettung vergleicht: mit dem +-Operator und mit StringBuilder.

1. Erstellen Sie ein neues .NET-Konsolenprojekt: dotnet new console -n MyBenchmark.

2. Installieren Sie die Bibliothek: dotnet add package BenchmarkDotNet.

3. Ersetzen Sie den Inhalt von Program.cs durch folgenden Code:

using BenchmarkDotNet.Attributes;
using BenchmarkDotNet.Running;
using System.Text;

public class StringConcatenationBenchmark
{
    private const int N = 1000; // Anzahl der Iterationen innerhalb der Methode

    [Benchmark]
    public string UsingPlusOperator()
    {
        string result = "";
        for (int i = 0; i < N; i++)
        {
            result = result + "a";
        }
        return result;
    }

    [Benchmark]
    public string UsingStringBuilder()
    {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < N; i++)
        {
            sb.Append("a");
        }
        return sb.ToString();
    }
}

public class Program
{
    public static void Main(string[] args)
    {
        var summary = BenchmarkRunner.Run<StringConcatenationBenchmark>();
    }
}