Agentic, build-validated C# code examples for Aspose.BarCode for .NET covering barcode generation, recognition, and configuration across 60+ symbologies. Every example compiles and runs successfully. Includes agents.md guides optimized for AI coding agents.
Aspose.BarCode for .NET is a powerful barcode generation and recognition library for .NET applications. It enables developers to generate, read, and process barcodes programmatically without any third-party dependencies.
Key capabilities:
- Generate barcodes for 60+ symbologies including Code128, QR Code, DataMatrix, PDF417, Aztec, EAN, UPC, Code39, ITF14, and more
- Read and recognize barcodes from images, PDFs, and memory streams
- Control barcode appearance — size, resolution, colors, padding, rotation, and XDimension
- Configure checksum settings per symbology
- Export barcode images as PNG, JPEG, SVG, EMF, TIFF, and BMP
- Embed barcodes into PDF documents, Word files, and PowerPoint presentations
- Work with complex barcode types — Swiss QR Bill, Mailmark, HIBC LIC, GS1 Composite, MaxiCode
- Serialize and deserialize barcode generator and reader configurations to XML
dotnet add package Aspose.BarCodeOr via NuGet Package Manager:
Install-Package Aspose.BarCode
Requires .NET SDK 10.0 or later.
| Metric | Value |
|---|---|
| Total Examples | 1124 |
| Categories | 21 |
| Overall Pass Rate | 100.0% |
| Package Version | Aspose.BarCode 26.7.0 |
| Last Updated | 2026-08-13 |
agents.md
README.md
+-- barcode-appearance-customization/
+-- barcode-checksum-control/
+-- barcode-color-customization/
+-- barcode-configuration-serialization/
+-- barcode-reading-properties/
+-- barcode-recognition-basics/
+-- barcode-recognition-performance/
+-- barcode-recognition-xml-serialization/
+-- barcode-saving-and-export/
+-- barcode-size-and-resolution/
+-- barcode-text-customization/
+-- gs1-barcode-types/
+-- hibc-lic-barcode/
+-- mailmark-four-state-barcode/
+-- mailmark-two-dimensional-barcode/
+-- maxicode-barcode/
+-- one-dimensional-barcode-types/
+-- postal-barcode-types/
+-- special-barcode-recognition-settings/
+-- swiss-qr-code/
+-- two-dimensional-barcode-types/
Create a BarcodeGenerator with the symbology and text, then Save(): new BarcodeGenerator(EncodeTypes.QR, "text").Save("qr.png"). Examples for all 2D symbologies are in two-dimensional-barcode-types.
Use BarCodeReader with DecodeType.AllSupportedTypes (or a specific type), then iterate ReadBarCodes(). BarCodeReader requires a Bitmap, not Image. See barcode-recognition-basics.
Set generator.Parameters.Barcode.IsChecksumEnabled (an EnableChecksum enum, not bool) — the property lives on the Barcode sub-object, not directly on Parameters. Note: some symbologies (e.g. Code128) always require a checksum and throw BarCodeException if you try to disable it. See barcode-checksum-control.
generator.Parameters.Barcode.QR.ErrorLevel = QRErrorLevel.LevelH (or LevelL/LevelM/LevelQ). There is no MaskPattern property — masking is automatic. See two-dimensional-barcode-types.
Render the barcode to a MemoryStream, then embed it using the target Aspose product's own image API (Aspose.Pdf.Image, Aspose.Words Shape, Aspose.Slides Picture). Full working examples in pdf-barcode-grid-rules-adjacent categories and special-barcode-recognition-settings.
Pass the desired BarCodeImageFormat to Save(), e.g. generator.Save("barcode.svg", BarCodeImageFormat.Svg). Note the evaluation (unlicensed) version restricts SVG/EMF output to Code39 only — apply a license to lift this. See barcode-saving-and-export.
Use ComplexBarcodeGenerator with the matching codetext object — SwissQRCodetext, HIBCLICPrimaryDataCodetext/SecondaryAndAdditionalData, or Royal Mail Mailmark types. These are NOT constructed via the plain BarcodeGenerator. See swiss-qr-code, mailmark-four-state-barcode, mailmark-two-dimensional-barcode, and hibc-lic-barcode.
Almost always an invalid codetext for the chosen symbology — e.g. Australia Post requires a valid Format Control Code and minimum length, Code128 cannot have its checksum disabled, and Swiss QR Bill requires a complete Bill object. Check the relevant category's agents.md for symbology-specific constraints before constructing the codetext.
Yes — the repository ships an agents.md at root and one per category, plus .well-known/agent.json, llm.txt, and a machine-readable index.json. Point your agent at the repo's raw URLs and it can browse examples programmatically.
The library runs in evaluation mode without a license (with watermarks and some format/symbology restrictions, e.g. SVG/EMF export). For production use, apply a license via new License().SetLicense(path). Purchase / trial options: https://purchase.aspose.com/buy.
Each example is a self-contained C# file. Clone the repository and run any example directly:
git clone https://github.com/aspose-barcode/agentic-net-examples.git
cd agentic-net-examples
# Navigate to a category
cd barcode-recognition-basics
# Create a console project, add the package, and run an example
dotnet new console -o ExampleRunner
cd ExampleRunner
dotnet add package Aspose.BarCode
# Copy any .cs file from the category as Program.cs and run
cp ../generate-code128-barcode-and-save-as-png.cs Program.cs
dotnet runGenerate a Code128 barcode and save it as a PNG file:
using System;
using Aspose.BarCode.Generation;
class Program
{
static void Main()
{
using (var generator = new BarcodeGenerator(EncodeTypes.Code128, "1234567890"))
{
generator.Parameters.Barcode.XDimension.Point = 2f;
generator.Parameters.Barcode.BarHeight.Point = 50f;
generator.Save("code128.png");
Console.WriteLine("Barcode saved as code128.png");
}
}
}Read a barcode from an image file:
using System;
using Aspose.BarCode.BarCodeRecognition;
class Program
{
static void Main()
{
using (var reader = new BarCodeReader("barcode.png", DecodeType.AllSupportedTypes))
{
foreach (var result in reader.ReadBarCodes())
{
Console.WriteLine($"Type: {result.CodeTypeName}");
Console.WriteLine($"Text: {result.CodeText}");
}
}
}
}This repository includes an agents.md file at the root and in each category folder. These files provide AI coding agents with:
- Required namespaces and using directives for each category
- Correct API property paths and patterns
- Common pitfalls and prohibited patterns
- Example code fragments for key operations
If you are an AI coding agent generating Aspose.BarCode for .NET code, read the relevant agents.md before generating examples to avoid common API mistakes.
- .NET SDK 10.0 or later
- Aspose.BarCode for .NET 26.7.0 (via NuGet)
A valid Aspose license is required for production use. For evaluation, examples run without a license but output may include watermarks on generated barcode images.
Other Aspose products with agentic, build-validated example repositories:
| Product | Repository | Focus |
|---|---|---|
| Aspose.Words for .NET | aspose-words/agentic-net-examples | Word processing, DOCX, mail merge |
| Aspose.Cells for .NET | aspose-cells/agentic-net-examples | Spreadsheets, Excel, charts |
| Aspose.HTML for .NET | aspose-html/agentic-net-examples | HTML conversion, DOM editing |
| Aspose.Imaging for .NET | aspose-imaging/agentic-net-examples | Image conversion, manipulation |
| Aspose.Slides for .NET | aspose-slides/agentic-net-examples | Presentations, PowerPoint |
| Aspose.Email for .NET | aspose-email/agentic-net-examples | Email, calendars, messaging |
| Aspose.PDF for .NET | aspose-pdf/agentic-net-examples | PDF creation, conversion and manipulation |
- Aspose.BarCode for .NET Documentation — Guides, tutorials, and feature overviews
- API Reference — Complete class/method reference
- Release Notes — Version history and changelogs
- NuGet Package — Install via
dotnet add package Aspose.BarCode - Direct Downloads — MSI/ZIP installers and DLLs
- Aspose.BarCode Forum — Community Q&A and official support
- Aspose Blog - BarCode — Tutorials, tips, and product updates
- GitHub Issues — Bug reports and feature requests
- Purchase — Commercial license options
- Temporary License — Full-feature evaluation license
All examples use Aspose.BarCode for .NET and require a valid license for production use. See licensing options.
This repository is maintained by automated code generation. For AI-friendly guidance, see agents.md. Last updated: 2026-08-13
Updated: 2026-08-13 | Examples: 1124 | Categories: 21 | Package: Aspose.BarCode 26.7.0