IRONSOFTWAREHOME

So geben Sie Datenformate in C# mit IronBarcode aus

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Updated: 29. Juni 2026

IronBarcode bietet mehrere Ausgabeformate für BarCode-Lesungen, darunter BarcodeImage, BarcodeType, BinaryValue, Koordinaten, Abmessungen, Seitenzahlen, Ausrichtung sowie Text- und Werteigenschaften. Diese Formate ermöglichen die programmgesteuerte Verarbeitung von BarCode-Daten für verschiedene Anwendungsfälle.

Anstatt lediglich den BarCode zu lesen und Werte in der Konsole auszugeben, bietet IronBarcode weitaus mehr. Sie bietet mehrere Ausgabeformate, die den Nutzern die Weiterverarbeitung der Leseergebnisse erleichtern. Zu diesen Formaten gehören Eigenschaften wie BarCode-Bild, BarCode-Typ, BinaryValue, Koordinaten, Höhe, Breite, Seitenzahl, BarCode, Seitenausrichtung, text und value.

Benutzer können diese Eigenschaften innerhalb des Programms weiter bearbeiten. Sehen wir uns an, wie diese Eigenschaften genutzt werden können und in welchen Anwendungsfällen sie hilfreich sein können.

Schnellstart: BarCode-Wert und -Typ in einer Zeile lesen

Dieses Beispiel zeigt, wie man mit IronBarcode einen Barcode aus einem Bild ausliest – eine Zeile zum Laden, dann sofortiges PRINTen des Werts und des Typs des BarCodes. Ideal für einen schnellen Einstieg. Ausführlichere Beispiele finden Sie im BarCode-Schnellstart-Leitfaden.

  1. 1Install IronBarcode with NuGet Package Manager

    PM > Install-Package BarCode

  2. 2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    var result = IronBarCode.BarcodeReader.Read("input.png");
    Console.WriteLine($"Value: {result[0].Value}, Type: {result[0].BarcodeType}");
    C#
  3. 3Bereitstellen zum Testen in Ihrer Live-Umgebung

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

Welche Ausgabeformate stehen zur Verfügung und für welche Anwendungsfälle eignen sie sich?

BarcodeResult speichert verschiedene nützliche Eigenschaften. Diese Eigenschaften sind unten aufgeführt:

  • BarcodeImage
  • BarcodeType
  • BinaryValue
  • Koordinaten, Height & Width
  • PageNumber
  • Barcode und PageOrientation
  • Text & Value

Jede Eigenschaft erfüllt spezifische Zwecke in BarCode-Verarbeitungsabläufen. Ob beim Aufbau eines Bestandsverwaltungssystems, einer Dokumentenverarbeitungs-Pipeline oder einer Anwendung zur Qualitätskontrolle – diese Datenformate bieten die nötige Flexibilität zum Lesen von BarCodes aus verschiedenen Quellen.

Wie kann ich BarCode-Bilder extrahieren und speichern?

Sobald IronBarcode ein Bild liest, werden die darin enthaltenen BarCodes in BarcodeResult als die Eigenschaft BarcodeImage vom Typ AnyBitmap gespeichert. Die Eigenschaft BarcodeImage speichert die gefundenen BarCode-Bilder. Benutzer können dieses Objekt abrufen, um das Bild weiter zu bearbeiten oder als dauerhafte Kopie zu speichern. Dies sorgt für Effizienz und Benutzerfreundlichkeit, da kein zusätzlicher Code zum Extrahieren von BarCode-Bildern aus einem Bild erforderlich ist.

Sehen Sie sich den folgenden Codeausschnitt an, der einen möglichen Anwendungsfall für dieses Ausgabeformat veranschaulicht:

using IronBarCode;
using IronSoftware.Drawing;
using System.Collections.Generic;

// Read barcode from PDF file
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Create list for barcodes
List<AnyBitmap> barcodeList = new List<AnyBitmap>();

foreach (BarcodeResult barcode in result)
{
    barcodeList.Add(barcode.BarcodeImage);
}

// Create multi-page TIFF
AnyBitmap.CreateMultiFrameTiff(barcodeList).SaveAs("barcodeImages.tif");

