Class Code128EncodingSegment
Represents a segment of data encoded with a specific Code 128 character set.
Inheritance
Namespace: IronBarCode
Assembly: IronBarCode.dll
Syntax
public class Code128EncodingSegment : Object
One contiguous run of Code 128 data encoded under a single character set is described by Code128EncodingSegment. A Code 128 barcode rarely stays in one set: the encoder shifts between sets A, B, and C to pack control codes, mixed text, and digit pairs efficiently, and each shift starts a new segment. A developer reaches for this object when the goal is to understand, run by run, exactly how a payload was laid out inside the symbol.
A segment sits inside the Segments list on Code128EncodingInfo, so a developer obtains it by inspecting an encoding report rather than constructing it directly. The object pins the run to its place and set. CharacterSet returns the Code128CharacterSet value that encoded the run, with CharacterSetName and CharacterSetShort giving readable and abbreviated labels for that set. Data holds the characters this run carried.
The position and size fields locate and measure the run. StartPosition is the run's offset within the original data, Length is how many source characters it covers, and SymbolCount is how many barcode symbols it consumed once encoded. Reading these together shows where a costly set switch happened and how many symbols it added, which is the practical way to explain why one input produced a wider barcode than another. The segment is read-only detail describing a finished encoding, so treat it as a measurement rather than a setting. The output data formats how-to shows how to surface these results, and the reading barcodes tutorial covers the surrounding read workflow.
using IronBarCode;
foreach (Code128EncodingSegment segment in info.Segments)
Console.WriteLine(
$"{segment.CharacterSetName} @ {segment.StartPosition}: {segment.Data} ({segment.SymbolCount} symbols)");The checksum and format validation how-to walks through validating encoded data.
Constructors
Code128EncodingSegment()
Declaration
public Code128EncodingSegment()
Properties
CharacterSet
The character set used for this segment.
Declaration
public Code128CharacterSet CharacterSet { get; }
Property Value
| Type | Description |
|---|---|
| Code128CharacterSet |
CharacterSetName
Gets the character set as a string (e.g., "Code A", "Code B", "Code C").
Declaration
public string CharacterSetName { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
CharacterSetShort
Gets a short representation of the character set (A, B, or C).
Declaration
public string CharacterSetShort { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
Data
The raw data content of this segment.
Declaration
public string Data { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
Length
The length of the data in the original input string.
Declaration
public int Length { get; }
Property Value
| Type | Description |
|---|---|
| System.Int32 |
StartPosition
The starting position in the original input string.
Declaration
public int StartPosition { get; }
Property Value
| Type | Description |
|---|---|
| System.Int32 |
SymbolCount
Number of Code 128 symbols required to encode this segment.
Declaration
public int SymbolCount { get; }
Property Value
| Type | Description |
|---|---|
| System.Int32 |
Methods
ToString()
Declaration
public override string ToString()
Returns
| Type | Description |
|---|---|
| System.String |