C#で BarCode に余白を追加する方法

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

IronBarcodeはC#でバーコードにマージン(クワイエットゾーン)を追加する2つのメソッドを提供します:SetMargins()を使用して1つのパラメータで全辺に均一なマージンを設定するか、オーバーロードされたSetMargins()を使用して4つのパラメータで上辺、右辺、下辺、左辺に個別のマージンを設定します。

バーコードが信頼できるものであるためには、バーやスペースだけでは不十分です。 クワイエットゾーン"またはマージンとして知られる、コードを囲む空白の領域も同様に重要です。 このクワイエットゾーンにより、スキャナはバーコードとラベル上のテキストやグラフィックなどの他の要素を区別することができます。

十分な余白がないと、スキャンに失敗したり、誤ったデータを返したりする可能性があります。 これは、スキャンに失敗すると多大な時間と金銭的損失が発生する物流や小売において特に重要です。 IronBarcodeでサポートされているバーコードフォーマットには、最適なスキャニングパフォーマンスを保証するための特定のマージン要件があります。

IronBarcodeはこれらのマージンを設定する簡単な方法を提供し、バーコードが常に正確にスキャンされるようにします。これらのマージン設定はすべてのバーコード画像生成機能とシームレスに動作します。 このガイドでは、IronBarcodeが提供するバーコードマージンの設定方法について説明します。


クイックスタート: C#でBarCodeに余白を追加する

IronBarcodeのSetMargins()メソッドを使用すると、1行のコードで任意のバーコードの周囲にクワイエットゾーンを追加できます。 バーコードを作成し、余白を適用し、画像ファイルを保存してください。

Nuget Icon今すぐ NuGet で PDF を作成してみましょう:

  1. NuGet パッケージ マネージャーを使用して IronBarcode をインストールします

    PM > Install-Package BarCode

  2. このコード スニペットをコピーして実行します。

    IronBarCode.BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode, 250, 250).SetMargins(50).SaveAsPng("barcode-with-margin.png");
  3. 実際の環境でテストするためにデプロイする

    今すぐ無料トライアルでプロジェクトに IronBarcode を使い始めましょう
    arrow pointer

すべての辺に均一な余白を設定するにはどうすればよいですか?

. 。 <!コードの概念を示す図またはスクリーンショット -->。

適切なクワイエットゾーンを確保する最も簡単な方法は、SetMarginsメソッドを使用することです。 このメソッドは、バーコードの 4 辺すべてに空白の境界として追加するピクセル数を表す単一の整数を受け入れます。 このアプローチは、QRコードや、一貫した間隔を必要とするその他の2次元バーコード形式を作成する場合に特に役立ちます。

この例では、BarCodeを作成し、マージンを100ピクセルに設定し、SaveAsPngを使用して結果を保存します。 マージン設定は、他のBarCodeスタイリングオプションと組み合わせて、包括的なカスタマイズが可能です。

:path=/static-assets/barcode/content-code-examples/how-to/setting-margin-barcode.cs
using IronBarCode;

// Create a QR code
GeneratedBarcode qrcode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode",
    BarcodeWriterEncoding.QRCode
);

// Set consistent margins around the QR code
qrcode.SetMargins(100);
// Save the QR code as a PNG image
qrcode.SaveAsPng("QRCode.png");
Imports IronBarCode

' Create a QR code
Dim qrcode As GeneratedBarcode = BarcodeWriter.CreateBarcode( _
    "https://ironsoftware.com/csharp/barcode", _
    BarcodeWriterEncoding.QRCode _
)

' Set consistent margins around the QR code
qrcode.SetMargins(100)
' Save the QR code as a PNG image
qrcode.SaveAsPng("QRCode.png")
$vbLabelText   $csharpLabel

均一な余白のある出力はどのように見えますか?

バーコード要素の周囲に適切な間隔を示す白い余白が四方に適用されたQRコード

出力に示されているように、バーコードの周囲には100ピクセルの均一な正方形のマージンが適用されています。 これにより、さまざまなBarCode読み取りシナリオにわたって信頼性の高いスキャンを保証する最適なクワイエットゾーンが生まれます。

なぜ均一な余白がスキャンに重要なのでしょうか

均一な余白は、小売環境で一般的に使用される全方位スキャナにとって重要である、すべての面で一貫したクワイエットゾーンを保証します。 一貫したクワイエットゾーンは、部分的な読み取りや、隣接するグラフィックやテキストをバーコードデータの一部と誤認することを防ぎます。 これは、不完全なバーコードや画像補正のシナリオを扱うときに特に重要になります。

Professional アプリケーション用に BarCode を生成する場合、適切な余白は、バーコード システム全体の フォールト トレランスに貢献します。 余白はバッファゾーンとして機能し、スキャナがバーコードの始まりと終わりを明確に識別できるようにします。

左右で異なる余白を設定するにはどうすればよいですか?

IronBarcodeは均一なマージンを適用するだけでなく、SetMarginsメソッドのオーバーロードを使用して各辺のマージンを指定することができます。 このオーバーロードは、それぞれ上、右、下、左の余白を表す 4 つの整数パラメータを受け入れます。 この柔軟性は、正確なレイアウト制御が不可欠なPDFとしてバーコードを作成する場合に特に価値があります。

次の例では、特定の余白を定義します。上と下に 10 ピクセル、左と右に 5 ピクセルです。 この非対称マージン構成は、既存のドキュメントレイアウトにBarCodeを統合する場合や、カスタムバーコードスタイルで作業する場合に便利です。

