Back to Devexpress

UPC-A

xtrareports-11934-feature-guide-to-devexpress-reports-use-report-controls-use-bar-codes-upc-a.md

latest3.5 KB
Original Source

UPC-A

  • Feb 18, 2026
  • 2 minutes to read

The Universal Product Code (UPC) is a barcode symbology that is widely used in the United States, Canada, Europe, Australia, New Zealand, and other countries for tracking trade items in stores.

Refer to the following article for more information: Universal Product Code.

Add the Bar Code to a Report

  1. Drag the XRBarCode item from the DX.25.2: Report Controls tab and drop it onto the report.

  2. Set the XRBarCode control’s Symbology property to UPCA (an object of the UPCAGenerator type).

  3. Specify common barcode properties.

Note

The control does not verify the length of the assigned character string specified by the barcode control’s Text value. It is the developer’s responsibility to check that the passed string contains no more than 11 digits (the control calculates the last twelfth digit automatically). If the number of digits is less than 11 , the leading zeroes are added to the resulting barcode.

Runtime Example

The following code creates the UPC-A barcode and specifies its properties.

View Example: How to add a bar code to a report

csharp
using System;
using System.Collections.Generic;
using System.Drawing.Printing;
using System.Windows.Forms;
using DevExpress.XtraPrinting.BarCode;
using DevExpress.XtraReports.UI;
// ...
public XRBarCode CreateUPCABarCode(string BarCodeText) {
    // Create a barcode control.
    XRBarCode barCode = new XRBarCode();

    // Set the barcode's type to UPC-A.
    barCode.Symbology = new UPCAGenerator();

    // Adjust the barcode's main properties.
    barCode.Text = BarCodeText;
    barCode.Width = 275;
    barCode.Height = 200;

    return barCode;
}
vb
Imports System
Imports System.Collections.Generic
Imports System.Drawing.Printing
Imports System.Windows.Forms
Imports DevExpress.XtraPrinting.BarCode
Imports DevExpress.XtraReports.UI
' ...
Public Function CreateUPCABarCode(ByVal BarCodeText As String) As XRBarCode
    ' Create a barcode control.
    Dim barCode As New XRBarCode()

    ' Set the barcode's type to UPC-A.
    barCode.Symbology = New UPCAGenerator()

    ' Adjust the barcode's main properties.
    barCode.Text = BarCodeText
    barCode.Width = 275
    barCode.Height = 200

    Return barCode
End Function

The code example below shows how to create a report with the UPC-A barcode:

csharp
using DevExpress.XtraPrinting.BarCode;
using DevExpress.XtraReports.UI;
//...

var barCode = CreateUPCABarCode("012345678");

var report = new XtraReport() {
    Bands = {
        new DetailBand() {
            Controls = { barCode }
        }
    }
};
vb
Imports DevExpress.XtraPrinting.BarCode
Imports DevExpress.XtraReports.UI
'...

Private barCode = CreateUPCABarCode("012345678")

Dim report As New XtraReport()
Dim band = New DetailBand()
band.Controls.Add(barCode)