Der obige Codeausschnitt veranschaulicht einen Anwendungsfall für dieses Ausgabeformat. Konkret erstellt sie ein mehrseitiges TIFF-Bild aus Barcodes, die in einem PDF-Dokument erkannt wurden. Zunächst scannen oder erkennen wir BarCodes in der Beispiel-PDF-Datei. Anschließend erstellen wir eine Liste von AnyBitmap, in der wir die Informationen aus der Eigenschaft BarcodeImage speichern. Schließlich verwenden wir diese Liste, um mithilfe der CreateMultiFrameTiff-Methode eine mehrseitige TIFF-Datei zu erstellen. Diese Technik ist besonders nützlich bei der Verarbeitung mehrseitiger GIF- und TIFF-Dateien.

BarcodeImage Die Eigenschaft aus BarcodeResult speichert nur die Bilder der beim Einlesen gefundenen BarCodes, nicht das gesamte Eingabebild selbst.

Wie identifiziere ich verschiedene BarCode-Typen programmgesteuert?

Diese Eigenschaft hilft dabei, festzustellen, um welche Art von BarCode es sich im Eingabebild oder -dokument handelt. Eine Einschränkung besteht jedoch darin, dass der BarCode-Typ im Bild von IronBarcode unterstützt werden und lesbar sein muss. Weitere Informationen zu den von IronBarcode unterstützten BarCode-Typen finden Sie in diesem Artikel. Sehen Sie sich außerdem die vollständige Liste der unterstützten BarCode-Formate an, um die Kompatibilität mit Ihren spezifischen Anforderungen sicherzustellen.

Der folgende Codeausschnitt zeigt, wie BarCode-Werte und der BarCode-Typ aus einem Bild abgerufen werden, indem die Werte auf der Konsole ausgegeben werden.

using IronBarCode;
using System;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("bc3.png");

// Output barcode type to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value is " + barcode.ToString() + " and the barcode type is " + barcode.BarcodeType);
}

Ausgehend vom obigen Code-Schnipsel führen wir das Einlesen des BarCodes durch, indem wir die Methode BarcodeReader.Read() auf das Eingabebild anwenden. Dies gibt ein BarcodeResults-Objekt zurück, das alle BarcodeResult speichert, die beim Einlesen aller im Bild verfügbaren BarCodes erfasst wurden. Als Nächstes durchlaufen wir das BarcodeResults-Objekt, um BarcodeResult abzurufen und die BARCODES value und type auf die Konsole zu PRINTEN. Dieser Ansatz funktioniert nahtlos mit verschiedenen BarCode-Typen, einschließlich spezieller Formate wie Code-39-BarCodes.

Wann sollte ich die Ausgabe von Binärwerten verwenden?

Using IronBarcode, users can retrieve the byte array of the BarCode value by accessing the BarcodeResult-object on which they can access the BinaryValue-property. Dies ermöglicht es Benutzern, den BarCode value im Programm weiter zu bearbeiten. Die binäre value-Ausgabe ist besonders nützlich bei der Arbeit mit verschlüsselten Daten, in BarCodes kodierten Dateianhängen oder bei der Integration in Systeme, die eine Datenverarbeitung auf Byte-Ebene erfordern.

Der folgende Codeausschnitt veranschaulicht einen Anwendungsfall für das Abrufen des BarCodes value als Binärdaten:

using IronBarCode;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

int i = 1;
foreach (BarcodeResult barcode in result)
{
    var binaryValue = barcode.BinaryValue;
    var barcodeType = IronBarCode.BarcodeEncoding.QRCode;

    // Create QR code
    GeneratedBarcode generatedBarcode = BarcodeWriter.CreateBarcode(binaryValue, barcodeType);

    // Export QR code
    generatedBarcode.SaveAsPng($"qrFromBinary{i}.png");
    i++;
}

Wie aus dem obigen Code-Schnipsel ersichtlich, haben wir ein einfaches Programm erstellt, das mehrere BarCodes innerhalb eines Bildes in separate neue binär kodierte Dateien umwandelt. Zunächst scannen wir die Barcodes im Beispiel-PNG-Bild. Sobald wir diese BarCodes erkannt haben, durchlaufen wir sie, greifen auf die Eigenschaft BinaryValue zu und verwenden sie, um neue Binärdateien zu erstellen. Diese Technik ist besonders wertvoll, wenn Sie mehrere BarCodes lesen und deren Binärdaten einzeln verarbeiten müssen.

Wie kann ich auf die Position und die Abmessungen eines BarCodes zugreifen?

