C#에서 바코드 작업을 위한 널 체크 처리 방법

널 및 빈 바코드 결과를 처리하는 방법?

BarcodeReader.Read()는 BarcodeResults를 반환하며, 이는 BarcodeResult 객체의 컬렉션입니다. 보호해야 하는 두 가지 실패 모드가 있습니다: 컬렉션 자체가 null인 경우(입력이 유효한 이미지로 인식되지 않음)와 컬렉션이 비어 있는 경우(유효한 이미지이나 바코드가 발견되지 않음). 조건을 확인하지 않고 .First(), .Value에 접근하거나 반복을 시도하면 런타임 예외가 발생합니다.

표준 보호 패턴은 처리 루프에 진입하기 전에 두 조건을 확인합니다:

using IronBarCode;

BarcodeResults results = BarcodeReader.Read("shipping-label.png");

// Null check: image may not be recognized
// Empty check: image recognized but no barcodes found
if (results is null || results.Count == 0)
{
    // Log, return a default, or throw a domain-specific exception
    Console.WriteLine("No barcodes found in the input image.");
    return;
}

foreach (BarcodeResult result in results)
{
    // Guard individual result properties
    if (string.IsNullOrWhiteSpace(result.Value))
    {
        Console.WriteLine($"Empty value detected for {result.BarcodeType}");
        continue;
    }

    Console.WriteLine($"Type: {result.BarcodeType}, Value: {result.Value}");
}

using IronBarCode;

BarcodeResults results = BarcodeReader.Read("shipping-label.png");

// Null check: image may not be recognized
// Empty check: image recognized but no barcodes found
if (results is null || results.Count == 0)
{
    // Log, return a default, or throw a domain-specific exception
    Console.WriteLine("No barcodes found in the input image.");
    return;
}

foreach (BarcodeResult result in results)
{
    // Guard individual result properties
    if (string.IsNullOrWhiteSpace(result.Value))
    {
        Console.WriteLine($"Empty value detected for {result.BarcodeType}");
        continue;
    }

    Console.WriteLine($"Type: {result.BarcodeType}, Value: {result.Value}");
}

각 BarcodeResult는 문자열 속성으로 .Value 및 .Text를 노출하며, 둘 다 디코딩된 바코드 내용을 반환합니다. 정상 운영에서는 이러한 값이 채워지지만, 매우 손상된 바코드, 부분 스캔 또는 저신뢰도 감지 같은 엣지 케이스가 존재하여 값이 비어 있거나 공백일 수 있습니다. 개별 결과에 대한 string.IsNullOrWhiteSpace() 확인으로 데이터가 전파되기 전에 이러한 경우를 잡을 수 있습니다.

.Confidence 속성(0.0과 1.0 사이의 double)은 추가 품질 신호를 제공합니다. 프로덕션 시스템의 경우, null 체크와 신뢰도 임계값을 결합할 수 있습니다:

double minimumConfidence = 0.7;

var validResults = results
    .Where(r => !string.IsNullOrWhiteSpace(r.Value) && r.Confidence >= minimumConfidence)
    .ToList();

if (validResults.Count == 0)
{
    Console.WriteLine("No barcodes met the confidence threshold.");
    return;
}

double minimumConfidence = 0.7;

var validResults = results
    .Where(r => !string.IsNullOrWhiteSpace(r.Value) && r.Confidence >= minimumConfidence)
    .ToList();

if (validResults.Count == 0)
{
    Console.WriteLine("No barcodes met the confidence threshold.");
    return;
}

BarcodeReaderOptions 클래스는 또한 스캔 레벨에서 필터링하는 MinimumConfidence 속성을 제공합니다. 옵션 객체에서 이 설정은 고수율 배치 스캔 시나리오에 더 깔끔합니다.

바코드 쓰기에 널 안전 패턴을 적용하는 방법?

BarcodeWriter.CreateBarcode()는 문자열 값과 BarcodeWriterEncoding 또는 BarcodeEncoding 열거형을 허용합니다. 널 또는 빈 문자열을 전달하면 예외가 발생합니다. 또한, 형식 별 제약 조건이 적용됩니다 — EAN-8은 정확히 7–8개의 숫자 자릿수가 필요하며, UPC-A는 11–12개의 자릿수가 필요하고, Code 128은 최대 문자 제한이 있습니다. 이 제약 조건을 위반하면 예외가 발생합니다.

방어 패턴은 CreateBarcode()를 호출하기 전에 입력을 검증합니다:

using IronBarCode;

string inputValue = GetValueFromUserOrDatabase(); // Could be null

// Guard: null, empty, or whitespace
if (string.IsNullOrWhiteSpace(inputValue))
{
    Console.WriteLine("Cannot generate barcode: input value is null or empty.");
    return;
}

// Guard: format-specific constraints (example: EAN-8 requires 7-8 digits)
BarcodeWriterEncoding encoding = BarcodeWriterEncoding.EAN8;
if (encoding == BarcodeWriterEncoding.EAN8 && !System.Text.RegularExpressions.Regex.IsMatch(inputValue, @"^\d{7,8}$"))
{
    Console.WriteLine("EAN-8 requires exactly 7 or 8 numeric digits.");
    return;
}

GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(inputValue, encoding);
barcode.SaveAsPng("output-barcode.png");

using IronBarCode;

string inputValue = GetValueFromUserOrDatabase(); // Could be null

// Guard: null, empty, or whitespace
if (string.IsNullOrWhiteSpace(inputValue))
{
    Console.WriteLine("Cannot generate barcode: input value is null or empty.");
    return;
}

