Write QR Codes in C#

텍스트, URL, 숫자

IronQR 텍스트, URL, 숫자 등 다양한 데이터 유형을 QR 코드로 변환할 수 있습니다. 마케팅 및 커뮤니케이션을 위한 QR 코드 링크나 텍스트 생성, 재고 관리를 위한 숫자 코드 생성, 또는 바이너리 데이터나 스트림을 읽기 쉬운 QR 코드로 인코딩하는 등 어떤 작업을 하든 IronQR 필요한 모든 지원을 제공합니다.

또한 API는 사용하기 쉽습니다. QrWriter 클래스는 다양한 유형의 데이터를 입력으로 허용하는 여러 오버로드를 제공하여 복잡성을 줄이고 프로세스를 간소화합니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-1.cs

using IronQr;
using IronSoftware.Drawing;

string text = "Hello, World!";
string url = "https://ironsoftware.com/csharp/qr/";
string alphanumeric = "WATERSKU-12356";

// Create QR code
QrCode textQr = QrWriter.Write(text);
// Save QR code as a bitmap
AnyBitmap textQrImage = textQr.Save();
// Save QR code as file
textQrImage.SaveAs("textQr.png");

QrCode urlQr = QrWriter.Write(url);
AnyBitmap urlQrImage = urlQr.Save();
urlQrImage.SaveAs("urlQr.png");

QrCode alphanumericQr = QrWriter.Write(alphanumeric);
AnyBitmap alphanumericQrImage = alphanumericQr.Save();
alphanumericQrImage.SaveAs("alphanumericQr.png");

바이너리 및 스트림

마찬가지로, 앞서 언급한 것과 동일한 Write 메소드를 사용하여 이진 데이터와 스트림을 QR 코드로 변환할 수 있습니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-2.cs

using IronQr;
using IronSoftware.Drawing;
using System.Text;

byte[] bytes = Encoding.UTF8.GetBytes("https://ironsoftware.com/csharp/qr/");

// Create QR code
QrCode bytesQr = QrWriter.Write(bytes);

// Save QR code as a bitmap
AnyBitmap qrImage = bytesQr.Save();

// Save QR code bitmap to file
qrImage.SaveAs("bytesQr.png");

수업 프로그램 { 정적 void Main() { // QR 코드 작성기 인스턴스를 생성합니다. writer = QrWriter.CreateQrCode();

    // 이진 데이터 예시

byte[] data = { 0x01, 0x02, 0x03, 0x04 };

    // QR 코드에 바이너리 데이터를 기록합니다.

writer.Write(data) .SaveAs("binary-qr.png");

    // 메모리 스트림을 사용한 예시
    (MemoryStream stream = new MemoryStream(data))를 사용합니다.

{ writer.Write(stream) .SaveAs("stream-qr.png"); } } }

Write 메서드에는 바이트 배열과 스트림 모두를 입력으로 받는 오버로드가 있습니다. 스트림의 경우, 바이트 배열에서 MemoryStream를 생성하고 이를 QR 코드로 변환할 수 있습니다. 이는 사용자가 데이터 청크를 보다 세밀하게 제어해야 할 때 유용하며, 스트림은 메모리 효율성이 더 높을 수 있습니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-3.cs

using IronQr;
using IronSoftware.Drawing;
using System.IO;
using System.Text;

MemoryStream stream = new MemoryStream(Encoding.UTF8.GetBytes("https://ironsoftware.com/csharp/qr/"));

// Create QR code
QrCode streamQr = QrWriter.Write(stream);

// Save QR code as a bitmap
AnyBitmap streamQrImage = streamQr.Save();

// Save QR code bitmap as file
streamQrImage.SaveAs("streamQr.png");

이미지로 저장

SaveAs 메소드는 제공된 파일 경로를 기반으로 파일 형식을 자동으로 감지합니다. 이 예에서, 저는 .png로 끝나는 파일 경로를 지정했습니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-4.cs

using IronQr;
using IronSoftware.Drawing;

