IRONSOFTWAREHOME
IRONBARCODE 사용

C#에서 Code 128 바코드를 생성하는 방법

Curtis Chau
Curtis Chau
Updated: 2026년 4월 21일

바코드는 재고 관리부터 제품 라벨링 및 배송까지 현대 비즈니스 운영에서 매우 중요합니다. Code 128은 다양한 바코드 코드 세트 중에서도 다양한 용도로 광범위하게 사용됩니다. 이 기사에서는 IronBarcode 라이브러리를 사용하여 C#에서 Code 128 바코드 생성기를 만드는 방법을 살펴볼 것입니다.

How to Generate Code 128 Barcode in C#

  1. IronBarcode 라이브러리 설치
  2. Code 128 인코딩을 사용하여 바코드 생성
  3. 바코드 크기 조정
  4. 배경 및 바코드 색상을 변경하여 바코드 스타일 지정
  5. 생성된 바코드 읽기

Code 128 바코드 소개

Code 128 코드 세트는 고밀도의 가변 길이 선형 바코드로, 알파벳과 특수 문자를 모두 인코딩할 수 있습니다. 자기 검증 기능이 있으며, 데이터 정확성을 보장하기 위해 체크섬 숫자를 포함합니다. Code 128 인코딩 스킴은 세 가지 제어 문자를 지원합니다:

  1. 문자 집합 A: 대문자, 숫자 및 특수 문자를 포함합니다.
  2. 문자 집합 B: 대문자, 소문자, 숫자 및 추가 특수 문자를 포함합니다.
  3. 문자 집합 C: 숫자 쌍(00에서 99까지)을 인코딩합니다.

왜 IronBarcode인가?

IronBarcode는 바코드 생성, 디코딩 및 커스터마이징을 지원하는 견고한 .NET 라이브러리입니다. Code 128, Code 39, Code 93, Code EAN 13, EAN 8, QR 코드등 다양한 바코드 인코딩을 지원합니다. 내용, 크기 및 외관 조정을 위한 직관적인 API를 제공합니다. 디코딩 기능, 자동 체크섬 계산, 이미지 내보내기 기능은 재고 관리 등에서 개발자에게 귀중한 도구입니다. 라이브러리의 속성, 여백, 글꼴 및 색상을 커스터마이징할 수 있는 옵션은 바코드 관련 작업에서 그 유연성을 높입니다.

Creating Code 128 Barcode Generator in C#

자, 이제 C#에서 코드 128 바코드 이미지를 생성하는 코드를 작성해 보겠습니다. 첫 번째 단계는 프로젝트에 IronBarcode 라이브러리를 설치하는 것입니다. 프로젝트는 Windows Forms, web forms, MAUI, Xamarin, ASP.NET MVC, Razor, Blazor 프로젝트 등 어떤 종류라도 가능합니다.

IronBarcode 라이브러리 설치하기

Visual Studio의 패키지 관리자 콘솔을 사용하여 IronBarcode NuGet 패키지를 설치하려면 다음 단계를 따르십시오:

  1. Visual Studio를 엽니다.

  2. 상단 메뉴에서 "보기" > "다른 창" > "패키지 관리자 콘솔"로 이동하여 패키지 관리자 콘솔을 엽니다.

  3. 패키지 관리자 콘솔에서 Install-Package 명령을 사용하여 IronBarcode 패키지를 설치할 수 있습니다. 다음 명령을 입력하고 Enter 키를 누르세요:

    Install-Package BarCode
    SHELL
  4. 이 명령은 IronBarcode NuGet 패키지의 최신 버전과 그 종속 항목을 프로젝트에 다운로드하고 설치합니다.

프로젝트에서 바코드 라이브러리를 사용하려면 다음 네임스페이스를 추가하십시오.

using IronBarCode;

코드 128 바코드 이미지 생성

다음 코드는 코드 128 바코드를 생성합니다.

// Create a barcode from the input string and specify encoding type as Code 128
var myBarcode = BarcodeWriter.CreateBarcode("12345ABC12345", BarcodeWriterEncoding.Code128);

// Save the barcode image as a JPEG file
myBarcode.SaveAsJpeg("myBarcode.Jpeg");

이 코드는 입력 문자열로부터 바코드를 생성하고 "myBarcode.Jpeg"라는 이름의 JPEG 이미지 파일로 저장합니다. 사용되는 특정 인코딩은 알파벳과 숫자를 나타낼 수 있는 코드 128입니다.

설명

첫 번째 코드 줄은 myBarcode라는 새로운 변수를 생성합니다. 이 코드는 입력 문자열 "12345ABC12345"에 기반한 바코드를 생성하기 위해 BarcodeWriter.CreateBarcode 메소드를 사용합니다.

