How to Generate Barcode Images in C# .NET Applications

How Do I Install a Barcode Generator Library in C#?

Installing IronBarcode takes just seconds using the NuGet Package Manager. You can install it directly through the Package Manager Console or download the DLL manually.

Install-Package BarCode

How Can I Generate a Simple Barcode Using C#?

Creating your first barcode requires just two lines of code. The example below demonstrates generating a standard Code128 barcode and saving it as an image file.

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-barcode-image-generator-3.cs

using IronBarCode;
using IronSoftware.Drawing;

// Fluent API for Barcode Image generation.
string value = "https://ironsoftware.com/csharp/barcode";
AnyBitmap barcodeBitmap = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.PDF417).ResizeTo(300, 200).SetMargins(100).ToBitmap();
System.Drawing.Bitmap barcodeLegacyBitmap = (System.Drawing.Bitmap)barcodeBitmap;

Imports IronBarCode
Imports IronSoftware.Drawing

' Fluent API for Barcode Image generation.
Private value As String = "https://ironsoftware.com/csharp/barcode"
Private barcodeBitmap As AnyBitmap = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.PDF417).ResizeTo(300, 200).SetMargins(100).ToBitmap()
Private barcodeLegacyBitmap As System.Drawing.Bitmap = CType(barcodeBitmap, System.Drawing.Bitmap)

The BarcodeWriter.CreateBarcode() method is your entry point for barcode generation. It accepts two parameters: the data you want to encode and the barcode format from the BarcodeWriterEncoding enum. IronBarcode supports all major barcode formats including Code128, Code39, EAN13, UPCA, PDF417, DataMatrix, and QRCode codes.

Once generated, the GeneratedBarcode object provides multiple export options. You can save it as various image formats (PNG, JPEG, GIF, TIFF), export to PDF, or even retrieve it as a System.Drawing.Bitmap for further processing in your application.

Can I Customize the Appearance of Generated Barcodes?

IronBarcode offers extensive customization options that go far beyond basic barcode generation. You can add annotations, adjust colors, set margins, and control every aspect of your barcode's appearance.

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-barcode-image-generator-4.cs

using IronBarCode;
using IronSoftware.Drawing;

// Create a QR code with advanced styling options
GeneratedBarcode myBarCode = BarcodeWriter.CreateBarcode(
 "https://ironsoftware.com/csharp/barcode", 
 BarcodeWriterEncoding.QRCode
);

// Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:");

// Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode();

// Set consistent margins around the barcode
myBarCode.SetMargins(100);

// Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple);

// Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html");

Imports IronBarCode
Imports IronSoftware.Drawing

' Create a QR code with advanced styling options
Dim myBarCode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode", BarcodeWriterEncoding.QRCode)

' Add descriptive text above the barcode
myBarCode.AddAnnotationTextAboveBarcode("Product URL:")

' Display the encoded value below the barcode
myBarCode.AddBarcodeValueTextBelowBarcode()

' Set consistent margins around the barcode
myBarCode.SetMargins(100)

' Customize the barcode color (purple in this example)
myBarCode.ChangeBarCodeColor(Color.Purple)

' Export as an HTML file for web integration
myBarCode.SaveAsHtmlFile("MyBarCode.html")

The GeneratedBarcode class provides a rich set of methods for customization:

• Annotations: Use AddAnnotationTextAboveBarcode() and AddAnnotationTextBelowBarcode() to add custom labels or instructions around your barcode
• Value Display: The AddBarcodeValueTextBelowBarcode() method automatically displays the encoded data in human-readable format
• Spacing: Control whitespace with SetMargins() to ensure proper scanning and visual appeal
• Colors: Change foreground and background colors using ChangeBarCodeColor() and ChangeBackgroundColor()
• Export Options: Save as image files, PDFs, or self-contained HTML documents

For detailed customization options, explore the GeneratedBarcode class documentation which covers all available styling methods and properties.

How Do I Create and Export a Barcode in One Line of Code?

IronBarcode implements a fluent API design pattern that enables method chaining for more concise and readable code. This approach is particularly useful when applying multiple transformations to your barcode.

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-barcode-image-generator-5.cs

using IronBarCode;
using IronSoftware.Drawing;

// Generate, style, and convert a barcode in a single statement
string value = "https://ironsoftware.com/csharp/barcode";