// Create a QR code object
QrCode qr = QrWriter.Write("hello world");

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.SaveAs("qr.png");

시스템.드로잉.이미지

이미지를 Microsoft의 System.Drawing.Images 객체로 변환하면 QR 코드를 파일 경로에 저장할 수 있는 Bitmap 클래스를 사용할 수 있습니다. 이 예제에서는 Save 메서드가 QR 코드를 PNG 파일로 qrBitmap.png 경로에 저장합니다.

System.Drawing.Common는 Windows 플랫폼에서만 지원됩니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-5.cs

using IronQr;
using System.Drawing;

// Create a QR code object
QrCode qr = QrWriter.Write("hello world");

// Save QR code as a bitmap
Bitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.Save("qrBitmap.png");

Iron Software.드로잉

System.Drawing.Common의 크로스 플랫폼 호환성이 부족하여 개발자는 크로스 플랫폼 애플리케이션을 유지 관리할 때 문제가 발생할 수 있습니다. IronQR은 System.Drawing.Common과 IronSoftware.Drawing 둘 다 사용할 수 있습니다.

IronQR은 IronSoftware.Drawing의 AnyBitmap 클래스를 사용하며, 이는 다음과 같은 방식으로 암시적으로 캐스팅되는 범용 호환 Bitmap 클래스입니다.

• System.Drawing.Bitmap
• System.Drawing.Image
• SkiaSharp.SKBitmap
• SixLabors.ImageSharp
• Microsoft.Maui.Graphics.Platform.PlatformImage

이 강력한 오픈 소스 라이브러리와 함께, IronQR은 .NET 8, .NET 7, .NET 6, .NET 5, .NET Core, .NET Standard, .NET Framework 4.6.2+와의 크로스 플랫폼 지원 및 호환성을 달성합니다. 라이브러리에 대한 자세한 내용은 IronSoftware.Drawing 웹사이트를 참조하십시오.

PDF에 스탬프 찍기

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-6.cs

using IronQr;

// Create a QR code object
QrCode qr = QrWriter.Write("hello world");

string filepath = "example.pdf";
int x = 100;
int y = 150;
int page = 1;

// Stamp QR code to (100, 150) of the pdf on page 1
qr.StampToExistingPdfPage(filepath, x, y, page);

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-7.cs

using IronQr;
using System.Collections.Generic;

// Create a QR code object
QrCode qr = QrWriter.Write("hello world");

string filepath = "example.pdf";
int x = 100;
int y = 150;
List<int> pages = new List<int>();
pages.Add(1);
pages.Add(2);
pages.Add(3);
pages.Add(4);

// Stamp QR code to (100, 150) of the pdf on pages 1-4
qr.StampToExistingPdfPages(filepath, x, y, pages);

부호화

IronQR QR 코드 생성 및 읽기 모두에 대해 다양한 유형의 QR 코드를 지원합니다. 지원되는 유형은 다음과 같습니다.

• QRCode: 이는 오늘날 일반적으로 사용되는 표준 QR 코드입니다. 이 장치는 최대 7,089개의 숫자 또는 4,296개의 영숫자 문자를 저장할 수 있습니다.
• MicroQRCode: 표준 QR 코드의 작은 버전으로 최대 35개의 숫자 문자를 저장할 수 있습니다.
• RMQRCode: Rectangular Micro QR Code는 QR 코드의 작은 버전으로, 종횡비의 유연성을 제공합니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-8.cs

using IronQr;
using IronSoftware.Drawing;

QrOptions options = new QrOptions
{
    // Change encoding to micro QR code
    Encoding = IronQr.Enum.QrEncoding.MicroQRCode,
};

// Create QR code
QrCode qr = QrWriter.Write("1234", options);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.SaveAs("qrImage.png");

오류 수정

IronQR 표준 QR 오류 수정 기능을 사용하여 열악한 환경에서도 모든 QR 코드가 오류에 강하고 신뢰할 수 있도록 보장합니다. 또한 IronQR 더욱 세밀한 조정을 위해 오류 수정 수준을 완벽하게 제어할 수 있도록 해줍니다.

