ASP.NET MVC에서 QR 코드를 생성하는 방법

Iron Barcode 설치

시작하려면 Visual Studio에서 패키지 관리자 콘솔을 열고 다음 명령을 실행합니다:

Install-Package IronBarCode

이 명령은 Iron Barcode 라이브러리를 설치하고 프로젝트에 필요한 참조를 추가합니다.

이제 QR 코드를 생성하기 위한 코드를 작성해 보겠습니다.

QRCodeModel 생성

모델 폴더 내에 모델 클래스를 생성하고 다음 코드를 작성합니다:

using System.ComponentModel.DataAnnotations;

public class QRCodeModel
{
    [Display(Name = "Enter QR Code Text")]
    public string QRCodeText { get; set; }
}

using System.ComponentModel.DataAnnotations;

public class QRCodeModel
{
    [Display(Name = "Enter QR Code Text")]
    public string QRCodeText { get; set; }
}

QR 코드 컨트롤러 생성

ASP.NET MVC 프로젝트에서 QrCodeController라는 새로운 컨트롤러를 생성합니다. 이를 위해 프로젝트의 컨트롤러 폴더를 마우스 오른쪽 버튼으로 클릭하고 "추가"를 선택한 다음, "컨트롤러"를 선택합니다. 사용 가능한 옵션 중 "MVC Controller - Empty"를 선택합니다.

QrCodeController에 다음 코드를 작성하세요:

using Microsoft.AspNetCore.Mvc;
using IronBarCode;
using System.IO;

public class QrCodeController : Controller
{
    private readonly IWebHostEnvironment _environment;

    public QrCodeController(IWebHostEnvironment environment)
    {
        _environment = environment;
    }

    public IActionResult CreateQRCode()
    {
        return View();
    }

    [HttpPost]
    public IActionResult CreateQRCode(QRCodeModel generateQRCode)
    {
        try
        {
            // Creating QR Code
            GeneratedBarcode barcode = QRCodeWriter.CreateQrCode(generateQRCode.QRCodeText);
            string path = Path.Combine(_environment.WebRootPath, "GeneratedQRCode");

            if (!Directory.Exists(path))
            {
                Directory.CreateDirectory(path);
            }

            string filePath = Path.Combine(path, "qrcode.png");
            barcode.SaveAsPng(filePath);

            string fileName = Path.GetFileName(filePath);
            string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}/GeneratedQRCode/{fileName}";

            ViewBag.QrCodeUri = imageUrl;
        }
        catch (Exception ex)
        {
            // Handle exceptions
            // Log the exception details here for troubleshooting and debugging.
            throw;
        }

        return View();
    }
}

using Microsoft.AspNetCore.Mvc;
using IronBarCode;
using System.IO;

public class QrCodeController : Controller
{
    private readonly IWebHostEnvironment _environment;

    public QrCodeController(IWebHostEnvironment environment)
    {
        _environment = environment;
    }

    public IActionResult CreateQRCode()
    {
        return View();
    }

    [HttpPost]
    public IActionResult CreateQRCode(QRCodeModel generateQRCode)
    {
        try
        {
            // Creating QR Code
            GeneratedBarcode barcode = QRCodeWriter.CreateQrCode(generateQRCode.QRCodeText);
            string path = Path.Combine(_environment.WebRootPath, "GeneratedQRCode");

            if (!Directory.Exists(path))
            {
                Directory.CreateDirectory(path);
            }

            string filePath = Path.Combine(path, "qrcode.png");
            barcode.SaveAsPng(filePath);

            string fileName = Path.GetFileName(filePath);
            string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}/GeneratedQRCode/{fileName}";

            ViewBag.QrCodeUri = imageUrl;
        }
        catch (Exception ex)
        {
            // Handle exceptions
            // Log the exception details here for troubleshooting and debugging.
            throw;
        }

        return View();
    }
}

이 코드는 QR 코드를 생성할 수 있는 컨트롤러를 설정합니다. CreateQRCode 액션이 호출되면, QR 코드의 텍스트를 받아 QR 코드 이미지를 생성하고 이를 저장하며, 뷰에서 표시할 이미지의 URL을 제공합니다. 자세한 내용은 다음과 같습니다:

