Where does DataMatrixWriter live in the IronBarcode API?

DataMatrixWriter is a static class in the IronBarCode namespace, shipped in IronBarCode.dll. Call DataMatrixWriter.CreateDataMatrix directly to get a GeneratedBarcode, with no instance to construct.

How do you make a rectangular Data Matrix code in C#?

Call CreateDataMatrix with a DataMatrixWriter.DataMatrixShape and an explicit width and height. The simpler overload takes a single size instead and produces a square code.

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

System.Object

DataMatrixWriter

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[], DataMatrixWriter.DataMatrixShape, Int32, Int32, EciMode)

Renders a DataMatrix from a byte array, controlling how the UTF-8 ECI header is written.

Declaration

public static GeneratedBarcode CreateDataMatrix(byte[] binaryData, DataMatrixWriter.DataMatrixShape shape, int width, int height, EciMode eciMode)

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.
EciMode	eciMode	Controls UTF-8 ECI tagging. See EciMode.

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(Byte[], Int32, EciMode)

Renders a Square DataMatrix from a byte array, controlling how the UTF-8 ECI header is written.

Declaration

public static GeneratedBarcode CreateDataMatrix(byte[] binaryData, int size, EciMode eciMode)

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.
EciMode	eciMode	Controls UTF-8 ECI tagging. See EciMode.

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, DataMatrixWriter.DataMatrixShape, Int32, Int32, EciMode)

Renders a DataMatrix from a stream, controlling how the UTF-8 ECI header is written.

Declaration

public static GeneratedBarcode CreateDataMatrix(Stream binaryDataStream, DataMatrixWriter.DataMatrixShape shape, int width, int height, EciMode eciMode)

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.
EciMode	eciMode	Controls UTF-8 ECI tagging. See EciMode.

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(Stream, Int32, EciMode)

Renders a Square DataMatrix from a stream, controlling how the UTF-8 ECI header is written.

Declaration

public static GeneratedBarcode CreateDataMatrix(Stream binaryDataStream, int size, EciMode eciMode)

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.
EciMode	eciMode	Controls UTF-8 ECI tagging. See EciMode.

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, DataMatrixWriter.DataMatrixShape, Int32, Int32, EciMode)

Renders a DataMatrix from a String of data, controlling how the UTF-8 ECI header is written.

Declaration

public static GeneratedBarcode CreateDataMatrix(string value, DataMatrixWriter.DataMatrixShape shape, int width, int height, EciMode eciMode)

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.
EciMode	eciMode	Controls UTF-8 ECI tagging. See EciMode.

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.

CreateDataMatrix(String, Int32, EciMode)

Renders a Square DataMatrix from a string of data, controlling how the UTF-8 ECI header is written.

Declaration

public static GeneratedBarcode CreateDataMatrix(string value, int size, EciMode eciMode)

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.
EciMode	eciMode	Controls UTF-8 ECI tagging. See EciMode.

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.