QrErrorCorrectionLevel이 제공한 오류 수정의 네 가지 수준이 있습니다:

• Highest: 30% 오류 수정
• High: 25% 오류 수정
• Medium: 15% 오류 수정
• Low: 7% 오류 수정

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-9.cs

using IronQr;
using IronSoftware.Drawing;

QrOptions options = new QrOptions
{
    // Change error correction level to medium
    ErrorCorrectionLevel = QrErrorCorrectionLevel.Medium,
};

// Create QR code
QrCode qr = QrWriter.Write("1234", options);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.SaveAs("qrImage.png");

오류 수정 기능이 높을수록 QR 코드를 읽을 때 오류 허용 범위가 넓어져 오류 수정 기능이 낮은 QR 코드에 비해 낮은 해상도에서도 스캔될 가능성이 높아집니다. 사용 사례에 따라 테스트를 진행할 수 있습니다.

QR 코드 버전

QR 코드 버전을 조정하여 더 많은 데이터를 저장할 수 있습니다. 높은 버전은 재고 관리나 물류에 적합하고, 낮은 버전은 짧은 URL과 같은 작은 데이터에 적합합니다. Version 속성을 QrOptions 객체에 변경하고 이를 Write 메서드에 전달하여 필요에 따라 QR 코드를 생성할 수 있습니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-10.cs

using IronQr;
using IronSoftware.Drawing;

QrOptions options = new QrOptions
{
    // Change QR code version to 40
    Version = 40,
};

// Create QR code
QrCode qr = QrWriter.Write("1234", options);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.SaveAs("qrImage.png");

출력 결과에서 볼 수 있듯이, QR 코드 버전 40은 버전 5에 비해 훨씬 복잡하고 밀도가 높습니다.

낮은 버전의 경우 더욱 정밀한 스캔이 필요하며, 고해상도 스캐너 없이는 스캔하기 어려울 수 있습니다. 하지만 고해상도 버전일수록 저해상도 카메라로도 스캔하기가 더 쉽습니다. 용량에 따른 QR 버전 선택에 대한 자세한 안내는 QR 버전 목록을 참조하십시오.

문자 인코딩

이 옵션은 QR 코드 인코딩 방식을 결정합니다. 예시에서는 기본 문자 인코딩인 'ISO-8859-1'을 'UTF-32'로 변경했습니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-11.cs

using IronQr;
using IronSoftware.Drawing;

QrOptions options = new QrOptions
{
    // Change character encoding to UTF-32
    CharacterEncoding = "UTF-32"
};

// Create QR code
QrCode qr = QrWriter.Write("1234", options);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.SaveAs("qrImage.png");

크기 조정

QR 코드를 조정하려면 Dimensions 속성을 QrStyleOptions 객체에 설정한 다음 이를 Save 메서드에 전달할 수 있습니다. 기본적으로 QR 코드는 300픽셀 크기로 저장됩니다. 이 예시에서는 QR 코드의 크기를 300px 대신 600px로 저장했습니다.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-12.cs

using IronQr;
using IronSoftware.Drawing;

QrStyleOptions styleOptions = new QrStyleOptions()
{
    // Change the dimensions to 600px
    Dimensions = 600,
};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qrURLResized.png");

여백 및 테두리

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-13.cs

using IronQr;
using IronSoftware.Drawing;

QrStyleOptions styleOptions = new QrStyleOptions()
{
    // Change margins to 20px
    Margins = 20
};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qrURLMarginMultiple.png");

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-14.cs

using IronQr;
using IronSoftware.Drawing;

QrStyleOptions styleOptions = new QrStyleOptions()
{
    // Change margins
    MarginBottom = 30,
    MarginTop = 100,
    MarginRight = 40,
    MarginLeft = 20,
};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qrURLMarginMultiple.png");

색상 변경

