Wie man OcrProgress Tracking in C# verwendet

Anpassen und Gestalten von Barcodes in C# for .NET mit IronBarcode

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronBarcode ermöglicht es Entwicklern, Barcodes in C# anzupassen, indem sie Farben ändern, Abmessungen anpassen und Anmerkungen hinzufügen. Dies geschieht mit einfachen Methodenaufrufen wie ChangeBarCodeColor() und ResizeTo() für die vollständige Kontrolle über das Styling.

Im Laufe der Jahre ist die Verwendung von Barcodes immer beliebter geworden und wird in einer Vielzahl von Anwendungen eingesetzt, sei es zum Speichern von Daten, IDs oder URLs von Webseiten. In einigen Anwendungen werden BarCodes auf Produkten sichtbar gemacht, was zu einer erhöhten Nachfrage nach Styling-Optionen führt. Daher haben einige Barcode-Typen einzigartige Erscheinungsbilder entwickelt, wie zum Beispiel PDF417, Aztec, IntelligentMail, MaxiCode, DataMatrix und viele mehr. Eine umfassende Liste der unterstützten Formate finden Sie in unserer Unterstützte BarCode-Formate Dokumentation.

Darüber hinaus bietet IronBarcode Optionen zur weiteren Gestaltung von Barcodes, einschließlich Aspekten wie Barcodefarben, Barcodegrößenanpassung und Hintergrundfarben. Dies wird mit Unterstützung unserer Open-Source-Bibliothek IronDrawing ermöglicht. Diese Styling-Funktionen bauen auf IronBarcode's umfassenden Barcode-Generierungsfunktionen auf.

Schnellstart: Barcode-Farbe und Hintergrund anpassen

Hier ist ein einfaches Beispiel, das zeigt, wie Entwickler mit IronBarcode schnell benutzerdefinierte Farben auf die Balken und den Hintergrund eines Barcodes anwenden können. Sie werden sehen, wie einfach es ist, einen gestylten Barcode mit nur einem verketteten Aufruf zu erzeugen. Weitere Beispiele für Fortgeschrittene finden Sie in unserem C# BarCode Image Generator Tutorial.

  1. Installieren Sie IronBarcode mit NuGet Package Manager

    PM > Install-Package BarCode
  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronBarCode.BarcodeWriter.CreateBarcode("HELLO123", IronBarCode.BarcodeEncoding.Code128)
        .ChangeBarCodeColor(IronSoftware.Drawing.Color.Blue)
        .ChangeBackgroundColor(IronSoftware.Drawing.Color.White)
        .SaveAsImage("styled.png");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronBarcode in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer

Wie kann ich die Größe eines Barcodes ändern?

Wann sollte ich die ResizeTo-Methode verwenden?

Die Größenanpassung eines Barcodes ist ein Aspekt der Anpassung, den Nutzer mit IronBarcode erreichen können. Um diese Funktion zu nutzen, rufen Sie einfach die Methode ResizeTo auf und geben Sie die neuen Breiten- und Höhenmaße für den Barcode in Pixeln (px) ein. Diese Aktion löst eine verlustfreie Neudarstellung des Barcodes aus. Bei dieser Methode bleibt die Qualität des Barcodes erhalten, während seine Abmessungen angepasst werden. Sie eignet sich daher perfekt für Szenarien, in denen Barcodes in bestimmte Layouts oder Druckgrößen eingepasst werden müssen.

Hinweis:Werte, die zu klein sind, damit der Barcode lesbar ist, werden ignoriert.

using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcode(string barcodeText, int newWidth, int newHeight)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode
                     .ResizeTo(newWidth, newHeight)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode.png");
    }

    // Example usage with different size requirements
    public static void ResizeForDifferentFormats()
    {
        var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128);

        // Resize for product label
        barcode.ResizeTo(200, 50).SaveAsImage("product_label.png");

        // Resize for shipping label
        barcode.ResizeTo(300, 75).SaveAsImage("shipping_label.png");

        // Resize for inventory tag
        barcode.ResizeTo(150, 40).SaveAsImage("inventory_tag.png");
    }
}
using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcode(string barcodeText, int newWidth, int newHeight)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode
                     .ResizeTo(newWidth, newHeight)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode.png");
    }

    // Example usage with different size requirements
    public static void ResizeForDifferentFormats()
    {
        var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128);

        // Resize for product label
        barcode.ResizeTo(200, 50).SaveAsImage("product_label.png");

        // Resize for shipping label
        barcode.ResizeTo(300, 75).SaveAsImage("shipping_label.png");

        // Resize for inventory tag
        barcode.ResizeTo(150, 40).SaveAsImage("inventory_tag.png");
    }
}
$vbLabelText   $csharpLabel