// Guard: format-specific constraints (example: EAN-8 requires 7-8 digits)
BarcodeWriterEncoding encoding = BarcodeWriterEncoding.EAN8;
if (encoding == BarcodeWriterEncoding.EAN8 && !System.Text.RegularExpressions.Regex.IsMatch(inputValue, @"^\d{7,8}$"))
{
    Console.WriteLine("EAN-8 requires exactly 7 or 8 numeric digits.");
    return;
}

GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(inputValue, encoding);
barcode.SaveAsPng("output-barcode.png");

IronBarcode의 쓰기 API는 자체 내부 검증을 수행합니다 — 체크섬을 확인하고, 길이 제한을 검증하며, 선택한 인코딩에 대해 유효하지 않은 문자를 거부합니다. 이러한 검사들은 설명이 포함된 메시지와 함께 System.Exception 예외를 발생시킵니다. 위에 언급된 보호 구문은 라이브러리에 도달하기 전에 문제를 잡아내며, 이를 통해 오류 메시징 및 흐름을 제어할 수 있습니다. 지원되는 인코딩 및 제약 조건의 전체 목록은 바코드 생성 방법 및 데이터에서 바코드 생성 가이드를 참조하세요.

후속 처리 전 결과를 검증하는 방법?

바코드 데이터가 다른 시스템으로 피드될 때 — 데이터베이스 기록, API 호출, 라벨 프린터 — 우리는 결과 수, 개별 값의 무결성, 바코드 유형을 전달 전에 체크하는 검증 게이트가 필요합니다. 이것은 널 체크 로직을 단일 재사용 가능 메서드로 통합합니다.

using IronBarCode;
using System.Collections.Generic;
using System.Linq;

public static class BarcodeValidator
{
    public static List<BarcodeResult> GetValidResults(
        string imagePath,
        BarcodeEncoding? expectedType = null,
        double minimumConfidence = 0.7)
    {
        BarcodeResults results = BarcodeReader.Read(imagePath);

        if (results is null || results.Count == 0)
            return new List<BarcodeResult>();

        return results
            .Where(r => !string.IsNullOrWhiteSpace(r.Value))
            .Where(r => r.Confidence >= minimumConfidence)
            .Where(r => expectedType == null || r.BarcodeType == expectedType)
            .ToList();
    }
}

// Usage
var validated = BarcodeValidator.GetValidResults(
    "warehouse-scan.png",
    expectedType: BarcodeEncoding.Code128,
    minimumConfidence: 0.85);

if (validated.Count == 0)
{
    // No valid results — log and skip downstream processing
    return;
}

// Safe to pass to downstream systems
foreach (var barcode in validated)
{
    SendToInventorySystem(barcode.Value, barcode.BarcodeType.ToString());
}

using IronBarCode;
using System.Collections.Generic;
using System.Linq;

public static class BarcodeValidator
{
    public static List<BarcodeResult> GetValidResults(
        string imagePath,
        BarcodeEncoding? expectedType = null,
        double minimumConfidence = 0.7)
    {
        BarcodeResults results = BarcodeReader.Read(imagePath);

        if (results is null || results.Count == 0)
            return new List<BarcodeResult>();

        return results
            .Where(r => !string.IsNullOrWhiteSpace(r.Value))
            .Where(r => r.Confidence >= minimumConfidence)
            .Where(r => expectedType == null || r.BarcodeType == expectedType)
            .ToList();
    }
}

// Usage
var validated = BarcodeValidator.GetValidResults(
    "warehouse-scan.png",
    expectedType: BarcodeEncoding.Code128,
    minimumConfidence: 0.85);

if (validated.Count == 0)
{
    // No valid results — log and skip downstream processing
    return;
}

// Safe to pass to downstream systems
foreach (var barcode in validated)
{
    SendToInventorySystem(barcode.Value, barcode.BarcodeType.ToString());
}

검증자 메서드는 null이 아닌 빈 목록을 반환합니다 — 이는 호출자가 반환 값을 널 체크할 필요성을 없애며, 이는 표준 방어 패턴입니다. 옵션 expectedType 매개변수는 다운스트림 시스템이 예상하는 바코드 형식만을 받도록 보장하여, 하나의 이미지에서 QR 코드와 코드 128을 모두 얻었을 때의 불일치를 방지합니다.

다수의 파일에 걸친 배치 읽기의 경우, 동일한 패턴을 파일별로 적용하고 결과를 집계합니다. BarcodeReaderOptions 클래스는 스캔 레벨에서 필터링하는 ExpectBarcodeTypes를 지원하여, 검증 전에 노이즈를 줄입니다.

다음 단계

IronBarcode 작업에서 null 검사는 두 가지 패턴으로 요약됩니다: 속성을 읽기 전에 BarcodeResults 컬렉션(null + 빈 값)을 보호하고, 쓰기 전에 입력 문자열을 검증합니다. 위의 재사용 가능한 유효성 검사기는 두 가지 문제를 중앙에 배치합니다.

더 깊은 내용을 위해 스캔 설정에 관한 바코드 읽기 튜토리얼과 모든 BarcodeResult 속성에 대한 출력 데이터 형식 가이드, 그리고 완전한 유형 표면에 대한 API 참조를 탐색해 보세요.

무료 30일 체험판 시작하기를 통해 이러한 패턴을 실제 스캔 데이터와 비교해 테스트해 보세요. 준비가 되면 라이선스 옵션 보기를 누르면 $499부터 시작합니다.