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

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

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

1.NuGetパッケージマネージャからIronBarcodeをインストールしてください。 2.バーコードを作成するには、BarcodeWriter.CreateBarcode()を使用します。 3.SetMargins(100)で、すべての辺に100pxの均一な余白を適用します。 4.または、SetMargins(top, right, bottom, left)で個々のマージンを設定します。 5.SaveAsPng()または他のフォーマットメソッドを使用して結果を保存します。

```cs {.cs .numberLines startFrom="1"} :title=Quickstart // 簡単な例 - 50pxのマージン var barcode = BarCodeWriter.CreateBarcode("Hello World", BarcodeWriterEncoding.QRCode)； barcode.SetMargins(50)； barcode.SaveAsPng("barcode-with-margin.png")；

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

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

IronBarcodeはこれらのマージンを設定する簡単な方法を提供し、バーコードが常に正確にスキャンされるようにします。これらのマージン設定はすべての[バーコード画像生成](https://ironsoftware.com/csharp/barcode/how-to/create-barcode-images/)機能とシームレスに動作します。 このガイドでは、IronBarcodeが提供するバーコードマージンの設定方法について説明します。

<h3>IronBarcodeを使い始める</h3>

		
今日あなたのプロジェクトでIronBarcodeを無料トライアルで使用開始。
	

	

		
最初のステップ：
		

			

		
        
		
無料で始める
	



<hr>

<div class="hsg-featured-snippet">
    <h2>C#でバーコードに余白を追加する方法</h2>
    <ol>
        <li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://www.nuget.org/packages/BarCode/">バーコードに余白を追加するには、IronBarcode C# ライブラリをダウンロードしてください。</a></li>
        <li><code>CreateBarcode</code>を使用して文字列値を持つバーコードを生成する </li>
        <li><code>SetMargins</code>を使用して、4辺すべてに均一な静かな領域を適用します。</li> 
        <li><code>SetMargins</code>を使用してバーコードの各辺に余白を適用します。</li>
        <li><code>SaveAsPng</code>でバーコードを画像として保存する</li>
    </ol>
</div>

<hr>

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

<!-- TODO: ここに画像を追加 -->.
<!-- !![余白を全面に設定する実装を示す図](/static-assets/images/TODO/set-margins-on-all-sides-code_illustration.webp) -->。
<!コードの概念を示す図またはスクリーンショット -->。

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

この例では、BarCodeを作成し、マージンを100ピクセルに設定し、`SaveAsPng`を使用して結果を保存します。 マージン設定は、他の[BarCodeスタイリングオプション](https://ironsoftware.com/csharp/barcode/how-to/customize-barcode-style/)と組み合わせて、包括的なカスタマイズが可能です。

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

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

。

出力に示されているように、バーコードの周囲には100ピクセルの均一な正方形のマージンが適用されています。 これにより、さまざまな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");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

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

.

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

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

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

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

一般的なマージンサイズのガイドラインは？ 業界標準では通常、リニアバーコードの場合は最も幅の狭いバーの幅（X寸法）の10倍、QRのような2Dコードの場合は少なくとも4モジュールの幅の最小クワイエットゾーンを推奨しています。 しかし、一般的に、余白を大きく取ることで、特に厳しい条件下でのスキャンの信頼性が向上します。 実用的な実装については、以下のガイドラインを考慮してください： - **QRコード**：最低4つのモジュール幅が必要です。 - **コード128**：最小10倍クワイエットゾーン（ナローバー幅の10倍） - **PDF417**：すべての側面で最小2モジュールの幅 - **データマトリックス**：すべての側面で最小1モジュールの幅 これらの標準は、さまざまなスキャン機器や環境条件との互換性を保証します。 疑問がある場合は、スキャニングの成功率を最大化するために、余白を大きくとってください。 IronBarcodeのマージン設定は、[エラー訂正設定](https://ironsoftware.com/csharp/barcode/how-to/error-correction/)のような他の機能とシームレスに統合され、実世界のアプリケーションで確実に動作する堅牢なバーコードソリューションを作成します。