C#에서 QR 코드 값을 읽는 방법

This article was translated from English: Does it need improvement?
Translated
View the article in English

QR 코드 이미지에서 즉시 디코드된 텍스트를 추출합니다. 애플리케이션에서 표시, 저장 또는 처리할 준비가 된 원시 문자열 값을 얻습니다.

QR 코드의 값을 읽는 것은 모든 스캔 워크플로의 첫 번째 단계입니다. 결제 단말기는 QR 코드에 내장된 거래 ID가 필요합니다. 창고 시스템은 라벨에 있는 제품 참조가 필요합니다. 티켓 검증자는 이벤트 패스에 인쇄된 예약 코드가 필요합니다. IronQR을 사용하면 이 과정이 매우 간단해집니다. 이미지를 불러와 QrReader에 전달한 다음, 결과에서 디코딩된 문자열을 직접 읽기만 하면 됩니다.

이 가이드는 IronQR 라이브러리를 사용하여 이미지에서 QR 코드 값을 추출하는 방법을 시연합니다. 아직 QR 코드를 생성하지 않은 개발자는 먼저 QR 코드 이미지를 생성하는 방법 가이드를 시작해야 합니다.

빠른 시작: QR 코드 값 읽기

이미지를 불러온 후 QrReader로 스캔하고, 디코딩된 문자열을 추출하십시오.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronQR 설치하기

    PM > Install-Package IronQR
  2. 다음 코드 조각을 복사하여 실행하세요.

    var input = new QrImageInput("qr-code.png");
    var results = new QrReader().Read(input);
    Console.WriteLine(results.First().Value);
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronQR 사용 시작하기

    arrow pointer

이미지에서 QR 코드 값을 읽는 방법은 무엇입니까?

QR 코드에 포함된 값을 추출하려면 이미지를 QrImageInput에 로드하고, 이를 QrReader.Read()로 전달한 다음, 반환된 QrResultValue 속성에 접근하십시오. 이 메서드는 이미지에서 발견된 QR 코드당 하나의 결과를 반환합니다.

입력

아래 QR 코드는 https://ironsoftware.com을 인코딩하며 그 값을 추출하기 위해 스캔될 것입니다.

검사를 위한 입력으로 사용된 https://ironsoftware.com을 인코딩한 QR 코드
:path=/static-assets/qr/content-code-examples/how-to/read-qr-code-value.cs
using IronQr;
using System.Drawing;

// Import image
var inputImage = Image.FromFile("sample.jpg");

// Load the asset into QrImageInput
QrImageInput imageInput = new QrImageInput(inputImage);

// Create a QR Reader object
QrReader reader = new QrReader();

// Read the input and get all embedded QR codes
IEnumerable<QrResult> results = reader.Read(imageInput);

// Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}");
Imports IronQr
Imports System.Drawing
Imports System.Linq

' Import image
Dim inputImage As Image = Image.FromFile("sample.jpg")

' Load the asset into QrImageInput
Dim imageInput As New QrImageInput(inputImage)

' Create a QR Reader object
Dim reader As New QrReader()

' Read the input and get all embedded QR codes
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

' Display the value of the first QR code found
Console.WriteLine($"QR code value is {results.First().Value}")
$vbLabelText   $csharpLabel

Value 속성은 인코딩된 그대로의 원시 디코딩된 문자열(URL, 숫자, 자유 텍스트 또는 기타 데이터)을 반환합니다. Read() 메서드는 QR 코드가 하나만 있는 경우에도 항상 IEnumerable<QrResult>를 반환합니다. 이미지에 여러 개의 QR 코드가 포함된 경우, foreach (var result in results)을 반복하여 각 코드를 처리하십시오. QR 코드가 없는 이미지를 처리하려면 results.Any()로 보호한 후 .First()를 호출하십시오.

산출

해석된 QR 코드 값 https://ironsoftware.com을 보여주는 콘솔 출력

모든 QR 코드 속성을 읽는 방법은 무엇입니까?

QrResult는 세 가지 속성을 제공하며, 이 속성들을 종합하면 스캔된 내용과 이미지 내 위치에 대한 전체적인 정보를 파악할 수 있습니다. 아래의 동일한 입력 QR 코드를 사용하여:

:path=/static-assets/qr/content-code-examples/how-to/read-qr-code-value-properties.cs
using IronQr;
using IronSoftware.Drawing;

AnyBitmap inputImage = AnyBitmap.FromFile("sample.jpg");

QrImageInput imageInput = new QrImageInput(inputImage);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);

QrResult result = results.First();

// Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}");

// Parsed URL — populated when Value is a valid URL, null otherwise
Console.WriteLine($"Url:   {result.Url}");

// Corner coordinates of the QR code in the image [TL, TR, BL, BR]
string[] labels = { "Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right" };
for (int i = 0; i < result.Points.Length; i++)
{
    Console.WriteLine($"{labels[i]}: ({result.Points[i].X}, {result.Points[i].Y})");
}
Imports IronQr
Imports IronSoftware.Drawing

Dim inputImage As AnyBitmap = AnyBitmap.FromFile("sample.jpg")

Dim imageInput As New QrImageInput(inputImage)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

Dim result As QrResult = results.First()

' Decoded text content of the QR code
Console.WriteLine($"Value: {result.Value}")

' Parsed URL — populated when Value is a valid URL, Nothing otherwise
Console.WriteLine($"Url:   {result.Url}")