:path=/static-assets/barcode/content-code-examples/how-to/setting-multiple-margin.cs
using IronBarCode;

// Create a QR code
GeneratedBarcode qrcode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode",
    BarcodeWriterEncoding.QRCode
);

// Set the QR code dimensions 10 pixel on top and bottom, 5 pixels on left and right
qrcode.SetMargins(10, 5, 10, 5);


// Save the QR code as a PNG file
qrcode.SaveAsPng("QRCodeValue.png");
Imports IronBarCode

' Create a QR code
Dim qrcode As GeneratedBarcode = BarcodeWriter.CreateBarcode( _
    "https://ironsoftware.com/csharp/barcode", _
    BarcodeWriterEncoding.QRCode _
)

' Set the QR code dimensions 10 pixel on top and bottom, 5 pixels on left and right
qrcode.SetMargins(10, 5, 10, 5)

' Save the QR code as a PNG file
qrcode.SaveAsPng("QRCodeValue.png")
$vbLabelText   $csharpLabel

余白のある出力はどのように見えますか?

ポジショニングマーカーとデータマトリックス周りのマージン間隔を示すQRコードの例.

どのような場合に左右で異なる余白を使うべきですか?

特定のレイアウト制約がある既存のラベルデザインに BarCode を統合する場合は、異なるマージンが便利です。 例えば、スキャナーのアプローチアングルのために左右の余白を広く取りながら、高さの制限に合わせて上下の余白を最小限にする必要があるかもしれません。 このテクニックは、しばしば他のBarCode生成機能と組み合わせて、プロ級のバーコードソリューションを作成します。

個々のマージンコントロールは、次のような場合に特に重要になります:

  • 間隔が狭いドキュメントへの BarCode 埋め込み
  • 業界固有の規格に準拠したラベルの作成
  • 特定のスキャナタイプや向きに合わせたバーコード配置の最適化
  • スペースが限られている既存の印刷レイアウトとの統合

一般的なマージンサイズのガイドラインは?

業界標準では通常、リニアバーコードの場合は最も幅の狭いバーの幅(X寸法)の10倍、QRのような2Dコードの場合は少なくとも4モジュールの幅の最小クワイエットゾーンを推奨しています。 しかし、一般的に、余白を大きく取ることで、特に厳しい条件下でのスキャンの信頼性が向上します。

実用的な実装については、以下のガイドラインを考慮してください:

  • QRコード: 最小4モジュール分の幅が必要です。
  • Code 128: 最低10倍のクワイエットゾーン(ナローバーの幅の10倍)
  • PDF417:最低2モジュール分の幅が必要です。
  • データマトリックス: 全面最小1モジュール幅

これらの標準は、さまざまなスキャン機器や環境条件との互換性を保証します。 疑問がある場合は、スキャニングの成功率を最大化するために、余白を大きくとってください。

IronBarcodeのマージン設定は、エラー訂正設定のような他の機能とシームレスに統合され、実世界のアプリケーションで確実に動作する堅牢なバーコードソリューションを作成します。

よくある質問

C#でバーコードに余白を付けるには?

IronBarcodeはバーコードに余白を追加する2つのメソッドを提供します。すべての辺に均一な余白を設定するには、1つのパラメータを持つSetMargins()を使用するか、または4つのパラメータを持つオーバーロードされたSetMargins()を使用して、上辺、右辺、下辺、左辺の個別の余白を設定します。

バーコード用語におけるクワイエットゾーンとは何ですか?

クワイエットゾーンとは、バーコードを囲む余白のことで、マージンとも呼ばれます。IronBarcodeではSetMargins()メソッドを使用してこのクワイエットゾーンを設定することができ、スキャナがラベル上の他の要素とバーコードを区別できるようにします。

BarCodeのすべての辺に均一な余白を設定するにはどうすればよいですか?

すべての辺に均一な余白を設定するには、ピクセルを表す1つの整数パラメータでSetMargins()メソッドを使用します。例えば、IronBarcodeを使用する場合、barcode.SetMargins(50)は4辺に50ピクセルの余白を追加します。

バーコードの各辺に異なるマージンサイズを設定できますか?

はい、IronBarcodeはオーバーロードされたSetMargins()メソッドを提供し、4つのパラメータ(top, right, bottom, left)を受け取り、バーコードの各辺のマージンを設定します。

バーコードスキャンにおいて余白が重要なのはなぜですか?

余白やクワイエットゾーンは、信頼性の高い BarCode スキャンに不可欠です。十分な余白がないと、スキャンに失敗したり、誤ったデータを返したりすることがあります。IronBarcodeは簡単なマージン設定方法を提供することで、バーコードが正確にスキャンされるようにサポートします。

BarCodeに余白を追加しないとどうなりますか?

適切なマージンがないと、BarCodeスキャンは失敗したり、不正なデータを返したりする可能性があり、特に物流や小売環境では問題となります。IronBarcodeのSetMargins()メソッドは、バーコードの周囲に適切なクワイエットゾーンを確保することで、このような問題を防ぐのに役立ちます。

余白のある BarCode を画像として保存する方法を教えてください。

SetMargins()でマージンを設定した後、IronBarcodeのSaveAsPng()メソッド、またはSaveAsJpeg()やSaveAsBmp()のような他のフォーマットメソッドを使用してバーコードを保存することができます。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 2,070,733 | バージョン: 2026.2 リリース