Die Methode ResizeTo kann für das Objekt GeneratedBarcode aufgerufen werden. Wenn Sie mit verschiedenen Ausgabeformaten arbeiten, sollten Sie sich auch unsere Anleitung BarCode als PDF erstellen ansehen. Nachfolgend sehen Sie die Barcode-Bilder, die mit dem obigen Codeschnipsel erzeugt wurden.

Original barcode with standard dimensions before resize operation
Resized barcode showing clear black and white vertical bars after dimension modification

Warum die ResizeToMil-Methode für 1D BarCodes verwenden?

Eine weitere Möglichkeit zur Größenänderung in IronBarcode ist die Methode ResizeToMil. Im Gegensatz zur Methode ResizeTo werden hier die folgenden Komponenten angepasst:

  • Barcode-Element: Die Breite des schmalsten Barcode-Elements, gemessen in Tausendstel Zoll (mil).
  • Höhe: Die Höhe des Barcodes, gemessen in Zoll (der Standard ist 1 Zoll).
  • Auflösung: Punkte pro Zoll (der Standard ist 96 DPI).

Diese Methode eignet sich besonders für 1D-Barcodes und wird häufig in industriellen Anwendungen eingesetzt, bei denen es auf präzise Messungen ankommt. Das mil-Messsystem ist ein Industriestandard, der eine gleichbleibende Lesbarkeit von Barcodes bei verschiedenen Scannern und Druckbedingungen gewährleistet.

using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcodeToMil(string barcodeText, int elementWidthMil, int heightInches, int dpi = 96)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode to mil
                     .ResizeToMil(elementWidthMil, heightInches, dpi)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode_mil.png");
    }

    // Example for different industrial standards
    public static void CreateIndustrialBarcodes()
    {
        // Standard retail barcode (10 mil width, 1 inch height)
        BarcodeWriter.CreateBarcode("RETAIL-001", BarcodeEncoding.Code128)
                     .ResizeToMil(10, 1, 300)
                     .SaveAsImage("retail_barcode.png");

        // High-density warehouse barcode (5 mil width, 0.5 inch height)
        BarcodeWriter.CreateBarcode("WAREHOUSE-002", BarcodeEncoding.Code128)
                     .ResizeToMil(5, 0.5f, 600)
                     .SaveAsImage("warehouse_barcode.png");

        // Large shipping barcode (15 mil width, 2 inch height)
        BarcodeWriter.CreateBarcode("SHIP-003", BarcodeEncoding.Code128)
                     .ResizeToMil(15, 2, 200)
                     .SaveAsImage("shipping_barcode.png");
    }
}
using IronBarCode;

public class BarcodeResizer
{
    public static void ResizeBarcodeToMil(string barcodeText, int elementWidthMil, int heightInches, int dpi = 96)
    {
        // Generate a barcode
        BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128)
                     // Resize the barcode to mil
                     .ResizeToMil(elementWidthMil, heightInches, dpi)
                     // Save the resized barcode
                     .SaveAsImage("resized_barcode_mil.png");
    }

    // Example for different industrial standards
    public static void CreateIndustrialBarcodes()
    {
        // Standard retail barcode (10 mil width, 1 inch height)
        BarcodeWriter.CreateBarcode("RETAIL-001", BarcodeEncoding.Code128)
                     .ResizeToMil(10, 1, 300)
                     .SaveAsImage("retail_barcode.png");

        // High-density warehouse barcode (5 mil width, 0.5 inch height)
        BarcodeWriter.CreateBarcode("WAREHOUSE-002", BarcodeEncoding.Code128)
                     .ResizeToMil(5, 0.5f, 600)
                     .SaveAsImage("warehouse_barcode.png");

        // Large shipping barcode (15 mil width, 2 inch height)
        BarcodeWriter.CreateBarcode("SHIP-003", BarcodeEncoding.Code128)
                     .ResizeToMil(15, 2, 200)
                     .SaveAsImage("shipping_barcode.png");
    }
}
$vbLabelText   $csharpLabel

