如何建立一維和直線條碼

Code 128 BarCode 常用於內部物流和運送標籤。 它支援完整的 128 個字元 ASCII 範圍，因此能高效率地將標準數字和英文文字壓縮到很小的空間內。

然而，在沒有額外擴充的情況下，本機不允許使用 Unicode 或非拉丁字符。 它不支援中文或阿拉伯文等語言的複雜字元，反而會誤解資料，導致不正確的輸出。

程式碼

IronBarcode 讓 Code-128 的產生變得簡單直接：我們在呼叫 Create 方法時，將 BarcodeEncoding.Code128 傳送為第二個參數，然後將它匯出為影像。

:path=/static-assets/barcode/content-code-examples/how-to/create-code-128-barcode.cs

using IronBarCode;

// Specify Code 128 Format
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.Code128);

// Add barcode value text below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save it as JPG
barcode.SaveAsJpeg("code128-sample.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

GS1-128 是應用在 Code 128 之上的附加資料格式。GS1-128 的主要優勢在於它允許全球一致地解釋資料，消除誤解和資料歧義。

然而，由於其格式嚴格，遺漏隱藏控制字元或弄錯欄位長度都會使 BarCode 不合乎規範，造成手動建立的困難。

GSI-128格式化

BarCode 掃描器也會使用 人工智慧（應用程式識別碼），這是一個數字前綴，用來識別產品代碼中的資訊。

GS1-128 遵循如下所示的四部分資料結構：

（數字前綴 01）GTIN（全球貿易項目編號）：結構的第一部分是全球貿易項目編號。 這是產品的唯一 ID，可識別該產品是什麼。 必須正好是 14 位數的數值資料。 如果產品代碼較短，則必須用前導零填充值。 例如，如果您的產品代碼是 12 位數的數字，如 123456789012，您必須在前面加上兩個零才能符合要求（如 00123456789012）。

（數字前綴 10）批次/批量：數字前綴 10 識別 GS1-128 編碼中產品的批次或批量號碼。 格式可從 1 到 20 個字母數字字符不等。 如果您將批號放在 BarCode 的中間，請確保將 FNC1 置於分隔符，以便掃描器知道批號在哪裡結束，下一個欄位在哪裡開始。 如果批號在 BarCode 的最末端，則不需要使用分隔符。

（數字前綴 17）有效日期：在數字前綴 17 之後，是產品的到期日。 格式固定為六位數。 它嚴格遵循 YYMMDD 規則； 例如，251231 就是 2025 年 12 月 31 日。請注意，它不使用 4 位數的年份，並會根據滑動視窗自動假設世紀。

（數字前綴 21）序號：在數字前綴 21 之後，是產品的序號。 它識別了獨特的個人單元。 格式為長度可變，包含 1-20 個字母數字字符。

[{i:(請注意，產品代碼中總是只需要錨點 (例如 GTIN)； 批次、有效期和 nd 序列屬性對於 BarCode 來說是可選的。@@--括號關閉--@@

[{w:(雖然只要求提供 GTIN，但有些零售商可能對於 BarCode 有自己的合規指引。 請確保在建立 BarCode 時檢查其端的相關資訊。 @@--括號關閉--@@

GSI 格式表

程式碼

生成 GS1-128 BarCode 相對容易； 開發人員在呼叫 Create 時，只需傳入 BarcodeEncoding.Code128GS1 作為第二個參數。

下面的範例顯示一個完整的 GS1-128 相容值，包含所有四個屬性，之後將它匯出為影像。

[{i:(請注意，如下所示，每個數字前綴都必須使用括號括弧，否則該特定部分將不會被識別為有效屬性，並在生成最終 BarCode 時被跳過。

[{i:(IronBarcode 在建立 GSI-128 時會自動為您插入 FNC1 分隔符。

:path=/static-assets/barcode/content-code-examples/how-to/create-gsi-128-barcode.cs

using IronBarCode;

// Valid GS1-128 String: GTIN + Expiry + Batch + Serial Number
string gs1Value = "(01)01234567890128(17)251231(10)BATCH001(21)111111";

// Create the barcode
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(gs1Value, BarcodeEncoding.Code128GS1);

// Display the value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("gsi128-sample.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

如果您的字串值不符合 GS1-128 的標準，IronBarcode 會在執行程式碼時產生異常。 請參考上表確認您的字串值，並據此修改字串值。

Code 39 是最早可用的字母數字 BarCode 標準之一，以可靠性著稱。 Code 39 BarCode 最常見的使用案例是在汽車和國防領域。

然而，Code 39 允許的字元集相對較少。 它只允許大寫的英文字元、數字和一些符號，例如 /、.、- 等。在標準模式下，它不支援小寫字元。

程式碼

要產生 Code39 條碼，我們必須在使用 Create 方法時，傳入 BarcodeEncoding.Code39 作為第二個參數。

以下是一個範例。

:path=/static-assets/barcode/content-code-examples/how-to/create-code-39-barcode.cs

using IronBarCode;

// Specify Code39 Format
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("IRON-1234", BarcodeEncoding.Code39);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("code39.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

如果字串值不符合 Code39 標準，IronBarcode 會產生此異常。

[{w:( 雖然 Code39 的擴展模式支援完整的 ASCII 字元範圍，IronBarcode 目前仍不支援產生 Code39 擴展模式條碼； 目前僅支援閱讀。 如需閱讀擴展和標準 Code39，請參閱 此處@@--括號關閉--@@。

Code 93 是 Code 39 的改良版，常用於空間有限但需要字母數字資料的物流和電子元件標籤。

它接受全部的 ASCII 字元以及大寫英文字母、數字和符號。 它比 Code 39 提供更高的密度。

程式碼

要生成 Code 93 條碼，請在使用 Create 時，將 BarcodeEncoding.Code93 傳入作為第二個參數。 以下是它的範例程式碼。

:path=/static-assets/barcode/content-code-examples/how-to/create-code-93-barcode.cs

using IronBarCode;

// Valid Input: Uppercase A-Z, 0-9, specific symbols
string code93Value = "ELEC-COMP-99";

// Create Code 93
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(code93Value, BarcodeWriterEncoding.Code93);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("code93.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

Codabar 常用於預期列印品質較差的場合，因為它相當堅固耐用。因此，它被廣泛用於血庫和圖書館等場景。

Codabar BarCode 格式的長度可變，但其支援的字元集有限。 只能包含數字 (0-9) 和符號，例如 (-, $, :, /, ., +) 。 您也可以使用開始和停止字元 A、B、C 和 D 來表示開始或結束的時間。 但是，您不能將這些字元放在中間部分； 僅允許在開頭或結尾使用。

程式碼

若要產生 Codabar 條碼，請在使用 Create 時傳入 BarcodeEncoding.Codabar 作為第二個參數。 以下是它的範例程式碼。

:path=/static-assets/barcode/content-code-examples/how-to/create-codabar-barcode.cs

using IronBarCode;

// Valid Input: Numbers 0-9 and symbols -$:/.+ IronBarcode automatically appends by A, B, C, or D
string codabarValue = "10500200";

// Create Codabar
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(codabarValue, BarcodeWriterEncoding.Codabar);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("codabar.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

如果輸入值包含字母，IronBarcode 會產生異常，說明它只接受數值。

GS1 DataBar (前身為 RSS-14)是一個標準、更精簡的版本，設計用來保存產品識別碼。

類似 GS1-128 變體，它有嚴格的編碼格式，開發人員必須遵守。 Omnidirectional 變體包含 僅產品代碼屬性。

GS1-DataBar 格式

(數字 prefix-01) GTIN（全球貿易項目編號） : 結構的第一部分，也是唯一的部分是全球貿易貨物編號。 這是產品的唯一 ID。 必須正好是 14 位數的數值資料。

[{w:(標準"GS1 DataBar Omnidirectional"只能****容納 GTIN (01)。 若要包含以下額外部分，您必須使用 GS1 DataBar Expanded.@@--括號關閉--@@

程式碼

若要產生 GS1 DataBar 條碼，請在使用 Create 時傳入 BarcodeEncoding.DataBar 作為第二個參數。 以下是它的範例程式碼。

:path=/static-assets/barcode/content-code-examples/how-to/create-gs1-databar-barcode.cs

using IronBarCode;

// Valid Input: Exactly 14 digits (GTIN). IronBarcode will calculate and append the correct check digit.
string databarValue = "0123456789012";

// Create GS1 DataBar
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(databarValue, BarcodeWriterEncoding.DataBar);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("databar.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

EAN-13 是全世界用來辨識消費性產品的標準零售條碼，也是使用最廣泛的條碼格式之一。

然而，EAN-13 通常是透過嚴格的授權取得。 您不能簡單地產生一個供大眾使用的 EAN-13 編號； 您必須授權 GS1 公司前綴，以確保您的 BarCode 是獨一無二的。 此外，還要遵循只能包含 13 位數字，且為數字型。

此外，EAN-13 也有其特定的格式規則。

EAN-13格式化

如下所示，EAN-13 BarCode 由四個部分組成。

GS1 前綴 (前三位數)：識別 GS1 成員組織，通常是製造商註冊的國家。 例如，000-019 (美國/加拿大 - 與 UPC 相容)、500-509 (英國)、450-459 (日本)。

製造商代碼：由 GS1 指定給公司的長度可變的代碼。

產品代碼：由製造商指定給特定商品。

校驗碼（最後一位數）：使用 Modulo 10 演算法從前 12 位數計算出來的一位數。 可確保掃描器能正確讀取 BarCode。

[{w:(以 2 開頭的前綴（特別是 200-299）保留給限制發行的號碼。 因此，在生產環境中，生成 EAN-13 條碼時請勿使用這些前綴。

程式碼

若要產生 EAN-13 條碼，請在使用 Create 時，將 BarcodeEncoding.EAN13 傳送至第二個參數。 以下是它的範例程式碼。

:path=/static-assets/barcode/content-code-examples/how-to/create-ean13-barcode.cs

using IronBarCode;

// Valid Input: 12 digits (library calculates 13th check digit) or full 13 digits.
string ean13Value = "4006381333931";

// Create EAN-13
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(ean13Value, BarcodeWriterEncoding.EAN13);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("ean13.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

IronBarcode 只有在有其他字符的情況下才會對數值產生異常。

EAN-8 是標準 EAN-13 零售條碼的濃縮版本。 主要的使用案例為小型消費性產品，因為全尺寸的 BarCode 會佔用太多的空間。 鉛筆和化妝品等物品通常是您會發現 EAN-8 BarCode 的地方。

與 Code 128 或 Code 39 不同，EAN-8 一般會指定特定的前綴，而不是由開發人員任意指定一個數字。

因此，EAN-8 使用嚴格的 8 位數格式。 它有 7 個資料位元和正好 1 個校驗位元，而且只有數字。

程式碼

創建 EAN-8 編碼只需在使用 Create 時將 BarcodeEncoding.EAN8 值傳給第二個參數即可。 以下是一個範例。

:path=/static-assets/barcode/content-code-examples/how-to/create-ean8-barcode.cs

using IronBarCode;

// Valid Input: 7 digits (library calculates 8th check digit).
string ean8Value = "1234567";

// Create EAN-8
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(ean8Value, BarcodeWriterEncoding.EAN8);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("ean8.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

如果輸入值包含 8 個或更多的數字字符，IronBarcode 會產生異常，說明 EAN-8 長度要求為 8 個字元。

Intelligent Mail BarCode (IMB) 是 USPS 用於自動化郵件分類與追蹤的標準。 傳統的 BarCode 條碼在條碼寬度上會有所不同，而 IMB 則不同，它使用高度調變的條碼來編碼資料。 必須索取信件和單位的自動化價格折扣。 IMB BarCode 僅支援一組特定的數字長度； 數值必須是 20、25、29 或 31 位數。

此外，它還採用了一套特定的數字前綴來定義資訊，如下所示。

智慧型郵件格式化

（前兩位數）Barcode ID：結構的第一部分是 BarCode Identifier。 這是嚴格的 2 位數數值資料。 對於大多數標準商業郵件而言，此值為 00。

（接下來的 3 位數）服務類型 ID (STID)：接下來的 3 位數定義了郵件的類別（例如：一等郵件、行銷郵件）和您要求的服務（例如：地址更正、追蹤）。 這對於郵政折扣是非常重要的。

（接下來的 6 或 9 位數）郵寄者 ID (MID)： 在 STID 之後，接著是 Mailer ID。 這是 USPS 直接分配給貴公司的 6 位或 9 位數字號碼。

（接下來的 6 或 9 位數）序號：在 Mailer ID 之後就是序列號。 這可以識別出獨特的個人郵件。

（最後 0、5、9 或 11 位數）路由代碼：結構的最後一部分是路由代碼，簡單來說就是送貨郵遞區號。

程式碼

若要產生 IMB 條碼，我們在呼叫 Create 方法時，將 BarcodeEncoding.IntelligentMail 傳送為第二個參數。 以下是一個範例展示。

:path=/static-assets/barcode/content-code-examples/how-to/create-imb-barcode.cs

using IronBarCode;

// Valid Input: 20, 25, 29, or 31 digits. 
// Format: Barcode ID(2) + Service(3) + Mailer ID(6/9) + Serial(9/6) + Routing Zip(0/5/9/11)
string imbValue = "00270123456200800001";

// Create Intelligent Mail
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(imbValue, BarcodeWriterEncoding.IntelligentMail);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("imb.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

IronBarcode 如果不遵循格式，會產生異常，說明格式不正確。 請驗證上述格式的字串值，並在修改後重試。

MSI 是一種常用於零售貨架標籤和倉庫庫存控制的 BarCode，但很少出現在消費性產品上。

MSI 是僅限數字的 BarCode； 因此，不允許使用字母或符號。 長度不一，但標準約為 10-15 位數。

程式碼

要產生 MSI 條碼，我們在呼叫 Create 方法時，將 BarcodeEncoding.MSI 傳送為第二個參數。 以下是一個範例展示。

:path=/static-assets/barcode/content-code-examples/how-to/create-msi-barcode.cs

using IronBarCode;

// Valid Input: Numeric digits only. Variable length.
string msiValue = "1234567890";

// Create MSI
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(msiValue, BarcodeWriterEncoding.MSI);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("msi.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

UPC-A 是美國和加拿大使用的標準零售條碼。 它是 EAN-13 標準的 12 位元子集。 這些工具最常見於北美超市銷售的產品上。

與 EAN-13 相似，它通常是指派而非產生的。

UPC-A 包含正好 12 位數字，不接受任何字母。

UPC-A 格式化

Number System Character (1)：識別產品類型（0、1、6、7、8 通常用於標準零售； 2 代表隨機重量，3 代表藥物，5 代表優惠券）。

製造商代碼 (5)：由 GS1 指定。

產品代碼 (5)：由製造商指定。

校驗碼 (1)：計算的 modulo 10 檢查和。

程式碼

為了產生 UPC-A 條碼，我們在呼叫 Create 方法時，將 BarcodeEncoding.UPCA 傳送為第二個參數。 以下是一個範例展示。

:path=/static-assets/barcode/content-code-examples/how-to/create-upc-a-barcode.cs

using IronBarCode;

// Valid Input: 11 digits (library calculates 12th check digit) or full 12 digits.
string upcaValue = "01234567890";

// Create UPC-A
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(upcaValue, BarcodeWriterEncoding.UPCA);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG 
barcode.SaveAsJpeg("upca.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

如您所見，如果所提供的數值長度超過 13，IronBarcode 就會發生錯誤。

UPC-E 是標準 UPC-A 條碼的精簡版本。 它明確針對小型零售包裝（例如汽水罐）而設計，在這種包裝上，完整的 12 位元 UPC-A BarCode 會因太大而無法掃描。

與 UPC-A 格式一樣，它是嚴格的數字格式，不接受字母和符號。

程式碼

若要產生 UPC-E 條碼，我們在呼叫 Create 方法時，將 BarcodeEncoding.UPCE 傳送為第二個參數。 以下是一個範例展示。

:path=/static-assets/barcode/content-code-examples/how-to/create-upc-e-barcode.cs

using IronBarCode;

// Valid Input:8 digits or less, which the last digit is a check digit calculated from the first 7 digits. 
// IronBarcode automatically calculates the check digit if only 7 digits are provided.
string upceValue = "0123456";

// Create UPC-E
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(upceValue, BarcodeWriterEncoding.UPCE);

// Stamp barcode value below the barcode
barcode.AddBarcodeValueTextBelowBarcode();

// Save as a JPG file
barcode.SaveAsJpeg("upce.jpg");

IRON VB CONVERTER ERROR developers@ironsoftware.com

輸出

故障排除

如您所見，如果提供的數字位數超過 8，IronBarcode 就會出錯。

不同 1D BarCode 類型概述