Barcode .NET Component Tutorial Using IronBarcode

What Is a Barcode .NET Component?

A barcode .NET component is a software library packaged as a NuGet package that provides barcode generation and reading capabilities through a clean API. Unlike barcode fonts, which require manual checksum calculations and complex formatting rules, a dedicated component handles all encoding logic internally.

The IronBarcode library exposes two primary entry points:

• BarcodeWriter -- creates barcode images, PDFs, and HTML from text or numeric data
• BarcodeReader -- scans images, PDFs, and multi-frame TIFFs to extract barcode values

This bidirectional design means you can both print barcodes onto labels and scan them back from documents within the same library, which is essential for inventory management, document tracking, Crystal Reports integration, and data automation workflows.

Supported symbologies include:

• 1D linear: Code 128, Code 39, Code 93, ITF-14, EAN-13, EAN-8, UPC-A, UPC-E
• 2D matrix: QR Code, Data Matrix, PDF417, Aztec
• GS1 variants: GS1-128, GS1 DataBar

Manufacturing systems typically use Code 128 for product tracking because it encodes alphanumeric data efficiently. Healthcare applications commonly rely on Data Matrix for medication labeling because it prints well at very small sizes. Retail point-of-sale systems scan EAN-13 and UPC-A barcodes at checkout. Choosing the right symbology for your use case is one of the first decisions you will make when integrating barcode functionality.

How Do You Install IronBarcode in a .NET Project?

Installing IronBarcode takes under two minutes using the NuGet Package Manager in Visual Studio or the .NET CLI.

Package Manager Console (Visual Studio):

Install-Package BarCode

Install-Package BarCode

.NET CLI:

dotnet add package BarCode

dotnet add package BarCode

After the package installs, add the namespace at the top of any file that uses barcode functionality:

using IronBarCode;

using IronBarCode;

IronBarcode targets .NET Framework 4.6.2 and later, .NET Core 3.1 and later, and .NET 5 through .NET 10. It runs on Windows, Linux, and macOS, so the same code works across cloud-hosted containers, on-premises servers, and developer workstations without platform-specific configuration.

For ASP.NET Core applications, no middleware registration is required. You call the API directly from controllers, background services, or Razor Pages. Windows Forms and WPF applications gain access the same way -- add the namespace and start calling methods.

Detailed installation steps, including offline NuGet feed configuration and proxy settings, are available in the IronBarcode getting started guide.

How Do You Generate a Barcode Image in C#?

Generating a barcode with IronBarcode requires three steps: choose the encoding, set the value, and save the output. The following example creates a Code 128 barcode and saves it as both a PNG image and a PDF document:

using IronBarCode;

// Create a Code 128 barcode encoding a product identifier
var barcode = BarcodeWriter.CreateBarcode("PRD-12345-2024", BarcodeEncoding.Code128);

// Set the output dimensions in pixels
barcode.ResizeTo(400, 100);

// Add human-readable text beneath the bars
barcode.AddBarcodeValueTextBelowBarcode();

// Export to PNG for screen display and label printing
barcode.SaveAsImage("product-barcode.png");

// Export to PDF for document embedding
barcode.SaveAsPdf("product-barcode.pdf");

using IronBarCode;

// Create a Code 128 barcode encoding a product identifier
var barcode = BarcodeWriter.CreateBarcode("PRD-12345-2024", BarcodeEncoding.Code128);

// Set the output dimensions in pixels
barcode.ResizeTo(400, 100);

// Add human-readable text beneath the bars
barcode.AddBarcodeValueTextBelowBarcode();

// Export to PNG for screen display and label printing
barcode.SaveAsImage("product-barcode.png");

// Export to PDF for document embedding
barcode.SaveAsPdf("product-barcode.pdf");

The ResizeTo() method sets pixel dimensions precisely, which matters when you are printing labels at a specific DPI. The AddBarcodeValueTextBelowBarcode() call adds human-readable text under the bars, making manual verification easier in warehouse and retail environments.

using IronBarCode;

// Generate a QR code from a URL with 500px dimensions
var qrCode = QRCodeWriter.CreateQrCode("https://example.com/product/12345", 500);

// Save the QR code to a PNG file
qrCode.SaveAsImage("product-qr.png");

using IronBarCode;

// Generate a QR code from a URL with 500px dimensions
var qrCode = QRCodeWriter.CreateQrCode("https://example.com/product/12345", 500);

// Save the QR code to a PNG file
qrCode.SaveAsImage("product-qr.png");

How Do You Read Barcodes from Images?

Reading barcodes from an image is as direct as writing them. The BarcodeReader.Read() method accepts a file path, Stream, Bitmap, or IronSoftware.Drawing.AnyBitmap, and returns a BarcodeResults collection:

using IronBarCode;

// Read all barcodes from a scanned document image
BarcodeResults results = BarcodeReader.Read("scanned-document.png");

// Iterate over every detected barcode
foreach (BarcodeResult result in results)
{
    string value = result.Value;
    BarcodeEncoding type = result.BarcodeType;
    Console.WriteLine($"Detected {type}: {value}");
}

using IronBarCode;

// Read all barcodes from a scanned document image
BarcodeResults results = BarcodeReader.Read("scanned-document.png");

// Iterate over every detected barcode
foreach (BarcodeResult result in results)
{
    string value = result.Value;
    BarcodeEncoding type = result.BarcodeType;
    Console.WriteLine($"Detected {type}: {value}");
}

The reader automatically preprocesses images to correct common scanning problems: rotation, skew, noise, low contrast, and perspective distortion. This means you can pass raw scanner output directly without pre-processing it yourself.

