So legen Sie die maximale Anzahl paralleler Threads fest

Maximale Anzahl paralleler Threads festlegen

In diesem Beispiel verwenden wir eine große Menge an Barcode-Bildern, um die Skalierbarkeit und Effizienz eines Multithread-Prozesses im Vergleich zu einem Singlethread-Prozess zu veranschaulichen. Sie können den Bildordner hier herunterladen.

Um IronBarcode so zu konfigurieren, dass es mehr als einen Thread verwendet, wird zunächst ein neues BarcodeReaderOptions Objekt instanziiert, bei dem Multithreaded auf true gesetzt ist. Anschließend wird die Eigenschaft MaxParallelThreads durch Zuweisung eines ganzzahligen Wertes festgelegt. Standardmäßig ist MaxParallelThreads auf 4 eingestellt.

Nach der Konfiguration der Einstellungen werden zahlreiche Barcode-Bilder aus dem Ordner importiert. Anschließend wird mithilfe einer Schleife das Verzeichnis der Barcode-Bilder mit der Read Methode gelesen, wobei der Dateipfad und die konfigurierten BarcodeReaderOptions übergeben werden. Schließlich werden der Barcode-Wert und der Barcode-Typ durch Zugriff auf BarcodeResults angezeigt.

:path=/static-assets/barcode/content-code-examples/how-to/set-max-parallel-thread.cs

using IronBarCode;
using System;
using System.IO;

int maxParallelThreads = 4;


var optionsFaster = new BarcodeReaderOptions
{
    // Set Max threads to 4
    Multithreaded = true,
    MaxParallelThreads = maxParallelThreads,
};

// Dynamically get the "images" folder in the current directory
string folderPath = Path.Combine(Directory.GetCurrentDirectory(), "images");

// Retrieve all JPG files in the directory
var pdfFiles = Directory.GetFiles(folderPath, "*.jpg");

foreach (var file in pdfFiles)
{
    // Read the barcode
    var results = BarcodeReader.Read(file);

    foreach (var result in results)
    {
        // Show the type and value for every barcode found
        Console.WriteLine($"Value: {result.Value}, Type: {result.BarcodeType}");
            
    }
    
}

Ausgabe

Wie aus der Konsolenausgabe hervorgeht, werden der Barcode-Wert und der Typ für jedes entsprechende Bild angezeigt.

Einstellen des geeigneten maximalen parallelen Threads

Wenn die Multithreaded Eigenschaft auf "true" gesetzt ist, ist der Standardwert für die MaxParallelThreads -Eigenschaft 4. Obwohl es keine feste Obergrenze für den MaxParallelThreads zugewiesenen Integer-Wert gibt, kann die Einstellung eines höheren Wertes als die logische Kernkapazität Ihrer Hardware tatsächlich zu einer Leistungsminderung führen. Dies liegt daran, dass der Prozessor übermäßige Kontextwechsel nicht bewältigen kann, was potenziell zu Mehraufwand statt zu Geschwindigkeitssteigerungen führt. Daher hängt der korrekte Wert für MaxParallelThreads von den Spezifikationen des Computers ab, und Entwickler sollten Tests durchführen, um den optimalen Wert für ihre Umgebung zu finden.

In diesem Beispiel werden wir das gleiche Multithread-Szenario wie oben darstellen, jedoch mit einem Timer, um den Standardwert von 4 mit der Verwendung Environment.ProcessorCount zu vergleichen, um alle verfügbaren Threads zu nutzen. In unserem Fall verwenden wir einen Computer mit 32 logischen Prozessoren, daher wird MaxParallelThreads auf 32 gesetzt.

:path=/static-assets/barcode/content-code-examples/how-to/set-max-parallel-thread-performance.cs

using IronBarCode;
using System;
using System.Diagnostics;
using System.IO;
using System.Linq;

// Set the max parallel threads to the number of processor cores
int maxParallelThreads = Environment.ProcessorCount;


var optionsFaster = new BarcodeReaderOptions
{
    // Set Max threads to the number of processor cores
    Multithreaded = true,
    MaxParallelThreads = maxParallelThreads,
    ExpectMultipleBarcodes = true,
};

// Start timing the process
var stopwatch = Stopwatch.StartNew();
// Dynamically get the "images" folder in the current directory
string folderPath = Path.Combine(Directory.GetCurrentDirectory(), "images");

// Check if directory exists to prevent crashes
if (!Directory.Exists(folderPath))
{
    Console.WriteLine($"Error: The directory '{folderPath}' does not exist.");
    return;
}

// Get all JPG files in the directory
var pdfFiles = Directory.GetFiles(folderPath, "*.jpg");

foreach (var file in pdfFiles)
{
    // Read the barcode
    var results = BarcodeReader.Read(file);

    if (results.Any())
    {
        Console.WriteLine($"Barcode(s) found in: {Path.GetFileName(file)}");
        foreach (var result in results)
        {
            Console.WriteLine($"  Value: {result.Value}, Type: {result.BarcodeType}");
            
        }
    }
}

stopwatch.Stop();

// Print number of images the barcode reader could decode
Console.WriteLine($" Max parallel threads of {maxParallelThreads} with {stopwatch.Elapsed.TotalSeconds:F2}s");

Ausgabe

Verarbeitungszeit mit 4 Threads

Die Bearbeitungszeit für diesen Vorgang beträgt 84 Sekunden.

Prozesszeit mit Umgebung Prozessoranzahl

Wie Sie sehen können, beträgt die Verarbeitungszeit für diesen Vorgang 53 Sekunden, was deutlich schneller ist als die Ausführung mit nur vier Threads. Beachten Sie jedoch, dass die Verwendung von mehr Threads keine Leistungssteigerung garantiert, da diese vom Hostprozessor abhängt. Als Faustregel gilt, die maximale Anzahl verfügbarer Prozessoren abzüglich eines Prozessors zu verwenden, um sicherzustellen, dass noch ein einziger Thread für andere Systemoperationen zur Verfügung steht.

Warnung Die Projektumgebung muss so konfiguriert sein, dass Multithreading möglich ist. Andernfalls führt das Aktivieren Multithreaded und true Erhöhen MaxParallelThreads nicht zu einer Verbesserung der Prozessgeschwindigkeit, sondern kann diese sogar verringern.