Class DataMatrixWriter
A class allowing for advanced control on the generation of DataMatrix type barcodes.
DataMatrixWriter allows setting of the DataMatrix shape.
Generated Barcodes can be exported as Images, Bitmaps, Files, or Streams.
Inheritance
Namespace: IronBarCode
Assembly: IronBarCode.dll
Syntax
public static class DataMatrixWriter : Object
Generating a Data Matrix code in C# runs through DataMatrixWriter, the dedicated writer for that 2D symbology. Its one static method returns a GeneratedBarcode, so there is nothing to construct: call DataMatrixWriter.CreateDataMatrix(...) and save, stamp, or export the result.
CreateDataMatrix is overloaded across input and shape. It encodes a string, byte[], or Stream, and each input has two forms. The simpler form takes a single size for a square code, while the second takes a DataMatrixWriter.DataMatrixShape along with an explicit width and height, which lets a developer request a rectangular Data Matrix where a layout calls for one. Data Matrix packs data densely into a small footprint, which suits marking small parts and components where a QR code would be too large. For QR codes or linear symbologies instead, use QRCodeWriter or BarcodeWriter. Because the call returns a GeneratedBarcode, the output format is chosen afterward, independent of how the value was encoded.
using IronBarCode;
DataMatrixWriter.CreateDataMatrix("SN-48291", 200).SaveAsPng("datamatrix.png");The create 2D barcodes how-to generates a Data Matrix, and the create barcode images how-to covers the save formats.
Methods
CreateDataMatrix(Byte[], DataMatrixWriter.DataMatrixShape, Int32, Int32)
Renders a DataMatrix.
Overload methods and methods of the created GeneratedBarcode object allow for barcode sizes and colors to be customized.
Declaration
public static GeneratedBarcode CreateDataMatrix(byte[] binaryData, DataMatrixWriter.DataMatrixShape shape, int width = 500, int height = 500)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Byte[] | binaryData | The value of the DataMatrix as a byte array. |
| DataMatrixWriter.DataMatrixShape | shape | The shape of the DataMatrix. |
| System.Int32 | width | The width of the DataMatrix in pixels. |
| System.Int32 | height | The height of the DataMatrix in pixels. |
Returns
| Type | Description |
|---|---|
| GeneratedBarcode | A GeneratedBarcode object for the DataMatrix which can be manipulated, annotated, and saved to an IronDrawing object, an image file, a PDF, a MediaURL, or a data stream. |
CreateDataMatrix(Byte[], Int32)
Renders a Square DataMatrix. For rendering of a rectangular DataMatrix, please find another overload of this method that supports width and height.
Overload methods and methods of the created GeneratedBarcode object allow for barcode sizes and colors to be customized.
See method overloads for rectangular DataMatrix shapes.
Declaration
public static GeneratedBarcode CreateDataMatrix(byte[] binaryData, int size = 500)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Byte[] | binaryData | The value of the DataMatrix as a byte array. |
| System.Int32 | size | The width and height of the DataMatrix in pixels. |
Returns
| Type | Description |
|---|---|
| GeneratedBarcode | A GeneratedBarcode object for the DataMatrix which can be manipulated, annotated, and saved to an IronDrawing object, an image file, a PDF, a MediaURL, or a data stream. |
CreateDataMatrix(Stream, DataMatrixWriter.DataMatrixShape, Int32, Int32)
Renders a DataMatrix.
Overload methods and methods of the created GeneratedBarcode object allow for barcode sizes and colors to be customized.
Declaration
public static GeneratedBarcode CreateDataMatrix(Stream binaryDataStream, DataMatrixWriter.DataMatrixShape shape, int width = 500, int height = 500)
Parameters
| Type | Name | Description |
|---|---|---|
| System.IO.Stream | binaryDataStream | The value of the DataMatrix as a stream. |
| DataMatrixWriter.DataMatrixShape | shape | The shape of the DataMatrix. |
| System.Int32 | width | The width of the DataMatrix in pixels. |
| System.Int32 | height | The height of the DataMatrix in pixels. |
Returns
| Type | Description |
|---|---|
| GeneratedBarcode | A GeneratedBarcode object for the DataMatrix which can be manipulated, annotated, and saved to an IronDrawing object, an image file, a PDF, a MediaURL, or a data stream. |
CreateDataMatrix(Stream, Int32)
Renders a Square DataMatrix. For rendering of a rectangular DataMatrix, please find another overload of this method that supports width and height.
Overload methods and methods of the created GeneratedBarcode object allow for barcode sizes and colors to be customized.
See method overloads for rectangular DataMatrix shapes.
Declaration
public static GeneratedBarcode CreateDataMatrix(Stream binaryDataStream, int size = 500)
Parameters
| Type | Name | Description |
|---|---|---|
| System.IO.Stream | binaryDataStream | The value of the DataMatrix as a stream. |
| System.Int32 | size | The width and height of the DataMatrix in pixels. |
Returns
| Type | Description |
|---|---|
| GeneratedBarcode | A GeneratedBarcode object for the DataMatrix which can be manipulated, annotated, and saved to an IronDrawing object, an image file, a PDF, a MediaURL, or a data stream. |
CreateDataMatrix(String, DataMatrixWriter.DataMatrixShape, Int32, Int32)
Renders a DataMatrix from a String of data. UTF-8 fully supported.
Overload methods and methods of the created GeneratedBarcode object allow for barcode sizes and colors to be customized.
Declaration
public static GeneratedBarcode CreateDataMatrix(string value, DataMatrixWriter.DataMatrixShape shape, int width = 500, int height = 500)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | value | The value of the DataMatrix as a string. Also suitable for URLS. |
| DataMatrixWriter.DataMatrixShape | shape | The shape of the DataMatrix. |
| System.Int32 | width | The width of the DataMatrix in pixels. |
| System.Int32 | height | The height of the DataMatrix in pixels. |
Returns
| Type | Description |
|---|---|
| GeneratedBarcode | A GeneratedBarcode object for the DataMatrix which can be manipulated, annotated, and saved to an IronDrawing object, an image file, a PDF, a MediaURL, or a data stream. |
CreateDataMatrix(String, Int32)
Renders a Square DataMatrix from a string of data. UTF-8 fully supported. For rendering of a rectangular DataMatrix, please find another overload of this method that supports width and height.
Overload methods and methods of the created GeneratedBarcode object allow for barcode sizes and colors to be customized.
See method overloads for rectangular DataMatrix shapes.
Declaration
public static GeneratedBarcode CreateDataMatrix(string value, int size = 500)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | value | The value of the DataMatrix as a string. Also suitable for URLS. |
| System.Int32 | size | The width and height of the DataMatrix in pixels. |
Returns
| Type | Description |
|---|---|
| GeneratedBarcode | A GeneratedBarcode object for the DataMatrix which can be manipulated, annotated, and saved to an IronDrawing object, an image file, a PDF, a MediaURL, or a data stream. |