IRONBARCODEの使用

.NET QRコードジェネレーター (コード例チュートリアル)

ジョルディ・バルディア
ジョルディ・バルディア
2022年9月14日
更新済み 2024年2月7日
共有:

このチュートリアルでは、IronBarcodeをコアライブラリとして使用し、様々な業界で多くの応用が可能なQRコードを生成します。

IronBarcodeの紹介

追加機能

  • IronBarcode は UPC A/E、EAN 8/13、Code 39/93/128、ITF、MSI、RSS 14/Expanded、Databar、CodaB などのほとんどのバーコードタイプと QR 規格を読み取るおよび書き込むことができます。
  • IronBarcodeは、バーコード画像を自動的に前処理して、読み取り効率と精度を向上させます。
  • IronBarcodeはスキャンやライブビデオフレームを読み取ることができ回転、ノイズ、歪み、傾きを修正します
  • IronBarcodeは、複数のコアとスレッドで利用できます(バッチ処理を実行するサーバーアプリケーションに非常に便利です)。
  • IronBarcodeは、単一および複数ページのドキュメントで1つ以上のバーコードを自動的に検出できます。
  • IronBarcodeは、32ビットおよび64ビットのアーキテクチャをサポートしており、.NET実装(.NET Coreおよび.NET Framework)の両方で使用できます。
  • IronBarcodeは、PCおよびモバイルプラットフォーム上のコンソール、デスクトップ、クラウド、およびWebアプリケーションをサポートします。
  • IronBarcodeは、PDF、JPG、TIFF、GIF、BMP、PNG、およびHTMLを含むさまざまなファイルおよびストリーム形式のQRコード画像を生成できます。

IronBarcodeを使用してQRコードを生成する

この記事の以下のセクションでは、QRコードを簡単に生成する方法を示す例を紹介します。

ステップ 1. 新しいプロジェクトを作成する

Visual Studio を開き、ファイルメニューから新しいプロジェクトを選択します。

表示されるウィンドウでコンソール アプリテンプレートを選択し、[次へ] をクリックします。

.NET QRコードジェネレーター(コード例チュートリアル)、図1: Visual StudioでのQRコード生成用新しいコンソールアプリの作成

Visual StudioでQRコード生成のための新しいコンソールアプリの作成

プロジェクト名 テキストフィールドに、任意のプロジェクト名を入力します (例えば、QR Code Generator)。そして、新しいプロジェクトの場所を 場所 フィールドに指定します。 その後、次へ ボタンをクリックして続行します。

.NET QRコードジェネレーター(コード例チュートリアル)、図2: QRコードを作成するためにVisual Studioで新しいコンソールアプリケーションの名前と場所を選択する。

QRコードを作成するためのVisual Studioでの新しいコンソールアプリケーションの名前と場所を選択する

ドロップダウンメニューからFrameworkを選択し(ここでは.NET 6.0 (Long term support)を使用しています)、作成をクリックします。

.NET QRコードジェネレーター(コード例チュートリアル)、図3: .NET 6.0 Framework下でVisual Studioに新しいコンソールアプリを作成

.NET 6.0 フレームワークで Visual Studio に新しいコンソールアプリを作成する

ステップ2. バーコードライブラリをインストールする

2.1 IronBarcodeの使用

IronBarcodeライブラリは4つの方法でダウンロードおよびインストールできます。

これらの方法は:

  • Visual Studio の NuGet パッケージ マネージャー UI を使用して
  • Visual Studio のパッケージ マネージャー コンソールを使用して、
  • NuGet のウェブサイトから直接ダウンロードするか、
  • IronBarcodeのウェブサイトから直接ダウンロードします。

2.1.1 Visual StudioのパッケージマネージャーUIを使用する

メニューバーから、ツール > NuGet パッケージ マネージャー > ソリューションの NuGet パッケージの管理...を選択して、パッケージ マネージャー UI を開きます。

.NET QR Code Generator(コード例チュートリアル)、図4: Visual StudioのNuGetパッケージマネージャーUIを使用してIronBarcodeライブラリをインストールする。

Visual Studio の NuGet パッケージマネージャー UI を使用して IronBarcode ライブラリをインストールする

または、ソリューションエクスプローラウィンドウからプロジェクト名を右クリックし、コンテキストメニューからNuGet パッケージの管理...を選択することもできます。

