C#에서 문자열로 바코드 생성하기: IronBarcode 사용한 완벽 튜토리얼

.NET 프로젝트에서 IronBarcode를 어떻게 설치합니까?

.NET CLI 또는 Visual Studio 내부의 NuGet 패키지 관리자를 사용하여 IronBarcode를 설치하는 데 몇 초가 걸립니다.

옵션 1 -- .NET CLI (.NET 10 추천):

dotnet add package Barcode

dotnet add package Barcode

옵션 2 -- Visual Studio의 NuGet 패키지 관리자 콘솔:

Install-Package BarCode

또한 NuGet 패키지 관리자 GUI에서 "IronBarCode"를 검색하여 공식 패키지를 설치할 수 있습니다. 이 라이브러리는 .NET Framework 4.6.2+ 및 .NET 5부터 .NET 10까지를 타겟으로 하여 최신 .NET 워크로드와의 호환성을 보장합니다.

설치 후, 바코드를 생성하거나 읽는 각 파일의 맨 위에 단일 using 지시어를 추가하세요:

using IronBarCode;

using IronBarCode;

그 지시어는 BarcodeWriter, BarcodeReader, BarcodeEncoding 및 이 가이드에서 다루는 다른 공개 유형을 노출합니다.

문자열로부터 간단한 바코드를 C#에서 어떻게 생성합니까?

BarcodeWriter.CreateBarcode 메소드는 바코드 생성의 진입점입니다. 인코딩하려는 문자열과 BarcodeEncoding 값을 함께 전달하면 저장하거나 추가 조작이 가능한 GeneratedBarcode 객체를 반환받습니다.

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

using IronBarCode;

// Generate a Code 128 barcode from a product SKU string
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128);
barcode.SaveAsPng("product_barcode.png");

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

using IronBarCode;

// Specify width and height in pixels for the barcode image
string productCode = "SKU-78432-A";
var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128, 400, 120);
barcode.SaveAsPng("product_barcode_sized.png");

IronBarcode는 어떤 바코드 형식을 지원하나요?

IronBarcode는 다양한 사용 사례를 위해 20개 이상의 바코드 유형을 지원합니다. 적합한 형식을 선택하면 애플리케이션에 대해 적절한 스캔과 충분한 데이터 용량을 보장할 수 있습니다.

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

using IronBarCode;

string url = "https://ironsoftware.com/csharp/barcode/";
string numericId = "0123456789012";

// QR Code -- best for URLs, text data, and mobile scanning
BarcodeWriter.CreateBarcode(url, BarcodeEncoding.QRCode)
    .SaveAsPng("qrcode.png");

// UPC-A -- required for retail point-of-sale systems (12 digits)
BarcodeWriter.CreateBarcode(numericId, BarcodeEncoding.UPCA)
    .SaveAsPng("upc_barcode.png");

// PDF417 -- suited for documents that need higher data capacity
BarcodeWriter.CreateBarcode("Extended product details here", BarcodeEncoding.PDF417)
    .SaveAsJpeg("pdf417_barcode.jpeg");

C#에서 바코드 이미지를 어떻게 사용자 정의하고 스타일링하나요?

기본적인 바코드 생성 외에도, IronBarcode는 외부 이미지 처리 라이브러리 없이 색상 조정, 주석 추가, 바코드 이미지 크기 조정을 위한 유창한 스타일링 API를 제공합니다.

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

using IronBarCode;
using IronSoftware.Drawing;

string orderNumber = "ORD-2024-00542";
var styledBarcode = BarcodeWriter.CreateBarcode(orderNumber, BarcodeEncoding.Code128);

// Adjust colors to match brand identity
styledBarcode.ChangeBarCodeColor(Color.DarkBlue);
styledBarcode.ChangeBackgroundColor(Color.White);

// Add readable text annotations above and below the bars
styledBarcode.AddAnnotationTextAboveBarcode("Order Number", new Font("Arial", 12), Color.Black, 5);
styledBarcode.AddBarcodeValueTextBelowBarcode(new Font("Arial", 10), Color.Gray, 5);