두 번째 인수 BarcodeWriterEncoding.Code128는 바코드의 인코딩 유형을 지정합니다. 이 경우, 알파벳 숫자 데이터에 일반적으로 사용되는 코드 128 인코딩을 사용하고 있습니다. 결과적으로 생성된 바코드는 myBarcode 변수에 저장됩니다.

두 번째 라인은 생성된 바코드를 JPEG 이미지 파일로 저장합니다. 저장된 이미지의 파일 이름은 "myBarcode.Jpeg"입니다. 저장된 이미지의 형식은 JPEG (Joint Photographic Experts Group)입니다.

산출

생성된 바코드는 다음과 같습니다:

 C#에서 Code 128 바코드를 생성하는 방법: 그림 1 - 이전 코드에서 출력된 바코드

이 코드는 이제 바코드 판독 장치를 사용하여 읽을 수 있습니다.

이제 바코드를 크기 조정해 봅시다.

바코드 크기 조정하기

다음 코드는 주어진 차원에 따라 바코드의 크기를 조정합니다.

static void Main(string[] args)
{
    // Create a barcode from the input string and specify encoding type as Code 128
    var myBarcode = BarcodeWriter.CreateBarcode("12345ABC12345", BarcodeWriterEncoding.Code128);

    // Resize the barcode image to the specified width and height (in pixels)
    myBarcode.ResizeTo(800, 300);

    // Save the resized barcode image as a JPEG file
    myBarcode.SaveAsJpeg("myBarcode.Jpeg");
}

바코드를 생성하고 저장하는 코드는 동일하게 유지됩니다. 바코드 크기 조정을 위해 추가 라인을 추가하기만 하면 됩니다.

ResizeTo() 메소드는 myBarcode 변수에 저장된 바코드 이미지를 크기 조정합니다. ResizeTo 메소드는 myBarcode 객체에서 호출됩니다. ResizeTo로 전달된 두 인수는 너비와 높이입니다. 이 경우, 폭은 800 픽셀로 설정되고 높이는 300 픽셀로 설정됩니다.

이렇게 하면 최소 폭과 바 모듈 높이를 설정할 수 있습니다. 이후 크기 조정된 후에 생성된 바코드 이미지는 아래와 같은 차원을 갖습니다.

바코드 이미지

 C#에서 Code 128 바코드를 생성하는 방법: 그림 2 - 이전 코드에서 크기 조정된 바코드

이제 바코드에 스타일을 적용해 봅시다.

코드 128 바코드 스타일링

이제 배경색과 바코드 색상을 변경하여 바코드에 스타일을 적용해 봅시다.

static void Main(string[] args)
{
    // Create a barcode from the input string and specify encoding type as Code 128
    var myBarcode = BarcodeWriter.CreateBarcode("12345ABC12345", BarcodeWriterEncoding.Code128);

    // Resize the barcode image to the specified width and height (in pixels)
    myBarcode.ResizeTo(800, 300);

    // Change the background color of the barcode
    myBarcode.ChangeBackgroundColor(IronSoftware.Drawing.Color.Cornsilk);

    // Change the barcode color
    myBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Brown);

    // Save the styled barcode image as a JPEG file
    myBarcode.SaveAsJpeg("myBarcode.Jpeg");
}

바코드를 생성하고 저장하는 코드는 동일합니다. 저는 배경색과 바코드 색상을 변경하기 위한 두 가지 추가 줄을 추가했습니다. 설명은 다음과 같습니다:

  • ChangeBackgroundColor: 메소드 ChangeBackgroundColormyBarcode 객체에서 호출됩니다. 이 메서드는 바코드 이미지의 배경색을 변경합니다. ChangeBackgroundColor로 전달된 인수는 원하는 배경색을 지정하는 IronSoftware.Drawing.Color.Cornsilk입니다. 이 경우 배경색은 연한 황색인 Cornsilk로 설정됩니다.

  • ChangeBarCodeColor: 메소드 ChangeBarCodeColormyBarcode 객체에서 호출됩니다. 이 메서드는 바코드 막대의 색상을 변경합니다. ChangeBarCodeColor로 전달된 인수는 원하는 바코드 색을 지정하는 IronSoftware.Drawing.Color.Brown입니다. 이 경우, 바코드 색상은 갈색으로 설정됩니다.

산출

우리의 스타일이 적용된 바코드는 다음과 같습니다:

 C#에서 Code 128 바코드를 생성하는 방법: 그림 3 - 이전 코드에서 출력된 스타일 바코드

Code 128 바코드 읽기

우리는 Code 128 바코드를 생성하는 방법을 배웠습니다. 이제 바코드를 읽는 코드를 작성해 보겠습니다:

static void Main(string[] args)
{
    // Read barcodes from the specified image file
    var resultFromBarcode = BarcodeReader.Read("myBarcode.Jpeg");

    // Loop through each barcode value read from the image
    foreach (var barcodeValue in resultFromBarcode)
    {
        // Print each barcode value to the console
        Console.WriteLine(barcodeValue);
    }
}