// Create PDF417 barcode with chained operations
AnyBitmap barcodeBitmap = BarcodeWriter
 .CreateBarcode(value, BarcodeWriterEncoding.PDF417) // Create PDF417 barcode
 .ResizeTo(300, 200) // Set specific dimensions
 .SetMargins(10) // Add 10px margins
 .ToBitmap(); // Convert to bitmap

// Convert to System.Drawing.Bitmap for legacy compatibility
System.Drawing.Bitmap legacyBitmap = barcodeBitmap;

Imports IronBarCode
Imports IronSoftware.Drawing

' Generate, style, and convert a barcode in a single statement
Dim value As String = "https://ironsoftware.com/csharp/barcode"

' Create PDF417 barcode with chained operations
Dim barcodeBitmap As AnyBitmap = BarcodeWriter _
 .CreateBarcode(value, BarcodeWriterEncoding.PDF417) _ ' Create PDF417 barcode
 .ResizeTo(300, 200) _ ' Set specific dimensions
 .SetMargins(10) _ ' Add 10px margins
 .ToBitmap() ' Convert to bitmap

' Convert to System.Drawing.Bitmap for legacy compatibility
Dim legacyBitmap As System.Drawing.Bitmap = barcodeBitmap

The fluent API pattern offers several advantages:

• Readability: Chain operations in a logical sequence that reads like natural language
• Efficiency: Reduce variable declarations and intermediate steps
• Flexibility: Easily add or remove operations without restructuring your code

Common fluent operations include:

• ResizeTo(): Control exact barcode dimensions
• SetMargins(): Add consistent spacing
• ChangeBarCodeColor(): Modify appearance
• AddAnnotationTextAboveBarcode(): Include descriptive text
• ToBitmap(), SaveAsPng(), SaveAsPdf(): Export in various formats

What Barcode Formats Are Supported by IronBarcode?

IronBarcode supports comprehensive barcode format generation through the BarcodeWriterEncoding enum. Supported formats include:

1D Barcodes: Code128, Code39, Code93, Codabar, ITF, MSI, Plessey, UPCA, UPCE, EAN8, EAN13
2D Barcodes: QRCode, DataMatrix, PDF417, Aztec, MaxiCode
Specialized Formats: IntelligentMail, DataBar, DataBarExpanded, and various GS1 standards

Each format has specific characteristics and use cases. For example, QRCode codes excel at storing URLs and large amounts of data, while EAN13 is standard for retail products. Learn more about choosing the right barcode format for your application.

How Can I Verify My Generated Barcode Is Readable?

Quality assurance is critical for barcode implementation. IronBarcode includes built-in verification to ensure your generated barcodes remain scannable:

:path=/static-assets/barcode/content-code-examples/tutorials/csharp-barcode-image-generator-6.cs

// Generate and verify a barcode
GeneratedBarcode myBarcode = BarcodeWriter
 .CreateBarcode("TEST123", BarcodeWriterEncoding.Code128)
 .ResizeTo(200, 100)
 .ChangeBarCodeColor(Color.DarkBlue);

// Verify the barcode is still readable after modifications
bool isReadable = myBarcode.Verify();
Console.WriteLine($"Barcode verification: {(isReadable ? "PASS" : "FAIL")}");

Imports System.Drawing

' Generate and verify a barcode
Dim myBarcode As GeneratedBarcode = BarcodeWriter _
 .CreateBarcode("TEST123", BarcodeWriterEncoding.Code128) _
 .ResizeTo(200, 100) _
 .ChangeBarCodeColor(Color.DarkBlue)

' Verify the barcode is still readable after modifications
Dim isReadable As Boolean = myBarcode.Verify()
Console.WriteLine($"Barcode verification: {(If(isReadable, "PASS", "FAIL"))}")

The Verify() method checks whether your barcode remains machine-readable after applying transformations like resizing or recoloring. This is especially important when using non-standard colors or very small sizes.

Where Can I Find More Barcode Generation Examples?

To expand your barcode generation capabilities, explore these additional resources:

Ready to Generate Professional Barcodes in Your Application?

IronBarcode makes barcode generation straightforward while providing the flexibility needed for professional applications. Whether you need simple product codes or complex 2D barcodes with custom styling, IronBarcode handles it all with minimal code.

Download IronBarcode today and start generating barcodes in minutes. Need help choosing the right license? Check our licensing options or request a free trial key to test IronBarcode in your production environment.