Eine weitere Eigenschaft des BarcodeResult-Objekts, auf die Benutzer zugreifen können, sind die Koordinaten des BARCODEs, einschließlich X1, Y1 und X2, Y2 sowie Height und Width innerhalb einer Bilddatei oder eines Dokuments. Diese Eigenschaften sind nützlich, wenn Benutzer Informationen über die Position und die Abmessungen des BarCodes abrufen müssen. Diese räumlichen Informationen sind entscheidend für Anwendungen, die eine präzise Positionierung erfordern, wie beispielsweise die automatisierte Dokumentenverarbeitung, Qualitätskontrollsysteme oder die Implementierung von Ausschnittbereichen für ein optimiertes Scannen von BarCodes.

Lassen Sie uns die Position und die Abmessungen des BarCodes veranschaulichen.

using IronBarCode;
using IronSoftware.Drawing;
using System.Linq;

// Read barcode from PNG
BarcodeResults result = BarcodeReader.Read("multiple-barcodes.png");

AnyBitmap bitmap = AnyBitmap.FromFile("multiple-barcodes.png");

foreach (BarcodeResult barcode in result)
{
    PointF[] barcodePoints = barcode.Points;

    float x1 = barcodePoints.Select(b => b.X).Min();
    float y1 = barcodePoints.Select(b => b.Y).Min();

    Rectangle rectangle = new Rectangle((int)x1, (int)y1, (int)barcode.Width!, (int)barcode.Height!);

    bitmap = bitmap.Redact(rectangle, Color.Magenta);

    // Save the image
    bitmap.SaveAs("redacted.png", AnyBitmap.ImageFormat.Png);
}
Drei Barcode-Proben (A, B, C), die unterschiedliche codierte Daten mit ähnlichen visuellen Mustern zeigen
Drei geschwärzte Inhaltsblöcke mit unleserlichen Textfragmenten

Der obige Codeausschnitt maskiert mehrere Barcodes, die in einer Bilddatei enthalten sind. Dazu verwenden wir eine Kombination aus zwei Bibliotheken: IronBarcode und IronDrawing. Um das BarcodeResult-Objekt zu erhalten und die Eigenschaften daraus zu extrahieren, lesen wir zunächst die in einer Bilddatei verfügbaren BarCodes mit der BarcodeReader.Read()-Methode ein. Gleichzeitig muss die Eingabebilddatei in ein AnyBitmap-Objekt konvertiert werden, um die Schwärzungsmethode auf das Bild anzuwenden. Sobald wir das BarcodeResults-Objekt haben, können wir eine Schleife anwenden und diese durchlaufen, um die X1, Y1, Width und Height jedes im Bild verfügbaren BarCodes zu erhalten und diese in den CropRectangle-Eigenschaften der AnyBitmap.Redact()-Methode zu verwenden.

Warum ist die Seitenzahl bei mehrseitigen Dokumenten wichtig?

Benutzer können die Seitenzahl abrufen, auf der der BarCode gefunden wurde. Dies ist eine hilfreiche Funktion für Benutzer, die ein mehrseitiges Dokument mit mehreren BarCodes verwenden und die Position der BarCodes im Dokument für die weitere Verarbeitung kennen müssen. Diese Funktionalität ist unerlässlich beim Auslesen von BarCodes aus PDF-Dokumenten oder bei der Verarbeitung von Batch-Dokumenten in Enterprise-Anwendungen.

Sehen Sie sich den folgenden Codeausschnitt an:

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page number to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine("The barcode value " + barcode.ToString() + " is found on page number " + barcode.PageNumber);
}

Der obige Codeausschnitt veranschaulicht einen Anwendungsfall, bei dem Benutzer benötigen, dass das Programm die value der in einem mehrseitigen PDF-Dokument enthaltenen BarCodes sowie deren jeweilige Seitenzahlen zurückgibt. Der Code verwendet die Methode BarcodeReader.ReadPdf(), um die BarCodes in einem mehrseitigen PDF-Dokument zu lesen, wobei ein BarcodeResults-Objekt zurückgegeben wird, das alle im Dokument gefundenen BarcodeResult speichert. Wir verwenden eine Schleife und durchlaufen jedes Element im Objekt, um den value der BarCodes und die Seitenzahl, auf der die BarCodes gefunden wurden, abzurufen. Abgesehen von diesem Anwendungsfall können Benutzer diese Eigenschaft zum Debuggen verwenden, um zu überprüfen, ob alle BarCodes in einem Dokument gelesen wurden.

Hinweis:: Der von dieser Eigenschaft zurückgegebene Wert ist 1-basiert, was bedeutet, dass die erste Seite immer eins und **nicht **null ist

