如何在 C# 中將 BarCode 匯出為 HTML；

IronBarcode 使 C# 開發人員能夠以三種格式將生成的條碼輸出為 HTML：資料 URL 用於內嵌，HTML 標籤用於直接注入，或完整的 HTML 檔案用於獨立使用-提供多功能的整合選項，無需外部依賴。

快速入門：用一行程式碼將條碼匯出為 HTML 標籤

使用一行流暢的程式碼，產生條碼並將其直接匯出為完整格式的 HTML 影像標籤。 快速上手，無需管理外部影像檔案或資產依賴性。

如何將 BarCode 匯出為資料 URL？ 在將條碼匯出為資料 URL 之前，請先瞭解何謂資料 URL。 **Data URL**（也稱為 **Data URI**）是直接在 URL 字串中嵌入資料的統一資源識別碼。 這允許在網頁中內嵌顯示，就像資料是外部資源一樣。 資料 URL 支援任何格式：文字、影像、音訊、視訊和二進位資料。 在 HTML 中的圖片標籤內使用取得的資料 URL 作為 `src` 屬性。 以下是如何將 `GeneratedBarcode` 轉換為 **Data URL**： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsDataUrl.cs ``` 使用 `BarcodeWriter` 類中的 `CreateBarcode()` 方法創建條碼，並將條碼值和編碼作為參數。 透過將 `ToDataUrl()` 方法附加到 `GeneratedBarcode` 來取得 **Data URL**。 此方法適用於 IronBarcode 中所有[支援的條碼格式](https://ironsoftware.com/csharp/barcode/get-started/supported-barcode-formats/)。

Why Does Using Data URL Matter for Web Applications? 資料 URL 可減少 HTTP 請求並提昇頁面載入效能，為網路應用程式提供顯著的優勢。 當您將 BarCode 嵌入為資料 URL 時，影像資料會成為 HTML 文件本身的一部分，省去了單獨的影像檔案請求。 這樣做的好處 - **單頁應用程式 (SPA)** 需要最少的伺服器往返次數 - **電子郵件範本**，外部圖片可能會被阻擋 - **離線應用程式**在沒有網路連線的情況下運作 - **動態條碼產生**，其中建立實體檔案的效率很低 關於生產部署，請參閱我們的 [ 部署到 Azure](https://ironsoftware.com/csharp/barcode/get-started/azure/) 或 [AWS 部署](https://ironsoftware.com/csharp/barcode/get-started/aws/)指南，以瞭解基於雲的 BarCode 生成。

何時應該使用資料 URL 而非圖片檔案？ 當條碼較小（32KB 以下）且需要立即內嵌渲染時，請使用資料 URL。 選擇儲存於伺服器或 CDN 的傳統影像檔案時： ```csharp // Example: Choosing between Data URL and file export based on size GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("LARGE-DATA-STRING-HERE", BarcodeEncoding.PDF417); // Check estimated size before choosing export method if (barcode.BinaryStream.Length < 32768) // 32KB threshold { // Use Data URL for smaller barcodes string dataUrl = barcode.ToDataUrl(); // Embed directly in HTML } else { // Save as file for larger barcodes barcode.SaveAsImage("large-barcode.png"); // Reference as external resource } ```

