GS1 Data Matrix

Feb 18, 2026
3 minutes to read

GS1 Data Matrix is a variant of the Data Matrix symbology that conforms to GS1 specifications.

Refer to the GS1 General Specification for more details.

Add the Bar Code to a Report

Drag the XRBarCode item from the DX.25.2: Report Controls tab and drop it onto the report.
Set the XRBarCode control’s Symbology property to DataMatrixGS1 (an object of the DataMatrixGS1Generator type).
Specify common barcode properties and properties specific to GS1 Data Matrix.

Specific Properties

Runtime Example

The following code creates the GS1- Data Matrix barcode and specifies its properties.

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

Form1.cs
Form1.vb

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 CreateDataMatrixGS1BarCode(string BarCodeText) {
    // Create a barcode control.
    XRBarCode barCode = new XRBarCode();

    // Set the barcode's type to Data Matrix GS1.
    barCode.Symbology = new DataMatrixGS1Generator();

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

    // Adjust the properties specific to the barcode type.
    // (Assigned below are the default values.)
    ((DataMatrixGS1Generator)barCode.Symbology).FNC1Substitute = "#";
    ((DataMatrixGS1Generator)barCode.Symbology).HumanReadableText = true;
    ((DataMatrixGS1Generator)barCode.Symbology).MatrixSize = DataMatrixSize.MatrixAuto;

    return barCode;
}

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

    ' Set the barcode's type to Data Matrix GS1.
    barCode.Symbology = New DataMatrixGS1Generator()

    ' Adjust the barcode's main properties.
    barCode.AutoModule = True
    barCode.Text = BarCodeText
    barCode.ShowText = True
    barCode.Width = 200
    barCode.Height = 200

    ' Adjust the properties specific to the barcode type.
    ' (Assigned below are the default values.)
    CType(barCode.Symbology, DataMatrixGS1Generator).FNC1Substitute = "#"
    CType(barCode.Symbology, DataMatrixGS1Generator).HumanReadableText = True
    CType(barCode.Symbology, DataMatrixGS1Generator).MatrixSize = DataMatrixSize.MatrixAuto

    Return barCode
End Function

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

C#
VB.NET

csharp

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

var barCode = CreateDataMatrixGS1BarCode("012345678");

var report = new XtraReport() {
    Bands = {
        new DetailBand() {
            Controls = { barCode }
        }
    }
};

Imports DevExpress.XtraPrinting.BarCode
Imports DevExpress.XtraReports.UI
'...

Private barCode = CreateDataMatrixGS1BarCode("012345678")

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