using IronBarCode;

var options = new BarcodeReaderOptions
{
    // Balance accuracy and processing time
    Speed = ReadingSpeed.Balanced,

    // Detect multiple barcodes in one pass
    ExpectMultipleBarcodes = true,

    // Limit the search to 1D formats for faster processing
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
};

// Read from a multi-page PDF warehouse inventory report
var results = BarcodeReader.Read("warehouse-inventory.pdf", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    // Balance accuracy and processing time
    Speed = ReadingSpeed.Balanced,

    // Detect multiple barcodes in one pass
    ExpectMultipleBarcodes = true,

    // Limit the search to 1D formats for faster processing
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional
};

// Read from a multi-page PDF warehouse inventory report
var results = BarcodeReader.Read("warehouse-inventory.pdf", options);

How Do You Customize Barcode Appearance?

IronBarcode lets you control every visual aspect of a generated barcode before saving it. You can set colors, fonts, margins, and annotation text programmatically. This is useful when generating barcodes for branded labels or regulated industries where label layout follows strict specifications.

The API follows a fluent-style pattern: create the barcode, call style methods, then save. All style properties affect the output immediately and do not require a separate render step. See the styling and annotation examples for the full list of available properties.

How Do You Handle Barcodes in PDF Documents?

IronBarcode reads barcodes embedded in PDF files the same way it reads image files. Pass a PDF path to BarcodeReader.Read() and the library extracts barcodes from every page automatically. This is valuable for accounts payable workflows where invoice PDFs contain GS1-128 barcodes, and for logistics systems where shipping manifests are distributed as PDF attachments.

You can also write barcodes directly into PDF pages using IronBarcode alongside IronPDF for document generation. A common pattern is to generate a shipping label PDF that contains both a human-readable address block and a scannable Code 128 barcode for the tracking number.

For further reading on PDF barcode workflows, the IronBarcode tutorials section provides end-to-end examples covering invoice processing, batch label printing, and document archiving.

How Do You Integrate Barcodes into ASP.NET Core APIs?

Returning a barcode image from an ASP.NET Core controller endpoint is a common requirement for web portals that display dynamic labels. IronBarcode's base64 output makes this straightforward:

using IronBarCode;

// In an ASP.NET Core controller action
public IActionResult GetBarcodeImage(string productId)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128);
    barcode.ResizeTo(400, 100);
    barcode.AddBarcodeValueTextBelowBarcode();

    // Return the barcode as a PNG image response
    byte[] imageBytes = barcode.ToJpegBinaryData();
    return File(imageBytes, "image/jpeg");
}

using IronBarCode;

// In an ASP.NET Core controller action
public IActionResult GetBarcodeImage(string productId)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128);
    barcode.ResizeTo(400, 100);
    barcode.AddBarcodeValueTextBelowBarcode();

    // Return the barcode as a PNG image response
    byte[] imageBytes = barcode.ToJpegBinaryData();
    return File(imageBytes, "image/jpeg");
}

This approach works with any frontend framework. The browser receives a standard image response and displays it in an <img> tag. For high-traffic endpoints, generate barcodes once and cache the byte array, since the same product ID always produces the same barcode image.

The IronBarcode API reference documents all available methods including streaming output, which avoids allocating large byte arrays for very high-resolution barcodes.

How Does IronBarcode Handle Barcode Validation and Error Correction?

Barcode standards define strict encoding rules and checksum requirements. Code 128 uses a weighted modulo-103 checksum. EAN-13 uses modulo-10. QR codes embed Reed-Solomon error correction that allows partial data recovery even when up to 30% of the barcode is obscured or damaged.

IronBarcode enforces these rules automatically. When you call BarcodeWriter.CreateBarcode(), the library validates that the data fits the symbology's character set and length constraints, then calculates and appends the correct checksum without any additional steps from your code. This prevents generating invalid barcodes that scanners will reject.

On the reading side, the library applies error correction during decoding, which means it can often recover the correct value from a barcode that is partially torn, smudged, or printed at low resolution. This behavior is particularly important for GS1 barcode standards compliance in retail and logistics.

For a deeper look at how barcode error correction works at the specification level, the ISO/IEC barcode standards documentation provides the authoritative technical reference.

What Are Common Barcode Integration Scenarios?

Each scenario benefits from different configuration choices. The IronBarcode examples gallery provides runnable code for all of the scenarios above.

What Are Your Next Steps?

Integrating a barcode .NET component turns what would otherwise be a weeks-long custom development effort into an afternoon of configuration. IronBarcode handles encoding rules, checksums, image preprocessing, and error correction so your team can focus on the business logic that surrounds barcode workflows rather than the barcode mechanics themselves.

To move forward:

1. Install the package: dotnet add package BarCode or Install-Package BarCode in the Package Manager Console
2. Try the quickstart: The barcode quickstart example walks through generation and reading in under 20 lines of code
3. Explore symbologies: The supported barcode types reference lists all encoding formats with usage guidance
4. Review pricing: IronBarcode licensing options cover single-developer, team, and OEM redistribution use cases
5. Start a free trial: Download a 30-day free trial license to evaluate the full feature set in your own application

For questions about enterprise licensing, high-volume deployments, or technical integration challenges, the IronBarcode support team is available to help.

External references for barcode standards and specifications:

• GS1 barcode standards -- the global authority on retail and logistics barcode specifications
• ISO/IEC barcode standards committee -- international standards for 1D and 2D barcode symbologies
• C# barcode Q&A on Stack Overflow -- community discussions on barcode implementation in .NET