Wie erkenne ich die Drehung von BarCodes und die Seitenausrichtung?

Using IronBarcode, users can retrieve information about the barcode orientation and page orientation, where the barcode was found. Um diese beiden Informationen zu extrahieren, greifen Sie auf die Eigenschaften Rotation und PageOrientation des Objekts BarcodeResult zu. Rotation gibt eine Ganzzahl zurück, die den Drehwinkel des gefundenen BarCodes angibt. Diese Funktion arbeitet mit Funktionen zur Bildausrichtungskorrektur zusammen, um ein präzises Einlesen von BarCodes unabhängig vom Scanwinkel zu gewährleisten.

Sehen Sie sich den folgenden Codeausschnitt an:

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("test.pdf");

// Output page orientation and rotation to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.PageOrientation);
    Console.WriteLine(barcode.Rotation);
}

Der obige Codeausschnitt wurde mit der angehängten Beispiel-PDF-Datei ausgeführt, um zu zeigen, dass Benutzer die Seitenausrichtung und die BarCode-Drehung abrufen können, indem sie jeweils pageOrientation und den BarCode rotation abrufen. Diese Funktion ist vor allem für Debugging-Zwecke nützlich.

Hinweis:: IronBarcode kann nur BarCodes mit den Rotationen BarcodeResult.PageOrientation, BarcodeResult.Rotation, 0, 90, 180 und 270 Grad lesen. IronBarcode gibt keinen Wert zurück, wenn der BarCode einen anderen Drehungswert als die genannten aufweist. PageOrientation gibt ein PageOrientation-Objekt zurück, das aus Portrait oder Landscape besteht.

Was ist der Unterschied zwischen Text- und Wert-Eigenschaften?

Natürlich sind die wichtigsten Eigenschaften, die Nutzer bei der Verwendung von IronBarcode abrufen möchten, die value und text. Diese beiden Eigenschaften werden oft synonym verwendet und liefern dasselbe Ergebnis value. Abgesehen davon können Benutzer die Methode BarcodeResult.ToString() verwenden, um das gleiche Ergebnis zu erzielen. Bei der Arbeit mit spezialisierten Anwendungen oder beim Exportieren von BarCode-Daten als Streams bieten diese Eigenschaften flexible Möglichkeiten, auf den BarCode-Inhalt in Ihrem bevorzugten Format zuzugreifen.

Das folgende Code-Snippet veranschaulicht dies:

using IronBarCode;
using System;

// Read barcode from PDF
BarcodeResults result = BarcodeReader.ReadPdf("barcodestamped3.pdf");

// Output text value to console
foreach (BarcodeResult barcode in result)
{
    Console.WriteLine(barcode.Value);
    Console.WriteLine(barcode.Text);
    Console.WriteLine(barcode.ToString());
}

Aus dem obigen Code-Schnipsel geht hervor, dass Benutzer nur wenige Zeilen Code benötigen, um BarCodes in einem Bild mit IronBarcode zu lesen. Nachdem wir die von der BarcodeReader.Read()-Methode zurückgegebene BarcodeResults durchlaufen haben, geben wir das Ergebnis der Abfrage der Value- und Text-Eigenschaften sowie den Aufruf der BarcodeResult.ToString()-Methode aus, um zu zeigen, dass all diese denselben value zurückgeben.

Kurz gesagt ist IronBarcode eine perfekte API für Benutzer, um vielfältige Operationen im Zusammenhang mit BarCodes durchzuführen, die sich nicht nur auf das Schreiben und Dekodieren von BarCodes beschränken. Dank der Unterstützung verschiedener Ausgabeformate können Nutzer mit dem von IronBarcode zurückgegebenen BarcodeResult-Objekt weitaus mehr erreichen.

Häufig gestellte Fragen

Welche Ausgabeformate unterstützt C# BarCode Reading?

IronBarcode bietet mehrere Ausgabeformate, darunter BarcodeImage, BarcodeType, BinaryValue, Koordinaten, Abmessungen, Seitenzahlen, Ausrichtung, Text und Werteigenschaften. Diese Formate ermöglichen eine umfassende Verarbeitung von Barcode-Daten für verschiedene .NET-Anwendungen.

Wie kann ich einen Barcodewert in nur einer Codezeile lesen?

