Generating Barcode PDF-417 in .NET is one of the functions in OnBarcode's
.NET Barcode Generators, which supports creating & printing PDF-417 and 30+ other linear & 2D bar codes for C#, VB.NET & ASP.NET applications.
OnBarcode develops several .NET Barcode Generation components for different .NET development environments:
.NET PDF 417 Generator encodes:
- all 128 characters of ASCII
- values 128-255 in accordance with ISO 8859-1. There are referred to as extended ASCII.
Category |
Properties |
Value |
Comments |
Basic |
Property: Data
URL: DATA
|
Type: string
Default: "PDF417"
|
Barcode value to encode
PDF-417 Valid Data Char Set:
- Text Compaction mode permits all printable ASCII characters to be encoded, i.e. values
32 - 126 inclusive in accordance with ISO/IEC 646 (IRV), as well as selected control characters.
- Byte Compaction mode permits all 256 possible 8-bit byte values to be encoded. This
includes all ASCII characters value 0 to 127 inclusive and provides for international character set
support.
- Numeric Compaction mode permits efficient encoding of numeric data strings.
- Up to 811,800 different character sets or data interpretations.
- Various function codewords for control purposes.
|
|
PDF 417 Special |
Property: ProcessTilde
URL: PROCESS-TILDE
|
Type: bool
Default: true
|
Set the ProcessTilde property to true, if you want use the tilde character "~" to specify special characters in the input data. Default is true.
- 1-byte character: ~0dd/~1dd/~2dd (character value from 000 ~ 255); ASCII character '~' is presented by ~126
Strings from "~256" to "~299" are unused
- 2-byte character (Unicode): ~6ddddd (character value from 00000 ~ 65535)
Strings from "~665536" to "~699999" are unused
- Programming for reader initialisation: ~rp.
This should be located at the beginning of the encoding data, e.g. data = "~rpABCD1234".
- ECI: ~7dddddd (valid value of dddddd from 000000 to 999999)
|
Property: DataMode
URL: DATA-MODE
|
Type: PDF417DataMode
Default: PDF417DataMode.Text (1)
|
valid values:
- PDF417DataMode.Auto (0)
- PDF417DataMode.Text (1)
- PDF417DataMode.Byte (2)
- PDF417DataMode.Numeric (3)
- PDF417DataMode.Customer (4)
|
Property: ECL
URL: ECL
|
Type: PDF417ECL
Default: PDF417ECL.Level_2 (2)
|
Error correction level, values are from PDF417ECL.Level_0 to PDF417ECL.Level_8, default is PDF417ECL.Level_2. |
Property: RowCount
URL: ROW-COUNT
|
Type: int
Default: 3
|
The number of rows for PDF417. The value range is from 3 to 90. The default is 3. |
Property: ColumnCount
URL: COLUMN-COUNT
|
Type: int
Default: 5
|
Number of columns. The value range is from 1 to 30. The default is 5. Increase this value, if your data size is large. |
Property: Truncated
URL: TRUNCATED
|
Type: bool
Default: false
|
truncated PDF417 may be used where space considerations are a primary concern and symbol damage is unlikely. |
Property: Macro
URL: MACRO
|
Type: bool
Default: false
|
Set isMacro property to true, then Macro PDF417 is enabled. |
Property: MacroSegmentIndex
URL: MACRO-SEGMENT-INDEX
|
Type: int
Default: 0
|
the position of current symbol in the secuence (Start with 0). |
Property: MacroSegmentCount
URL: MACRO-SEGMENT-COUNT
|
Type: int
Default: 0
|
the number of total symbols which make the sequence. |
Property: MacroFileIndex
URL: MACRO-FILE-INDEX
|
Type: int
Default: 0
|
be identified to the same file |
|
Barcode Size Related |
Property: AutoResize
URL: AUTO-RESIZE
|
Type: bool
Default: false
|
Auto resize the generated barcode image
|
Property: BarAlignment
URL: BAR-ALIGNMENT
|
Type: int
Default: 1 (center)
|
Barcode horizontal alignment inside the image. 0: left, 1: center, 2: right. |
Property: UOM
URL: UOM
|
Type: UnitOfMeasure
Default: PIXEL (0)
|
Unit of meature for all size related settings in the library.
Valid values:
- UnitOfMeasure.PIXEL (0)
- UnitOfMeasure.CM (1)
- UnitOfMeasure.INCH (2)
|
Property: X
URL: X
|
Type: float
Default: 2
|
Barcode bar module width, default is 3 pixel |
Property: XtoYRatio
URL: X-Y-RATIO
|
Type: float
Default: 0.3333333f
|
Bar width vs bar height ratio |
Property: BarcodeWidth
URL: BARCODE-WIDTH
|
Type: float
Default: 0
|
Barcode image width.
If BarcodeWidth setting is smaller than the barcode required minimum width, the library will automatically reset to barcode minimum width. |
Property: BarcodeHeight
URL: BARCODE-HEIGHT
|
Type: float
Default: 0
|
Barcode image height.
If BarcodeHeight setting is smaller than the barcode required minimum height, the library will automatically reset to barcode minimum height. |
Property: LeftMargin
URL: LEFT-MARGIN
|
Type: float
Default: 0
|
Barcode image left margin size. |
Property: RightMargin
URL: RIGHT-MARGIN
|
Type: float
Default: 0
|
Barcode image right margin size. |
Property: TopMargin
URL: TOP-MARGIN
|
Type: float
Default: 0
|
Barcode image top margin size. |
Property: BottomMargin
URL: BOTTOM-MARGIN
|
Type: float
Default: 0
|
Barcode image bottom margin size. |
Property: Resolution
URL: RESOLUTION
|
Type: int
Default: 72
|
Barcode image resolution in DPI (Dots per inch). |
Property: Rotate
URL: ROTATE
|
Type: Rotate
Default: Rotate.Rotate0 (0)
|
Valid values:
- Rotate.Rotate0 (0)
- Rotate.Rotate90 (1)
- Rotate.Rotate180 (2)
- Rotate.Rotate270 (3)
|
|
Barcode Colors |
Property: BackColor
URL: BACK-COLOR
|
Type: Color
Default: white
|
Barcode image background color |
Property: ForeColor
URL: FORE-COLOR
|
Type: Color
Default: black
|
Barcode image foreground color
|
|
In WebStream query string, please use int value for Enums, "true" and "false" for bool. |
using System;
using System.Collections.Generic;
using System.Text;
using OnBarcode.Barcode;
using System.Drawing.Imaging;
using System.Drawing;
PDF417 pdf417 = new PDF417();
// Barcode data to encode
pdf417.Data = "OnBarcode";
// PDF-417 data mode
pdf417.DataMode = PDF417DataMode.Text;
// PDF-417 rows & columns
pdf417.RowCount = 5;
pdf417.ColumnCount = 5;
/*
* Barcode Image Related Settings
*/
// Unit of meature for all size related setting in the library.
pdf417.UOM = UnitOfMeasure.PIXEL;
// Bar module width (X), default is 3 pixel;
pdf417.X = 2;
// Bar module width vs height
pdf417.XtoYRatio = 0.3333333f;
// Barcode image left, right, top, bottom margins. Defaults are 0.
pdf417.LeftMargin = 0;
pdf417.RightMargin = 0;
pdf417.TopMargin = 0;
pdf417.BottomMargin = 0;
// Image resolution in dpi, default is 72 dpi.
pdf417.Resolution = 72;
// Created barcode orientation.
//4 options are: facing left, facing right, facing bottom, and facing top
pdf417.Rotate = Rotate.Rotate0;
// Generate PDF-417 and encode barcode to gif format
pdf417.ImageFormat = System.Drawing.Imaging.ImageFormat.Gif;
pdf417.drawBarcode("C:\\pdf417.gif");
/*
You can also call other drawing methods to generate barcodes
public void drawBarcode(Graphics graphics);
public void drawBarcode(string filename);
public Bitmap drawBarcode();
public void drawBarcode(Stream stream);
*/