Back to Devexpress

GS1-128 (UCC/EAN-128)

xtrareports-11924-feature-guide-to-devexpress-reports-use-report-controls-use-bar-codes-gs1-128-ean-128-ucc.md

latest3.8 KB
Original Source

GS1-128 (UCC/EAN-128)

  • Feb 18, 2026
  • 2 minutes to read

GS1-128 is a variable length self-checking symbololgy. GS1-128 is a subset of a more general Code 128 symbology.

Refer to the GS1 specification for more details.

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 EAN128 (an object of the EAN128Generator type).

  3. Specify common barcode properties and properties specific to EAN-128.

Specific Properties

Runtime Example

The following code creates the GS1-128 - EAN-128 (UCC) 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 CreateGS1128BarCode(string BarCodeText) {
    // Create a barcode control.
    XRBarCode barCode = new XRBarCode();

    // Set the barcode's type to EAN 128.
    barCode.Symbology = new EAN128Generator();

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

    // Adjust the properties specific to the barcode type.
    ((EAN128Generator)barCode.Symbology).CharacterSet = Code128Charset.CharsetB;

    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 CreateGS1128BarCode(ByVal BarCodeText As String) As XRBarCode
    ' Create a barcode control.
    Dim barCode As New XRBarCode()

    ' Set the barcode's type to EAN 128.
    barCode.Symbology = New EAN128Generator()

    ' Adjust the barcode's main properties.
    barCode.Text = BarCodeText
    barCode.Width = 400
    barCode.Height = 100

    ' Adjust the properties specific to the barcode type.
    CType(barCode.Symbology, EAN128Generator).CharacterSet = Code128Charset.CharsetB

    Return barCode
End Function

The code example below shows how to create a report with the GS1-128 barcode:

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

var barCode = CreateGS1128BarCode("012345678");

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

Private barCode = CreateGS1128BarCode("012345678")

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