Browseタブをクリックし、検索フィールドにBarcodeと入力してください。 関連パッケージのリストからIronBarcodeを選択し(以下の画像に最初の結果として表示されています)、右側のペインでプロジェクトを選択してインストールボタンをクリックします。

.NET QRコードジェネレーター(コード例チュートリアル)、図5: パッケージマネージャー UIでIronBarcodeライブラリを検索する。 検索結果で他のすべてのライブラリの前に表示される可能性が高いです。

パッケージマネージャーUIでIronBarcodeライブラリを検索しています。 検索結果では他のすべてのライブラリの前に表示される可能性が高いです

2.1.2 Visual Studioのパッケージ マネージャー コンソールの使用

ツール > NuGet パッケージ マネージャー > パッケージ マネージャー コンソール に移動します。 以下のコマンドを表示されたコマンドラインパネルに入力し、ENTERキーを押してください:

Install-Package BarCode

上記のコマンドはライブラリを現在のプロジェクトにダウンロードしてインストールします。

2.1.3 ライブラリをNuGetウェブサイトからダウンロードする

ブラウザでNuGet Galleryウェブサイトのバーコードライブラリページを検索します(または、このNuGet BarCodeパッケージリンクをクリックして直接ページにアクセスします)。

右側のメニューからダウンロードパッケージリンクをクリックして、ライブラリをコンピュータに保存してください。 次に、ファイルマネージャーからダウンロードしたライブラリをダブルクリックして、プロジェクトに自動的にインストールしてください。 最後に、プロジェクトを再読み込みすると、準備完了です。

ライブラリをIronBarcodeのウェブサイトからダウンロードする

IronBarcodeのホームページをクリックして、最新の.NETバーコードDLLをダウンロードしてください。 ダウンロードが完了したら、以下の手順に従ってプロジェクトにパッケージを追加してください:

  1. ソリューションエクスプローラーパネルでプロジェクトを右クリックし、追加 > COM参照をクリックします。

    .NET QRコードジェネレーター(コード例チュートリアル)、図6: Visual Studioから直接プロジェクトにIronBarcode DLLを追加します。

    Visual StudioからプロジェクトにIronBarcode DLLを直接追加する

  2. 「ブラウズ」ボタンをクリックして、DLLを抽出した場所に移動してください。 DLLを選択したら、「OK」をクリックしてプロジェクトに追加します。

    .NET QRコードジェネレーター(コード例チュートリアル)、図7: プロジェクトにIronBarcode DLLを新しいCOM参照として挿入する。

    プロジェクトに新しいCOM参照としてIronBarcode DLLを挿入する

手順 3. QRコード画像を生成する

3.1 Windows/コンソールアプリケーションでIronBarcodeを使用する

新しいQRコードを生成するには、CreateQrCode メソッドを QRCodeWriter クラスから呼び出します:

QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png");
QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png");
QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPng("MyQR.png")
$vbLabelText   $csharpLabel

CreateQrCode メソッドは、コード画像にエンコードされるデータという1つの必須パラメーターを受け入れます(String または Stream で指定できます)。 このメソッドは、3つのオプションパラメータも受け付けます:

  1. グラフィックの幅と高さ(デフォルトでは500px × 500px)

  2. エラー訂正レベル。 IronBarcodeは、4つのレベルのエラー訂正を提供します:低、中、高、最高です。デフォルトでは、CreateQrCodeは最高の訂正レベルQRCodeWriter.QrErrorCorrectionLevel.Highestを使用します。

  3. QRシンボルのバージョン番号。 有効なバージョンの一覧についてはこちらのページをご覧ください。 値が0(デフォルト値)の場合、そのメソッドはエンコードするデータに基づいて正しいバージョン番号を使用するように指示します。

    上記の例では、中程度の誤り訂正レベルを使用して500ピクセル×500ピクセルのグラフィックを生成しています。 生成されたQRコードに対するSaveAsPngメソッドの後続呼び出しは、指定されたファイルの場所にPNGファイルとして保存します。

    .NET QRコードジェネレーター(コード例チュートリアル)、図8: 前述のパラメーターを使用してQrCodeWriter.CreateQrCodeを呼び出した結果。

    前述のパラメータを使用してQrCodeWriter.CreateQrCodeを呼び出した結果

    次に、以下のサンプルコードは、CreateQrCodeWithLogo メソッドを使用して、生成されたQRコードに会社のロゴを追加するもので、これはあらゆるビジネスの典型的な使用例です。

var qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500);
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed);
qrWithLogo.SaveAsPng("Logo_QR_Code.png");
var qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500);
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed);
qrWithLogo.SaveAsPng("Logo_QR_Code.png");
Dim qrWithLogo = QRCodeWriter.CreateQrCodeWithLogo("Hello World", "qrlogo.png",500)
qrWithLogo.ChangeBarCodeColor(System.Drawing.Color.DarkRed)
qrWithLogo.SaveAsPng("Logo_QR_Code.png")
$vbLabelText   $csharpLabel

上記の例では、"Hello, World" というString値が、指定されたファイルパスにある画像を埋め込んだ新しいQRコードにエンコードされています。 画像は、QRコードの正方形グリッドに合わせて自動サイズ調整され、QRコードリーダーが純粋なコードデータを読み取ることができるサイズに配置されます。

上記の次のコード行では、QRコードの色をダークレッドに変更するためにChangeBarCodeColorメソッドを使用しています。 ここでは、C# が提供する利用可能な System カラー クラス タイプの1つ(具体的には、System.Drawing.Color.DarkRed)を使用して色付けを行います。 以下のコード行が示すように、HTMLの16進数カラー表記で色を指定することが可能です:

qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"));
qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"));
qrWithLogo.ChangeBarCodeColor(System.Drawing.ColorTranslator.FromHtml("#8B0000"))
$vbLabelText   $csharpLabel

上記のコード例の最後の行では、SaveAsPngメソッドを呼び出してQRコードをPNGファイルとして保存しています。QRコードは、HTMLなどの他のファイル形式でも保存できます。

qrWithLogo.SaveAsHtmlFile("test.html");
qrWithLogo.SaveAsHtmlFile("test.html");
qrWithLogo.SaveAsHtmlFile("test.html")
$vbLabelText   $csharpLabel

QRコードを保存できるファイルタイプの完全なリストについては、このドキュメントページを参照してください。

.NET QRコードジェネレーター(コード例のチュートリアル)、図9:IronBarcodeのQRCodeWriterクラスで利用可能なメソッドを使用して、異なる色、異なるファイル形式、および異なる画像でQRコードを生成します。

IronBarcode の QRCodeWriter クラスで利用可能なメソッドを使用して、異なる色、異なるファイル形式、異なる画像を持つ QR コードを生成する

3.2 WebアプリケーションでIronBarcodeを使用する

このコード行は、IronBarcodeを.NET MVC Webアプリケーション内で使用する方法を示しています。

public IActionResult Index()
{
    QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png");
    return File("Demo.png", "image/png", "Demo.png", true);
}
public IActionResult Index()
{
    QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png");
    return File("Demo.png", "image/png", "Demo.png", true);
}
Public Function Index() As IActionResult
	QRCodeWriter.CreateQrCode("hello world", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium, 0).SaveAsPdf("Demo.png")
	Return File("Demo.png", "image/png", "Demo.png", True)
End Function
$vbLabelText   $csharpLabel

上記の例は、前の例と非常によく似た動作をします。 最初にQRコードが生成され、その後、レスポンスボディにクライアントに返されます。

結論

IronBarcode は、バーコードの読取りおよび書込みのために利用できる最も高速かつ強力なライブラリの一つです。 このシンプルなライブラリは様々なオペレーティングシステムでサポートされており、多くのバーコード形式をサポートし、使いやすいです。

IronBarcodeの使用に関するライセンスおよび法的情報は、ライセンスページでご覧いただけます。 IronBarcodeは、Free Developer Licenseの下で無料で使用できます。 有料の開発者ライセンスには、1年間の無償サポートと製品の更新が含まれています。

ジョルディ・バルディア
ソフトウェアエンジニア
ジョルディは、Iron Softwareでのスキルを活かしていないときには、ゲームプログラミングをしており、Python、C#、C++に最も堪能です。彼は製品テスト、製品開発、研究の責任を共有しており、継続的な製品改善に大きな価値をもたらしています。この多様な経験は彼を常に挑戦的で魅力的に保ち、彼はIron Softwareで働く一番好きな側面の一つだと言っています。ジョルディはフロリダ州マイアミで育ち、フロリダ大学でコンピューターサイエンスと統計学を学びました。
< 以前
C# バーコードスキャナー ステップバイステップチュートリアル
次へ >
C# WindowsアプリケーションでQRコードを生成する方法