資料 URL 的大小限制為何？ 儘管現代瀏覽器在技術上支援數 MB 的資料 URL，但仍存在實際限制： - **Internet Explorer 8**：限制為 32KB - **現代瀏覽器**：支援 2-4MB，但效能會降低 - **行動瀏覽器**：由於記憶體的限制，限制更為嚴格 - **電子郵件用戶端**：限制資料 URL 為 8-64KB 將資料 URL BarCode 保持在 32KB 以下，以獲得最佳效能。 對於較大的 BarCode 或多個條碼的產生，請使用我們的 [export as stream](https://ironsoftware.com/csharp/barcode/how-to/export-barcode-as-stream/) 功能來進行有效的記憶體管理。

如何將 BarCode 匯出為 HTML 標籤？ 使用 `ToHtmlTag()` 方法將 `GeneratedBarcode` 匯出為 HTML。 此方法會將 `GeneratedBarcode` 物件渲染為完整形成的 HTML 標籤，以便直接注入 HTML 中，而無需 JavaScript、CSS 或圖片相依性。 以下程式碼示範 HTML 標籤匯出： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsHtmlTag.cs ``` 將 `ToHtmlTag()` 方法附加到 `GeneratedBarcode` 以取得產生條碼的 HTML 標籤。 將此 HTML 標籤直接嵌入到較大的 HTML 檔案中。如需進階樣式選項，請參閱我們的 [ 自訂 BarCode 樣式](https://ironsoftware.com/csharp/barcode/how-to/customize-barcode-style/)指南。

為什麼 HTML 標籤匯出比外部圖片參考更好？ HTML 標籤匯出提供了比外部圖片參考更重要的優勢： 1.**沒有破損的圖片連結**：條碼資料直接嵌入在標籤中 2.**更快的呈現**：不需要額外的 HTTP 請求 3.**簡化部署**：無需獨立的映像資產管理 4.**更好的安全性**：不會暴露檔案路徑或伺服器結構 5.**動態產生**：實時條碼建立的完美選擇 以下是一個實用的網路應用程式整合範例： ```csharp // Generate multiple barcodes for a product catalog var products = new[] { "PROD-001", "PROD-002", "PROD-003" }; var htmlBuilder = new StringBuilder(); foreach (var productCode in products) { var barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128) .ResizeTo(200, 50) .SetMargins(10); htmlBuilder.AppendLine($"

"); htmlBuilder.AppendLine($"

Product: {productCode}

"); htmlBuilder.AppendLine($" {barcode.ToHtmlTag()}"); htmlBuilder.AppendLine($"

"); } ```

如何自訂產生的 HTML 標籤屬性？ 當 `ToHtmlTag()` 產生一個標準的 img 標籤時，您可以使用額外的屬性或自訂的 HTML 包裝來強化它。 如需進階客製化功能，請結合 IronBarcode 與我們的 [造型功能](https://ironsoftware.com/csharp/barcode/how-to/customize-barcode-style/)： ```csharp // Create a customized barcode with specific styling var customBarcode = BarcodeWriter.CreateBarcode("CUSTOM-123", BarcodeEncoding.Code128) .AddAnnotationTextAboveBarcode("Product ID") .SetMargins(15) .ChangeBackgroundColor(System.Drawing.Color.LightGray); // Get the HTML tag and add custom attributes string htmlTag = customBarcode.ToHtmlTag(); string customizedTag = htmlTag.Replace("何時應該選擇 HTML 標籤而非資料 URL 格式？ 需要時選擇 HTML 標籤格式： - 乾淨、可讀的 HTML 輸出 - 容易與現有的 HTML 模板整合 - 與 HTML 編輯器和 CMS 系統相容 - 為內容創造者提供直接複製貼上功能 HTML 標籤格式特別適用於 [Blazor 應用程式](https://ironsoftware.com/csharp/barcode/get-started/blazor/)，您可將條碼影像動態注入元件中。

如何將 BarCode 儲存為 HTML 檔案？ 使用 `SaveAsHtmlFile()` 方法將 `GeneratedBarcode` 儲存為 HTML 檔案。 以下程式碼示範此方法： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsHtmlFile.cs ``` 此方法接受檔案路徑字串。 生成的 HTML 檔案包含條碼作為 HTML 標籤，在適當的 ``、`` 和 `` 標籤中，形成一個完整的 HTML 檔案。對於具有多種檔案格式的複雜情況，請參閱我們的 [輸出資料格式指南](https://ironsoftware.com/csharp/barcode/how-to/output-data-formats/)。

為何要生成完整的 HTML 檔案而不是片段？ 完整的 HTML 檔案在特定使用情況下具有明顯的優勢： - **Standalone 文件**：產生可列印的 BarCode 表單 - **電子郵件附件**：傳送自成一格的 BarCode 檔案 - **存檔目的**：以正確的結構儲存條碼 - **測試與除錯**：獨立檢視 BarCode - **批次處理**：產生多個檔案以供分發 以下是產生一批 HTML 檔案的範例： ```csharp // Generate HTML files for inventory items public void GenerateInventoryBarcodes(List items) { foreach (var item in items) { var barcode = BarcodeWriter.CreateBarcode(item.SKU, BarcodeEncoding.Code128) .AddAnnotationTextBelowBarcode($"{item.Name} - ${item.Price:F2}") .ResizeTo(300, 100); // Save with descriptive filename string filename = $"barcode_{item.SKU}_{DateTime.Now:yyyyMMdd}.html"; barcode.SaveAsHtmlFile(filename); } } ```

HTML 檔案匯出的常見使用案例有哪些？ HTML 檔案匯出在這些情況下很有價值： 1.**零售點銷售系統**：產生可列印的價格標籤 2.**倉庫管理**：為貨架建立 BarCode 標籤 3.**文件管理**：在報表中嵌入 BarCode 4.**品質控制**：產生可追蹤的批次代碼 5.**事件管理**：使用可掃描代碼建立票單 對於大量的 BarCode 生成，實施 [async 和多執行緒](https://ironsoftware.com/csharp/barcode/how-to/async-multithread/) 以提高性能。 在使用 QR 碼等專門格式時，我們的 [C# QR 碼產生器教學](https://ironsoftware.com/csharp/barcode/tutorials/csharp-qr-code-generator/) 提供了全面的指導，可針對各種業務需求建立和自訂 QR 碼。