Mit IronBarcode können Sie einen Barcode in einer Zeile einlesen: var result = IronBarCode.BarcodeReader.Read('input.png'); Damit haben Sie sofort Zugriff auf den Wert und den Typ des Barcodes über result[0].Value und result[0].BarcodeType.

Welche Eigenschaften sind in BarcodeResult verfügbar?

Das BarcodeResult-Objekt in IronBarcode enthält Eigenschaften wie BarcodeImage, BarcodeType, BinaryValue, Coordinates, Height & Width, PageNumber, Barcode, PageOrientation, Text und Value - und bietet damit umfassende Daten für Barcode-Verarbeitungsworkflows.

Kann ich Barcode-Bilder nach dem Lesen extrahieren und speichern?

Ja, IronBarcode speichert gefundene Barcodes als AnyBitmap-Objekte in der Eigenschaft BarcodeImage. Sie können dieses Objekt abrufen, um das Bild weiter zu verarbeiten oder es als permanente Kopie zu speichern, so dass kein zusätzlicher Code zum Extrahieren von Barcodebildern erforderlich ist.

Wie erhalte ich Zugriff auf Barcode-Koordinaten und Abmessungen?

IronBarcode liefert Koordinatendaten einschließlich der x- und y-Positionen sowie der Höhen- und Breitenabmessungen für jeden erkannten Barcode. Auf diese Eigenschaften kann über das BarcodeResult-Objekt zugegriffen werden, um die Position des Barcodes genau zu bestimmen.

Was ist der Unterschied zwischen Text- und Werteigenschaften?

In IronBarcode enthalten die beiden Eigenschaften Text und Value den Dateninhalt des Barcodes. Diese Eigenschaften sind Teil des BarcodeResult-Objekts und können austauschbar verwendet werden, um die dekodierten Barcode-Informationen abzurufen.

Kann ich feststellen, auf welcher Seite ein BarCode gefunden wurde?

Ja, IronBarcode enthält eine PageNumber-Eigenschaft im BarcodeResult-Objekt, mit der Sie genau feststellen können, auf welcher Seite eines mehrseitigen Dokuments oder einer PDF-Datei sich jeder erkannte Barcode befindet.

Wie kann ich den Typ des erkannten Barcodes identifizieren?

Die BarcodeType-Eigenschaft im BarcodeResult-Objekt von IronBarcode identifiziert das spezifische erkannte Barcodeformat (z. B. QR-Code, Code 128 usw.) und ermöglicht so eine formatspezifische Verarbeitung in Ihrer Anwendung.

What kind of applications benefit from using IronBarcode's output data formats?

Applications in inventory management, document processing, and quality control greatly benefit from IronBarcode's diverse data formats as they offer extensive barcode data processing options.

Can IronBarcode read barcodes from multipage PDF documents?

Yes, IronBarcode can read barcodes from multipage PDF documents using methods like `BarcodeReader.ReadPdf()`, which also informs about the page number on which each barcode is found.

Bereit anzufangen?

Nuget Downloads 2,422,100Version:2026.9gerade veröffentlicht

Holen Sie sich Ihre KOSTENLOSE

30-Tage-Testlizenz sofort.

bullet_checkedKeine Kreditkarte oder Kontoerstellung erforderlich
bullet_testTesten Sie in der Produktion
ohne Wasserzeichen
bullet_calendar30 Tage voll
funktionsfähiges Produkt
bullet_support24/5 technischer
Support während der Testphase
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package BarCode
nuget.org/packages/BarCode/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie "IronBarcode"
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

  1. Laden Sie IronBarCode herunter und entpacken Sie es an einem Ort wie ~/Libs in Ihrem Lösungsverzeichnis
  2. Klicken Sie im Visual Studio Solution Explorer mit der rechten Maustaste auf Verweise. Wählen Sie Durchsuchen und dann "IronBarcode.dll"

Lizenzen ab $999

Key in blue circle

Holen Sie sich sofort Ihren kostenlosen 30-Tage-Testschlüssel.

Your trial license will be sent to your email address

Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.

bullet_checkedIhr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
AWS-Logo
Booking Badge

Von Millionen von Ingenieur*innen weltweit vertraut

Azure (WebApps, Funktionen v3)
Erhalten Sie Ihre unverbindliche Beratung
Füllen Sie das Formular unten aus oder senden Sie eine E-Mail an sales@ironsoftware.com
Ihre Daten werden immer vertraulich behandelt.
Von Millionen von Ingenieur*innen weltweit vertraut
Azure (WebApps, Funktionen v3)
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.