// Resize to fit a thermal label at 400 x 150 pixels
styledBarcode.ResizeTo(400, 150);
styledBarcode.SaveAsPng("styled_order_barcode.png");

데이터베이스 데이터에서 여러 바코드를 어떻게 생성하나요?

실제 애플리케이션은 종종 항목 컬렉션 -- 제품 카탈로그, 재고 보충 작업, 주문 처리 워크플로 -- 에 대한 바코드 생성을 필요로 합니다. IronBarcode는 추가 설정 없이 배치 처리를 처리합니다.

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

using IronBarCode;

// Data sourced from a database query result
List<string> productIds =
[
    "PROD-001-X",
    "PROD-002-Y",
    "PROD-003-Z",
    "PROD-004-W"
];

// Generate one barcode image per product ID
foreach (string productId in productIds)
{
    var barcode = BarcodeWriter.CreateBarcode(productId, BarcodeEncoding.Code128, 300, 100);
    barcode.SaveAsPng($"barcodes/{productId}.png");
}

다양한 파일 형식으로 바코드를 저장하고 내보내는 방법

GeneratedBarcode는 업무 애플리케이션에서 사용하는 가장 일반적인 이미지 형식을 포괄하는 다양한 저장 메소드를 제공합니다:

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(Image형식.Png).ToArray();

using IronBarCode;

string value = "EXPORT-TEST-001";
var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);

// Save to disk in multiple formats
barcode.SaveAsPng("barcode.png");       // Lossless -- best for print
barcode.SaveAsJpeg("barcode.jpg");      // Compressed -- smaller file size
barcode.SaveAsGif("barcode.gif");       // Compatible with legacy systems
barcode.SaveAsTiff("barcode.tiff");     // Multi-page archival format
barcode.SaveAsBmp("barcode.bmp");       // Uncompressed bitmap

// Export as a byte array for in-memory operations (API responses, database storage)
byte[] pngBytes = barcode.ToStream(Image형식.Png).ToArray();

올바른 형식을 선택하는 것은 다운스트림 소비자에 따라 다릅니다. PNG는 인쇄용 라벨 및 문서에 적합합니다. JPEG는 저장 크기가 중요한 응용 프로그램에 적합합니다. 바코드를 PDF 문서에 직접 삽입할 경우, IronBarcode는 IronPDF와 통합되어 바코드 이미지를 프로그래밍적으로 삽입하거나 삽입합니다.

ToStream 오버로드는 디스크에 쓰는 것이 바람직하지 않은 웹 API 및 클라우드 기능에서 특히 가치가 있습니다. 바이트 배열은 데이터베이스 BLOB 열에 저장되거나 클라우드 스토리지에 업로드되거나 파일 시스템의 중간 파일 없이 HTTP 응답으로 직접 스트리밍될 수 있습니다.

인코딩 전에 문자열 데이터를 어떻게 검증하나요?

모든 문자열이 모든 바코드 형식에 유효한 것은 아닙니다. UPC-A는 정확히 12개의 숫자 자리수를 요구하며, EAN-13은 13개를 요구하며, 일부 1D 형식은 제한된 ASCII 하위 집합 외의 문자를 거부합니다. 잘못된 데이터를 CreateBarcode로 전달하면 IronBarCodeEncodingException가 발생합니다. 호출을 try/catch 블록에 감싸고 입력을 선 검증하면 생산에서 예기치 않은 예외를 방지할 수 있습니다:

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

using IronBarCode;

bool TryCreateBarcode(string value, BarcodeEncoding encoding, string outputPath)
{
    if (string.IsNullOrWhiteSpace(value))
    {
        Console.WriteLine("Value must not be empty.");
        return false;
    }

    try
    {
        var barcode = BarcodeWriter.CreateBarcode(value, encoding);
        barcode.SaveAsPng(outputPath);
        return true;
    }
    catch (IronBarCodeEncodingException ex)
    {
        Console.WriteLine($"Encoding failed: {ex.Message}");
        return false;
    }
}