QrStyleOptions 클래스를 사용하여 QR 코드와 배경에 색상을 추가할 수 있습니다. 색상을 맞춤 설정하면 QR 코드가 더욱 독특하고 눈길을 사로잡게 됩니다. 색상은 Color과 BackgroundColor 속성을 사용하여 변경할 수 있습니다. 할당할 수 있는 색상 목록은 IronSoftware.Drawing을 가져오는 것을 잊지 마세요.

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-15.cs

using IronQr;
using IronSoftware.Drawing;

// Load new logo image
AnyBitmap logo = AnyBitmap.FromFile("sample.png");

// Add new logo to QR code style options
QrStyleOptions styleOptions = new QrStyleOptions()
{
    Logo = new QrLogo(logo, 50, 50, 10),
};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qrURLColored.png");

로고 추가

:path=/static-assets/qr/content-code-examples/tutorials/csharp-qr-writing-15.cs

using IronQr;
using IronSoftware.Drawing;

// Load new logo image
AnyBitmap logo = AnyBitmap.FromFile("sample.png");

// Add new logo to QR code style options
QrStyleOptions styleOptions = new QrStyleOptions()
{
    Logo = new QrLogo(logo, 50, 50, 10),
};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qrURLColored.png");

using IronQRCode;
using IronSoftware.Drawing;

수업 프로그램
{
    정적 void Main()
    {
        `QrStyleOptions` styleOptions = new `QrStyleOptions`
{
            `Logo` = new `QrLogo`
    {
                `Bitmap` = `AnyBitmap.FromBitmap`("path/to/logo.png"),
                `Width` = 50,
                `Height` = 50,
                `CornerRadius` = 5
            }
        };

        `QrCode` qr = `QrWriter.CreateQrCode`()
                               .Write("Customized Logo Example");

        qr.SaveAs("example-customized-logo-qr.png", styleOptions);
    }
}

using IronQRCode;
using IronSoftware.Drawing;

수업 프로그램
{
    정적 void Main()
    {
        `QrStyleOptions` styleOptions = new `QrStyleOptions`
{
            `Logo` = new `QrLogo`
    {
                `Bitmap` = `AnyBitmap.FromBitmap`("path/to/logo.png"),
                `Width` = 50,
                `Height` = 50,
                `CornerRadius` = 5
            }
        };

        `QrCode` qr = `QrWriter.CreateQrCode`()
                               .Write("Customized Logo Example");

        qr.SaveAs("example-customized-logo-qr.png", styleOptions);
    }
}

체크섬

QR 코드는 때때로 손상될 수 있지만, IronQR 에는 내장된 체크섬 및 데이터 수정 기능이 있어 QR 코드가 계속 작동하도록 유지합니다. 이 시스템은 리드-솔로몬 오류 수정 알고리즘을 사용하여 QR 코드가 오류에 강인하게 작동하도록 보장합니다.

자세한 오류 메시지

IronQR 사용자가 문제를 신속하게 파악할 수 있도록 자세한 오류 메시지를 제공합니다. 이 메시지에는 특정 예외 목록이 포함되어 있어 디버깅 및 문제 해결이 더욱 간편해집니다. 아래는 라이브러리에서 사용되는 IronQrException 목록입니다.

• IronQrEncodingException: IronQrException의 하위 클래스이며, QR 코드 작성에 문제가 있을 때 발생합니다. 예를 들어, 사용자가 빈 문자열로 QR 코드를 생성하려고 시도할 경우 이 오류가 나타납니다.

• IronQrFileException: IronQrException의 하위 클래스이며, 파일 관련 문제가 발생할 때 발생합니다.

• IronQrPdfPasswordExcception: IronQrException의 하위 클래스이며, 사용자가 스탬프하려는 PDF가 비밀번호로 보호되어 있고, 비밀번호가 제공되지 않았거나 올바르지 않을 때 발생합니다. 또한 예시에서처럼 PDF 파일을 열 수 없는 경우와 같은 다른 PDF 관련 오류도 다룹니다.