' Corner coordinates of the QR code in the image [TL, TR, BL, BR]
Dim labels As String() = {"Top-Left", "Top-Right", "Bottom-Left", "Bottom-Right"}
For i As Integer = 0 To result.Points.Length - 1
    Console.WriteLine($"{labels(i)}: ({result.Points(i).X}, {result.Points(i).Y})")
Next i
$vbLabelText   $csharpLabel

산출

콘솔 출력에서 QR 코드로부터 읽어들인 Value, Url, 그리고 Points 속성을 보여줍니다.

QrResult는 어떤 속성을 노출합니까?

QrResult는 스캔이 성공적으로 완료된 후 다음 속성을 노출합니다:

재산 유형 설명
Value string 암호화된 그대로의 원시 디코딩 문자열입니다. URL, 일반 텍스트, 숫자 ID, JSON 또는 기타 데이터를 포함할 수 있습니다. 대부분의 응용 프로그램에서 주요 속성입니다.
Url Uri UriValue가 유효한 절대 URL일 때 생성된 구문 분석된 객체입니다. 링크를 열거나, 도메인을 검증하거나, URL 구성 요소를 추출하는 데 사용하십시오. 값이 URL이 아닌 경우 null를 반환합니다.
Points PointF[] 원본 이미지에서 QR 코드의 위치를 표시하는 네 모서리 좌표(순서: [Top-Left, Top-Right, Bottom-Left, Bottom-Right]). 바운딩 박스를 그리거나, 영역을 잘라내거나, 스캔 영역을 계산하는 데 사용하십시오.

QR 코드 값 읽기의 일반적인 사용 사례는 무엇입니까?

  • 결제 터미널: 고객의 QR 코드에서 거래 URL 또는 참조 ID를 디코딩하여 결제 흐름을 시작합니다.
  • 티켓 검증: 프린트된 또는 화면상의 QR 코드에서 예약 참조를 추출하여 이벤트 입장을 확인합니다.
  • 재고 관리: 상품 일련번호 또는 SKU를 창고 라벨에서 읽어 재고 기록을 업데이트합니다.
  • 문서 검증: 법적 또는 정부 문서에 찍힌 QR 코드에서 기록 ID 또는 해시를 가져옵니다.
  • 사용자 인증: QR 코드의 일회용 토큰을 디코딩하여 이중 인증 로그인 단계를 완료합니다.

추가 QR 코드 읽기 패턴에 대해서는 이미지에서 QR 코드 읽기 가이드와 전체 IronQR 기능 세트를 탐색하십시오.

자주 묻는 질문

C#에서 QR 코드 값을 읽는 방법은 무엇입니까?

C#에서 IronQR을 사용하여 QR 코드 값을 읽을 수 있습니다. QrReader.Read() 메소드는 QrResult.Value를 사용하여 QR 코드에서 디코딩된 문자열을 추출할 수 있도록 합니다.

IronQR에서 QR 코드를 디코딩하는 데 사용되는 메소드는 무엇입니까?

IronQR은 QR 코드를 디코딩하기 위해 QrReader.Read() 메소드를 사용하며, 텍스트 및 URL과 같은 데이터를 추출할 수 있게 합니다.

IronQR이 QR 코드에서 URL을 추출할 수 있습니까?

네, IronQR은 QR 코드를 디코딩한 후 QrResult.Url 속성을 사용하여 QR 코드에서 URL을 파싱할 수 있습니다.

IronQR을 사용하여 QR 코드의 모서리 좌표를 얻을 수 있습니까?

IronQR은 QR 코드의 모서리 좌표를 검색하는 QrResult.Points 속성을 제공하여 정확한 위치 데이터를 제공합니다.

IronQR에서 QrResult.Value는 무엇입니까?

IronQR에서 QrResult.Value는 QrReader.Read()에 의해 처리된 QR 코드의 디코드된 문자열 값을 보유하는 속성입니다.

IronQR이 QR 코드에서 다양한 유형의 데이터를 읽을 수 있습니까?

네, IronQR은 텍스트, URL, 좌표 등 다양한 데이터 유형을 QR 코드에서 읽어 다양한 애플리케이션을 위한 다기능성을 제공합니다.

IronQR에서 QR 코드 디코딩 기능의 정확성은 얼마나 높습니까?

IronQR은 QR 코드의 정확한 디코딩을 제공하도록 설계되어 있으며, 값, URL, 모서리 포인트와 같은 세부 정보를 효율적으로 추출합니다.

IronQR을 정적 및 동적 QR 코드 모두에 사용될 수 있습니까?

네, IronQR은 정적 및 동적 QR 코드를 모두 디코딩할 수 있어 다양한 QR 코드 애플리케이션에 유연한 도구입니다.

IronQR이 호환되는 프로그래밍 언어는 무엇입니까?

IronQR은 C#과 호환되며, 개발자가 .NET 애플리케이션에 QR 코드 읽기 기능을 쉽게 통합할 수 있게 합니다.

IronQR에서 QR 코드 읽기를 테스트할 수 있는 방법이 있습니까?

IronQR에서 샘플 QR 코드와 제공된 예제 코드를 사용하여 QR 코드 읽기를 테스트하여 통합이 프로젝트 요구사항을 충족하는지 확인할 수 있습니다.

커티스 차우
기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 67,270 | 버전: 2026.5 just released
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronQR
샘플을 실행하세요 URL이 QR 코드로 바뀌는 것을 확인해 보세요.