// Usage
TryCreateBarcode("SKU-001", BarcodeEncoding.Code128, "output.png");   // succeeds
TryCreateBarcode("NOT-NUMERIC", BarcodeEncoding.UPCA, "output.png");  // encoding exception

문자열 값으로부터 바코드를 어떻게 읽어들이나요?

많은 시스템에서 바코드를 생성하는 것은 전체 워크플로의 절반일 뿐입니다. 바코드 읽기 API는 BarcodeReader.Read를 사용하여 이미지를 원래 문자열로 디코딩합니다.

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"형식 detected: {result.BarcodeType}");
}

using IronBarCode;

// Read all barcodes from an image file
var results = BarcodeReader.Read("product_barcode.png");

foreach (var result in results)
{
    // Output the decoded string value
    Console.WriteLine($"Decoded value: {result.Value}");
    Console.WriteLine($"형식 detected: {result.BarcodeType}");
}

이것은 다음과 같은 왕복 바코드 워크플로를 구성하기 쉽게 합니다. 제품 기록에서 바코드를 생성하고, 디스크나 라벨 프린터 대기열에 저장한 후, 나중에 물리적 라벨을 스캔하여 값을 다시 디코딩하여 기록을 조회합니다. PDF 파일 및 실시간 카메라 피드에서 바코드를 읽는 경우 IronBarcode는 같은 단순한 API로 전용 방법을 제공합니다.

IronBarcode를 ASP.NET Core 웹 API에서 사용하는 방법

IronBarcode는 ASP.NET Core 컨트롤러 및 최소 API 핸들러에서 작동합니다. 가장 일반적인 패턴은 바코드 이미지를 파일 결과나 브라우저에 렌더링하기 위한 base64-인코딩된 데이터 URI로 반환하는 것입니다.

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(Image형식.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Minimal API endpoint -- returns a barcode PNG for the given value
app.MapGet("/barcode/{value}", (string value) =>
{
    var barcode = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128, 400, 120);
    byte[] imageBytes = barcode.ToStream(Image형식.Png).ToArray();
    return Results.File(imageBytes, "image/png");
});

app.Run();

엔드포인트는 URL 경로에 전달된 값에 대해 요청 시 바코드를 생성합니다. 상용 배포에서는 동일한 바코드 값에 대한 반복 요청이 이미지를 다시 생성하지 않도록 캐싱을 추가하세요. 전체 ASP.NET 바코드 생성 튜토리얼을 참조하여 종속성 주입과 응답 캐싱을 포함한 자세한 워크스루를 보세요.

다음 단계는 무엇입니까?

C#에서 IronBarcode로 문자열 데이터로부터 바코드를 생성하는 것은 간단합니다. 유연한 API는 바코드 인코딩의 복잡성을 처리하면서 맞춤화 및 일괄 처리에 대한 유연성을 제공합니다. 대상이 간단한 Code 128 바코드인 경우나 모바일 애플리케이션을 위한 QR 코드인 경우에도 IronBarcode는 .NET 응용 프로그램을 위한 신뢰할 수 있는 바코드 기능을 제공합니다.

더 나아가려면:

• IronBarcode 다운로드하고 이 가이드의 코드 샘플을 로컬로 실행하세요
• 라이센스 구매하여 상용 배포를 위한 라이센스를 구매하세요 -- 라이센스는 무료 체험 기간부터 시작합니다
• 문서 보기 API 참조, 고급 구성 및 플랫폼별 주석을 위한
• 코드 예제 탐색 QR 코드 생성, 바코드 스캔, PDF 통합 등을 포함하는
• ASP.NET 바코드 통합 -- MVC 뷰 및 Razor Pages에서 바코드를 렌더링하는 전체 가이드
• 바코드 스캐너 통합 -- C#에서 이미지, PDF 및 USB 스캐너에서 바코드를 읽습니다

지금 바로 IronBarcode으로 시작하세요.

무료로 시작하세요