Sie können diese Methode auch für das Objekt GeneratedBarcode aufrufen. Weitere Informationen zum Festlegen präziser Barcode-Abmessungen finden Sie in unserem Leitfaden "Barcode-Ränder festlegen". In der Abbildung unten sehen Sie die Auswirkungen der Methode ResizeToMil: Die weißen Bereiche an den Rändern des Barcodes werden entfernt, und sowohl das schmalste Element als auch die Höhe des Barcodes werden entsprechend den der Methode übergebenen Parameterwerten angepasst.

Original barcode with standard dimensions before ResizeToMil method is applied
Linear barcode showing result after ResizeToMil method application with vertical black and white bars

Wie kann ich BarCodes und Hintergrundfarben ändern?

Eine der gefragtesten Funktionen zur Gestaltung von Barcodes ist die Möglichkeit, sowohl die Barcode- als auch die Hintergrundfarben zu ändern. Dank IronDrawing bietet IronBarcode diese Möglichkeit. Durch die Verwendung der Methoden ChangeBarCodeColor und ChangeBackgroundColor auf dem Objekt GeneratedBarcode können Benutzer die Farben des Barcodes und seines Hintergrunds ändern. Diese Funktion ist besonders nützlich für Branding-Zwecke oder bei der Erstellung von thematischen Barcodes für besondere Veranstaltungen oder Produktlinien.

using IronBarCode;
using IronSoftware.Drawing; // Required for color manipulation

public class BarcodeColorChanger
{
    public static void ChangeBarcodeColors(string barcodeText, Color barcodeColor, Color backgroundColor)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Change the barcode color
        barcode.ChangeBarCodeColor(barcodeColor);

        // Change the background color
        barcode.ChangeBackgroundColor(backgroundColor);

        // Save the colored barcode
        barcode.SaveAsImage("colored_barcode.png");
    }

    // Example: Create branded barcodes with company colors
    public static void CreateBrandedBarcodes()
    {
        // Company brand colors example
        var barcode = BarcodeWriter.CreateBarcode("BRAND-2024", BarcodeEncoding.Code128);

        // Apply brand colors
        barcode.ChangeBarCodeColor(Color.FromHex("#1E3A8A")) // Company blue
               .ChangeBackgroundColor(Color.FromHex("#F3F4F6")) // Light gray background
               .SaveAsImage("branded_barcode.png");

        // Create seasonal variation
        var seasonalBarcode = BarcodeWriter.CreateBarcode("HOLIDAY-2024", BarcodeEncoding.Code128);
        seasonalBarcode.ChangeBarCodeColor(Color.DarkGreen)
                       .ChangeBackgroundColor(Color.LightYellow)
                       .SaveAsImage("seasonal_barcode.png");
    }
}
using IronBarCode;
using IronSoftware.Drawing; // Required for color manipulation

public class BarcodeColorChanger
{
    public static void ChangeBarcodeColors(string barcodeText, Color barcodeColor, Color backgroundColor)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Change the barcode color
        barcode.ChangeBarCodeColor(barcodeColor);

        // Change the background color
        barcode.ChangeBackgroundColor(backgroundColor);

        // Save the colored barcode
        barcode.SaveAsImage("colored_barcode.png");
    }

    // Example: Create branded barcodes with company colors
    public static void CreateBrandedBarcodes()
    {
        // Company brand colors example
        var barcode = BarcodeWriter.CreateBarcode("BRAND-2024", BarcodeEncoding.Code128);

        // Apply brand colors
        barcode.ChangeBarCodeColor(Color.FromHex("#1E3A8A")) // Company blue
               .ChangeBackgroundColor(Color.FromHex("#F3F4F6")) // Light gray background
               .SaveAsImage("branded_barcode.png");

        // Create seasonal variation
        var seasonalBarcode = BarcodeWriter.CreateBarcode("HOLIDAY-2024", BarcodeEncoding.Code128);
        seasonalBarcode.ChangeBarCodeColor(Color.DarkGreen)
                       .ChangeBackgroundColor(Color.LightYellow)
                       .SaveAsImage("seasonal_barcode.png");
    }
}
$vbLabelText   $csharpLabel

Bei der Arbeit mit farbigen BarCodes ist es wichtig, einen ausreichenden Kontrast zwischen dem Barcode und den Hintergrundfarben zu schaffen, um die Lesbarkeit zu gewährleisten. Weitere Gestaltungsmöglichkeiten für QR-Codes finden Sie in unserem Tutorial QR-Codes anpassen und gestalten.

QR-Code mit benutzerdefiniertem grünem Hintergrund und hellbrauner Vordergrundfarbe zur Veranschaulichung der Barcode-Farbanpassung