• 컨트롤러는 웹 호스팅 환경에 접근하기 위해 IWebHostEnvironment 매개변수를 받는 생성자를 가집니다.
• CreateQRCode 액션은 뷰를 반환합니다.
• CreateQRCode 액션은 [HttpPost] 속성을 가지고 있으며, QR 코드 텍스트를 포함하는 QRCodeModel 매개변수를 받습니다.
• 액션 내부에서 Iron Barcode 라이브러리의 QRCodeWriter 클래스를 사용하여 QR 코드를 생성합니다.
• 생성된 QR 코드는 웹 루트 경로에 있는 GeneratedQRCode라는 폴더에 PNG 이미지 파일로 저장됩니다.
• GeneratedQRCode 폴더가 없으면 생성됩니다.
• QR 코드 이미지 저장 파일 경로와 URL이 생성됩니다.
• QR 코드 이미지의 URL은 뷰에서 사용하기 위해 ViewBag.QrCodeUri 속성에 저장됩니다.
• 프로세스 중 발생하는 모든 예외는 포착되어 기록됩니다.

CreateQRCode 뷰 추가

이제 새로운 뷰를 추가하려면, QrCodeController 클래스의 CreateQRCode 액션 메서드를 마우스 오른쪽 버튼으로 클릭하세요. "Add View"를 선택한 후, "Razor View"를 선택하고 "Add" 버튼을 클릭합니다.

아래와 같이 새 창이 나타납니다.

뷰 이름을 작성하고, 템플릿 'Create'를 선택하며, 새로 생성한 모델 클래스 QRCodeModel를 선택합니다. Add 버튼을 클릭합니다. 뷰가 생성됩니다. 아래 코드를 사용하여 뷰를 대체합니다.

@model QRCodeModel

@{
    ViewData["Title"] = "CreateQRCode";
}

<h1>Create QRCode in ASP.NET MVC</h1>

<hr />
<div class="row">
    <div class="col-md-4">
        <form asp-action="CreateQRCode">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="QRCodeText" class="control-label"></label>
                <input asp-for="QRCodeText" class="form-control" />
                <span asp-validation-for="QRCodeText" class="text-danger"></span>
            </div>
            <div class="form-group">
                <input type="submit" value="Create" class="btn btn-primary" />
            </div>
            <div class="form-group">
                @if (ViewBag.QrCodeUri != null)
                {
                    <img src="@ViewBag.QrCodeUri" class="img-thumbnail" alt="Generated QR Code" />
                }
            </div>
        </form>
    </div>
</div>

@section Scripts {
    @{ await Html.RenderPartialAsync("_ValidationScriptsPartial"); }
}

이제 Program.cs 클래스로 이동하여 기본 컨트롤러 경로를 변경합니다.

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=QrCode}/{action=CreateQRCode}/{id?}"
);

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=QrCode}/{action=CreateQRCode}/{id?}"
);

이렇게 하면 기본 경로가 HomeController에서 우리 QrCodeController로 변경됩니다.

이제 프로젝트를 컴파일하고 실행합니다.

산출

텍스트 상자에 텍스트를 입력하고 생성 버튼을 클릭합니다. 아래와 같이 QR 코드가 생성되어 화면에 표시됩니다.

이제, 주석 텍스트, QR 코드 값 추가 및 QR 코드 색상 변경을 통해 바코드에 시각 스타일을 추가합니다.

QR 코드에 시각 스타일 추가

CreateQRCode 액션 메서드 내부에 다음 코드를 추가하세요.

barcode.AddAnnotationTextAboveBarcode("QR Code Generated by Iron PDF");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.ChangeBackgroundColor(System.Drawing.Color.White);
barcode.ChangeBarCodeColor(System.Drawing.Color.MediumVioletRed);

barcode.AddAnnotationTextAboveBarcode("QR Code Generated by Iron PDF");
barcode.AddBarcodeValueTextBelowBarcode();
barcode.ChangeBackgroundColor(System.Drawing.Color.White);
barcode.ChangeBarCodeColor(System.Drawing.Color.MediumVioletRed);

이제 프로젝트를 실행하여 QR 코드를 생성합니다.