위의 코드는 'myBarcode.Jpeg' 이미지 파일에서 바코드를 읽고, 그 값을 콘솔에 출력합니다. BarcodeReader 클래스는 이미지에서 바코드 데이터를 디코딩하는 역할을 담당합니다. 코드의 설명은 다음과 같습니다:

코드 설명

  • 첫 번째 줄은 resultFromBarcode라는 변수를 생성합니다. 이 코드는 'myBarcode.Jpeg'이라는 이미지 파일에서 바코드를 읽기 위해 BarcodeReader.Read 메소드를 호출합니다. 이 작업의 결과는 resultFromBarcode 변수에 저장됩니다.

  • 두 번째 줄은 resultFromBarcode 컬렉션의 각 바코드 값을 순회하는 루프를 시작합니다. foreach 루프는 각 바코드 값을 하나씩 처리할 수 있게 합니다.

  • 루프 내부에서는 이 줄이 각각의 바코드 값을 콘솔에 출력합니다. barcodeValue는 이미지에서 읽은 바코드의 내용을 의미합니다.

바코드 값은 아래와 같이 콘솔에 출력됩니다.

산출

 C#에서 Code 128 바코드를 생성하는 방법: 그림 4 - 읽은 바코드의 콘솔 출력

코드 128 인코딩 세그먼트 분석

앞서 언급했듯이 코드 128은 A, B, C의 세 가지 문자 세트를 사용하며, 데이터를 효율적으로 인코딩하기 위해 이들을 전환하며 사용합니다. IronBarcode는 주어진 입력 문자열에 사용되는 문자 세트를 분석하기 위해 Code128GS1Parser.GetEncodingInfo 메소드를 제공합니다.

// Analyze Code 128 encoding segments
var result = Code128GS1Parser.GetEncodingInfo("ABC123456DEF");
Console.WriteLine(result.CharacterSetSummary);  // "B → C → B"
Console.WriteLine(result.TotalSymbols);          // 14
Console.WriteLine(result.IsGS1);                 // false
foreach (var segment in result.Segments)
{
    Console.WriteLine($"{segment.CharacterSetName}: \"{segment.Data}\" ({segment.SymbolCount} symbols)");
}
// Output:
// Code B: "ABC" (3 symbols)
// Code C: "123456" (3 symbols)
// Code B: "DEF" (3 symbols)

이 메소드는 인코딩 세그먼트의 구성을 포함하는 Code128EncodingInfo 객체를 반환합니다. 이 예시에서 인코더는 문자에 대해서는 코드 B를 사용하고, 숫자 쌍에 대해서는 코드 C(숫자를 가장 간결하게 인코딩하는 방식)를 사용한 다음, 나머지 문자에 대해서는 다시 코드 B를 사용합니다. TotalSymbols 카운트는 시작 기호, 데이터 기호, 코드 전환, 검사 숫자 및 종료 기호를 포함합니다.

결론

결론적으로, 이 기사는 IronBarcode 라이브러리를 사용하여 C#에서 Code 128 바코드 생성기를 만드는 방법을 설명했습니다. IronBarcode의 기능을 이용하여 개발자는 생성, 커스터마이즈, 스타일링할 수 있으며, 재고 관리, 제품 라벨링 및 배송과 같은 다양한 응용 프로그램에 사용될 수 있습니다. 이 튜토리얼을 따라 개발자는 C# 프로젝트에 강력한 바코드 기능을 통합할 수 있으며, 바코드 생성 및 디코딩 관련 작업을 더 효율적으로 처리할 수 있습니다. IronBarcode의 유연성과 직관적인 API는 바코드 구현을 포함하는 응용 프로그램을 개발하는 개발자에게 귀중한 도구입니다.

IronBarcode 라이브러리를 사용하여 Code 128 바코드를 생성하는 과정에서, 개발자는 코드 서버 선택 문자를 커스터마이즈할 수 있어 다양한 ASCII 값의 데이터가 최적의 방식으로 인코딩되도록 보장합니다. 렌더링 코드는 선호하는 이미지 형식에 원활하게 적응하며, 개발자는 JPEG 또는 다른 형식으로 바코드를 저장할 수 있는 선택권을 제공합니다. 또한, 종료 문자가 포함되어 생성된 바코드 내에서 인코딩된 정보를 정확하게 종료할 수 있습니다.

IronBarcode는 개발 요구 조건에 맞게 라이브러리의 전체 기능을 활용하기 위한 무료 체험을 제공합니다. 이 접근 방식은 상업용 라이센스를 구입하기 전에 IronBarcode의 기능을 평가할 수 있게 해줍니다.

Curtis Chau
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...
더 읽어보기

관련 기사

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.