Wie füge ich Anmerkungen zu einem BarCode hinzu?

IronBarcode bietet auch die Möglichkeit, Barcode-Anmerkungen hinzuzufügen und zu gestalten. Das Styling von Anmerkungen wird ebenfalls durch die Funktionen von IronDrawing unterstützt, einschließlich des Bearbeitens der Anmerkungsfarbe und Schriftarten. Anmerkungen sind unerlässlich, um neben dem maschinenlesbaren Barcode auch menschenlesbare Informationen bereitzustellen, was sie für die Bestandsverwaltung, Produktkennzeichnung und Versandanwendungen unabdingbar macht.

using IronBarCode;
using IronSoftware.Drawing; // Required for font and color manipulation

public class BarcodeAnnotator
{
    public static void AnnotateBarcode(string barcodeText, string annotationText, Font annotationFont, Color annotationColor, float annotationSpacing)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Add annotation above the barcode
        barcode.AddAnnotationTextAboveBarcode(annotationText, annotationFont, annotationColor, annotationSpacing);

        // Add barcode value text below the barcode
        barcode.AddBarcodeValueTextBelowBarcode(annotationFont, annotationColor, annotationSpacing);

        // Save the annotated barcode
        barcode.SaveAsImage("annotated_barcode.png");
    }

    // Example: Create product label with annotations
    public static void CreateProductLabel()
    {
        var productCode = "PRD-12345-XL";
        var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);

        // Define fonts for different purposes
        var titleFont = new Font("Arial", FontStyle.Bold, 14);
        var valueFont = new Font("Arial", FontStyle.Regular, 12);

        // Add product name above
        barcode.AddAnnotationTextAboveBarcode("Premium Widget XL", titleFont, Color.Black, 5);

        // Add product code below
        barcode.AddBarcodeValueTextBelowBarcode(valueFont, Color.DarkGray, 3);

        // Apply additional styling
        barcode.ResizeTo(250, 80)
               .SaveAsImage("product_label_annotated.png");
    }
}
using IronBarCode;
using IronSoftware.Drawing; // Required for font and color manipulation

public class BarcodeAnnotator
{
    public static void AnnotateBarcode(string barcodeText, string annotationText, Font annotationFont, Color annotationColor, float annotationSpacing)
    {
        // Generate a barcode
        var barcode = BarcodeWriter.CreateBarcode(barcodeText, BarcodeEncoding.Code128);

        // Add annotation above the barcode
        barcode.AddAnnotationTextAboveBarcode(annotationText, annotationFont, annotationColor, annotationSpacing);

        // Add barcode value text below the barcode
        barcode.AddBarcodeValueTextBelowBarcode(annotationFont, annotationColor, annotationSpacing);

        // Save the annotated barcode
        barcode.SaveAsImage("annotated_barcode.png");
    }

    // Example: Create product label with annotations
    public static void CreateProductLabel()
    {
        var productCode = "PRD-12345-XL";
        var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);

        // Define fonts for different purposes
        var titleFont = new Font("Arial", FontStyle.Bold, 14);
        var valueFont = new Font("Arial", FontStyle.Regular, 12);

        // Add product name above
        barcode.AddAnnotationTextAboveBarcode("Premium Widget XL", titleFont, Color.Black, 5);

        // Add product code below
        barcode.AddBarcodeValueTextBelowBarcode(valueFont, Color.DarkGray, 3);

        // Apply additional styling
        barcode.ResizeTo(250, 80)
               .SaveAsImage("product_label_annotated.png");
    }
}
$vbLabelText   $csharpLabel
Von IronBarcode generierter beigefarbener QR-Code mit der URL ironsoftware.com

Als Erweiterung des vorherigen Code-Snippets instanziieren wir zwei neue IronSoftware.Drawing.Font Objekte, die als Schriftarten für Anmerkungen sowohl oberhalb als auch unterhalb des Barcodes dienen sollen. Nur die Schriftfamilie ist erforderlich, um die Schriftart zu instanziieren, obwohl Sie zusätzliche Eigenschaften wie Größe und Stil für mehr Kontrolle angeben können.

  • AddAnnotationTextAboveBarcode: Fügt einen benutzerdefinierten Anmerkungstext über dem Barcode hinzu.
  • AddBarcodeValueTextBelowBarcode: Fügt den Barcode-Wert unterhalb des Barcodes hinzu.

Diese beiden Methoden akzeptieren die gleichen Parameter: die IronSoftware.Drawing.Font Objekte, ein IronSoftware.Drawing.Color Objekt und den Abstand zwischen dem Barcode und dem Text. Darüber hinaus benötigt die Methode AddAnnotationTextAboveBarcode eine Zeichenkette für den Anmerkungstext, da sie einen benutzerdefinierten Text über dem Barcode hinzufügt.

IronBarcode bietet eine breite Palette von Anpassungsoptionen für die Gestaltung von Barcodes. Für Anwendungen, die Unicode-Unterstützung in Kommentaren benötigen, lesen Sie unseren Leitfaden zum Schreiben von Unicode BarCodes. Wenn Sie mehr über die Anpassung von QR-Codes erfahren möchten, lesen Sie "Anpassen und Hinzufügen von Logos zu QR-Codes". Um gestylte Barcodes in verschiedene Formate zu exportieren, lesen Sie unser Tutorial BarCode als HTML erstellen.

Häufig gestellte Fragen

Wie kann ich die Farbe eines Barcodes in C# ändern?

IronBarcode bietet die ChangeBarCodeColor()-Methode zur einfachen Anpassung der Barcodefarben. Diese Methode wird einfach nach der Erstellung des Barcodes aufgerufen, um eine beliebige Farbe aus der IronSoftware.Drawing.Color-Palette zu verwenden und so die vollständige Kontrolle über das visuelle Erscheinungsbild des Barcodes zu erhalten.

Welche Methode sollte ich verwenden, um die Größe eines Barcodes ohne Qualitätsverlust zu ändern?

Verwenden Sie die Methode ResizeTo() von IronBarcode, um die Größe von Barcodes ohne Qualitätsverlust zu ändern. Diese Methode löst eine verlustfreie Neudarstellung des Barcodes mit der angegebenen Breite und Höhe in Pixeln aus, wobei die Klarheit erhalten bleibt und die Abmessungen an bestimmte Layouts oder Druckanforderungen angepasst werden.

Kann ich die Hintergrundfarbe meiner BarCodes anpassen?

Ja, IronBarcode erlaubt es Ihnen, Barcode-Hintergründe mit der ChangeBackgroundColor() Methode anzupassen. Mit dieser Funktion können Sie jede beliebige Hintergrundfarbe mit Hilfe der IronSoftware.Drawing.Color-Palette einstellen, was eine nahtlose Integration mit Ihren Designanforderungen ermöglicht.

Welche BarCode-Formate unterstützen einzigartige Styling-Optionen?

IronBarcode unterstützt verschiedene Barcode-Formate mit einzigartigen Erscheinungsbildern, darunter PDF417, Aztec, IntelligentMail, MaxiCode und DataMatrix. Jedes Format hat seine eigenen visuellen Merkmale und lässt sich mit den Styling-Methoden von IronBarcode noch weiter anpassen.

Wie füge ich Anmerkungen zu BarCodes hinzu?

Mit IronBarcode können Sie Anmerkungen über und unter Barcodes hinzufügen, um die Lesbarkeit zu verbessern und zusätzlichen Kontext zu liefern. Diese Funktion ist besonders nützlich, wenn Sie neben dem Barcode einen für Menschen lesbaren Text, Produktcodes oder andere identifizierende Informationen hinzufügen möchten.

Was ist der Unterschied zwischen den Methoden ResizeTo und ResizeToMil?

IronBarcode bietet zwei Methoden zur Größenänderung: ResizeTo() für die Größenanpassung auf Pixelbasis mit verlustfreiem Re-Rendering und ResizeToMil() für die Größenanpassung des Barcode-Elements anhand von Mil-Maßen. Beide Methoden behalten die Qualität bei, während sie unterschiedliche Messanforderungen erfüllen.

Hairil Hasyimi Bin Omar
Software Ingenieur
Wie alle großen Ingenieure ist Hairil ein leidenschaftlicher Lerner. Er verfeinert sein Wissen in C#, Python und Java, um Iron Software-Teammitgliedern Mehrwert zu bieten. Hairil kam von der Universiti Teknologi MARA in Malaysia, wo er seinen Bachelor in Chemie- und Verfahrenstechnik abschloss.
Bereit anzufangen?
Nuget Downloads 2,119,460 | Version: 2026.3 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package BarCode
Führen Sie ein Beispiel aus und beobachten Sie, wie Ihre Zeichenkette zu einem BarCode wird.