Jak eksportować kody kreskowe jako HTML w C
IronBarcode umożliwia programistom C# eksportowanie wygenerowanych kodów kreskowych jako HTML w trzech formatach: Data URL do osadzania w linii, tag HTML do bezpośredniego wstrzyknięcia lub kompletny plik HTML do samodzielnego użytku—zapewniając wszechstronne opcje integracji bez zewnętrznych zależności.
Szybki start: Eksport kodu kreskowego jako tagu HTML w jednej linii
Generowanie kodu kreskowego i eksportowanie go bezpośrednio jako w pełni ukształtowanego tagu obrazu HTML za pomocą jednej płynnej linii kodu. Rozpocznij szybko bez zarządzania zewnętrznymi plikami obrazów lub zależnościami zasobów.
-
Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode -
Skopiuj i uruchom ten fragment kodu.
var htmlTag = BarcodeWriter.CreateBarcode("1234567890", BarcodeWriterEncoding.Code128).ToHtmlTag(); -
Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronBarcode w swoim projekcie już dziś z darmową wersją próbną
Minimalny proces (5 kroków)
- Pobierz bibliotekę C# do eksportu kodów kreskowych
- Eksportuj kody kreskowe jako Data URL
- Eksportuj kody kreskowe jako tag HTML
- Eksportuj kody kreskowe jako plik HTML
Jak eksportować kod kreskowy jako Data URL?
Przed eksportowaniem kodu kreskowego jako Data URL, zrozum, czym jest Data URL. Data URL (znany również jako Data URI) to Identyfikator Zasobu Jednolitego, który osadza dane bezpośrednio w ciągu URL. Pozwala to na wyświetlanie w linii w stronach internetowych, tak jakby dane były zasobami zewnętrznymi. Data URL obsługuje dowolny format: tekst, obrazy, audio, wideo i dane binarne. Użyj uzyskanego Data URL w HTML wewnątrz tagu obrazu jako atrybutu src. Oto jak konwertować GeneratedBarcode na Data URL:
:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsDataUrl.cs
using IronBarCode;
using System;
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode);
var dataUrl = myBarcode.ToDataUrl();
Console.WriteLine(dataUrl);
Imports IronBarCode
Imports System
Private myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode)
Private dataUrl = myBarcode.ToDataUrl()
Console.WriteLine(dataUrl)
Utwórz kod kreskowy używając metody CreateBarcode() z klasy BarcodeWriter z wartością kodu kreskowego i kodowaniem jako argumentami. Uzyskaj Data URL przez dołączenie metody ToDataUrl() do GeneratedBarcode. To podejście działa ze wszystkimi obsługiwanymi formatami kodów kreskowych w IronBarcode.
Dlaczego użycie Data URL ma znaczenie dla aplikacji webowych?
Data URL zapewnia znaczące korzyści dla aplikacji internetowych poprzez redukcję żądań HTTP i poprawę wydajności ładowania strony. Po osadzeniu kodu kreskowego jako adresu URL danych dane obrazu stają się częścią samego dokumentu HTML, co eliminuje konieczność wysyłania oddzielnych żądań dotyczących plików graficznych. Korzyści:
- Aplikacje jednostronicowe (SPA) wymagające minimalnej liczby operacji serwerowych
- Szablony wiadomości e-mail, w których zewnętrzne obrazy mogą być blokowane
- Aplikacje działające w trybie offline, bez połączenia z siecią
- Dynamiczne generowanie BarCode w sytuacjach, gdy tworzenie fizycznych plików jest nieefektywne
W celu wdrożenia produkcyjnego zapoznaj się z naszymi przewodnikami dotyczącymi wdrażania w Azure lub AWS w celu generowania kodów kreskowych w chmurze.
Kiedy należy używać adresu URL danych zamiast plików graficznych?
Używaj adresów URL danych, gdy BarCodes są małe (poniżej 32 KB) i wymagają natychmiastowego renderowania w tekście. Wybierz tradycyjne pliki graficzne przechowywane na serwerach lub w sieciach CDN, gdy:
// 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
}
// 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
}
' Example: Choosing between Data URL and file export based on size
Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("LARGE-DATA-STRING-HERE", BarcodeEncoding.PDF417)
' Check estimated size before choosing export method
If barcode.BinaryStream.Length < 32768 Then ' 32KB threshold
' Use Data URL for smaller barcodes
Dim dataUrl As String = barcode.ToDataUrl()
' Embed directly in HTML
Else
' Save as file for larger barcodes
barcode.SaveAsImage("large-barcode.png")
' Reference as external resource
End If
Jakie są ograniczenia rozmiaru adresów URL danych?
Chociaż nowoczesne przeglądarki technicznie obsługują adresy URL danych o rozmiarze kilku megabajtów, istnieją praktyczne ograniczenia:
- Internet Explorer 8: Ograniczony do 32 KB
- Nowoczesne przeglądarki: obsługują 2–4 MB, ale wydajność spada
- Przeglądarki mobilne: bardziej rygorystyczne ograniczenia ze względu na ograniczenia pamięci
- Klienci poczty e-mail: Ogranicz rozmiar adresów URL danych do 8–64 KB
Aby uzyskać optymalną wydajność, rozmiar BARCODE-ów Data URL nie powinien przekraczać 32 KB. W przypadku większych BarCodes lub generowania wielu BarCodes należy skorzystać z naszej funkcji eksportu jako strumienia, aby zapewnić efektywne zarządzanie pamięcią.
Jak wyeksportować BarCode jako tag HTML?
Eksportuj GeneratedBarcode do HTML używając metody ToHtmlTag(). Ta metoda renderuje obiekt GeneratedBarcode jako w pełni uformowany tag HTML do bezpośredniego wstrzyknięcia do HTML bez JavaScript, CSS lub zależności obrazów. Poniższy kod ilustruje eksport tagów HTML:
:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsHtmlTag.cs
using IronBarCode;
using System;
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode);
var htmlTag = myBarcode.ToHtmlTag();
Console.WriteLine(htmlTag);
Imports IronBarCode
Imports System
Private myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode)
Private htmlTag = myBarcode.ToHtmlTag()
Console.WriteLine(htmlTag)
Dołącz metodę ToHtmlTag() do GeneratedBarcode, aby uzyskać tag HTML wygenerowanego kodu kreskowego. Umieść ten tag HTML bezpośrednio w większym pliku HTML. Aby uzyskać zaawansowane opcje stylizacji, zapoznaj się z naszym przewodnikiem dotyczącym dostosowywania stylów BARCODE.
Dlaczego eksport tagów HTML jest lepszy niż zewnętrzne odwołania do obrazów?
Eksport tagów HTML zapewnia kluczowe zalety w porównaniu z zewnętrznymi odwołaniami do obrazów:
- Brak uszkodzonych linków do obrazów: dane BarCode są osadzane bezpośrednio w tagu
- Szybsze renderowanie: nie są potrzebne żadne dodatkowe żądania HTTP
- Uproszczone wdrażanie: brak oddzielnego zarządzania zasobami graficznymi
- Większe bezpieczeństwo: brak ujawniania ścieżek plików lub struktury serwera
- Generowanie dynamiczne: idealne do tworzenia kodów barcode w czasie rzeczywistym
Oto praktyczny przykład integracji aplikacji internetowej:
// 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($"<div class='product-barcode'>");
htmlBuilder.AppendLine($" <p>Product: {productCode}</p>");
htmlBuilder.AppendLine($" {barcode.ToHtmlTag()}");
htmlBuilder.AppendLine($"</div>");
}
// 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($"<div class='product-barcode'>");
htmlBuilder.AppendLine($" <p>Product: {productCode}</p>");
htmlBuilder.AppendLine($" {barcode.ToHtmlTag()}");
htmlBuilder.AppendLine($"</div>");
}
Imports System.Text
' Generate multiple barcodes for a product catalog
Dim products = New String() {"PROD-001", "PROD-002", "PROD-003"}
Dim htmlBuilder = New StringBuilder()
For Each productCode In products
Dim barcode = BarcodeWriter.CreateBarcode(productCode, BarcodeEncoding.Code128) _
.ResizeTo(200, 50) _
.SetMargins(10)
htmlBuilder.AppendLine("<div class='product-barcode'>")
htmlBuilder.AppendLine($" <p>Product: {productCode}</p>")
htmlBuilder.AppendLine($" {barcode.ToHtmlTag()}")
htmlBuilder.AppendLine("</div>")
Next
Jak mogę dostosować atrybuty wygenerowanych tagów HTML?
Podczas gdy ToHtmlTag() generuje standardowy tag img, możesz go wzbogacić o dodatkowe atrybuty lub niestandardowe opakowanie HTML. Aby uzyskać zaawansowane możliwości dostosowywania, połącz IronBarcode z naszymi funkcjami stylizacji:
// 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("<img", "<img class='barcode' id='product-123'");
// 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("<img", "<img class='barcode' id='product-123'");
' Create a customized barcode with specific styling
Dim 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
Dim htmlTag As String = customBarcode.ToHtmlTag()
Dim customizedTag As String = htmlTag.Replace("<img", "<img class='barcode' id='product-123'")
Kiedy należy wybrać tag HTML zamiast formatu Data URL?
Wybierz format tagów HTML, gdy potrzebujesz:
- Czysty, czytelny kod HTML
- Łatwa integracja z istniejącymi szablonami HTML
- Kompatybilność z edytorami HTML i systemami CMS
- Funkcja bezpośredniego kopiowania i wklejania dla twórców treści
Format tagów HTML sprawdza się szczególnie dobrze w aplikacjach Blazor, w których dynamicznie wstawia się obrazy BarCode do komponentów.
Jak zapisać BarCode jako plik HTML?
Zapisz GeneratedBarcode jako plik HTML używając metody SaveAsHtmlFile(). Poniższy kod ilustruje tę metodę:
:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsHtmlFile.cs
using IronBarCode;
GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode);
myBarcode.SaveAsHtmlFile("myBarcode.html");
Imports IronBarCode
Private myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.QRCode)
myBarcode.SaveAsHtmlFile("myBarcode.html")
Ta metoda przyjmuje ciąg znaków reprezentujący ścieżkę do pliku. Wygenerowany plik HTML zawiera kod kreskowy jako tag HTML wewnątrz odpowiednich tagów <html>, <head> i <body> tworzących kompletny plik HTML. Dla skomplikowanych scenariuszy z wieloma formatami plików, zobacz nasz przewodnik po formatach danych wyjściowych.
Dlaczego warto generować kompletne pliki HTML zamiast fragmentów?
Kompletne pliki HTML oferują wyraźne zalety w konkretnych przypadkach użycia:
- Dokumentacja samodzielna: Generowanie arkuszy BarCode do wydruku
- Załączniki do wiadomości e-mail: wysyłaj samodzielne pliki z kodami BarCode
- Do celów archiwizacji: Przechowuj BarCodes o odpowiedniej strukturze
- Testowanie i debugowanie: Wyświetlanie BarCode-ów niezależnie
- Przetwarzanie wsadowe: Generowanie wielu plików do dystrybucji
Oto przykład generowania partii plików HTML:
// Generate HTML files for inventory items
public void GenerateInventoryBarcodes(List<InventoryItem> 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);
}
}
// Generate HTML files for inventory items
public void GenerateInventoryBarcodes(List<InventoryItem> 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);
}
}
' Generate HTML files for inventory items
Public Sub GenerateInventoryBarcodes(items As List(Of InventoryItem))
For Each item In items
Dim barcode = BarcodeWriter.CreateBarcode(item.SKU, BarcodeEncoding.Code128) _
.AddAnnotationTextBelowBarcode($"{item.Name} - ${item.Price:F2}") _
.ResizeTo(300, 100)
' Save with descriptive filename
Dim filename As String = $"barcode_{item.SKU}_{DateTime.Now:yyyyMMdd}.html"
barcode.SaveAsHtmlFile(filename)
Next
End Sub
Jakie są typowe zastosowania eksportu plików HTML?
Eksport plików HTML okazuje się przydatny w następujących sytuacjach:
- Systemy kasowe dla handlu detalicznego: Generowanie etykiet cenowych do wydruku
- Zarządzanie magazynem: Tworzenie etykiet z BarCode do rozmieszczenia na półkach
- Zarządzanie dokumentami: osadzanie BarCodes w raportach
- Kontrola jakości: Generowanie identyfikowalnych kodów partii
- Zarządzanie wydarzeniami: Tworzenie biletów z kodami do skanowania
W przypadku generowania dużej liczby BarCodes należy wdrożyć asynchroniczność i wielowątkowość w celu poprawy wydajności. W przypadku pracy ze specjalistycznymi formatami, takimi jak kody QR, nasz samouczek dotyczący generatora kodów QR w języku C# zawiera wyczerpujące wskazówki dotyczące tworzenia i dostosowywania kodów QR do różnych potrzeb biznesowych.
Często Zadawane Pytania
Jak eksportować kod kreskowy jako URL danych w C#?
Za pomocą IronBarcode możesz eksportować kod kreskowy jako URL danych, używając metody ToDataUrl() na obiekcie GeneratedBarcode. Po prostu utwórz swój kod kreskowy za pomocą BarcodeWriter.CreateBarcode() z wybraną wartością i kodowaniem, a następnie wywołaj ToDataUrl(), aby uzyskać ciąg URL danych, który można osadzić bezpośrednio w HTML.
Jakie są trzy dostępne formaty eksportu HTML dla kodów kreskowych?
IronBarcode udostępnia trzy formaty eksportu HTML: URL danych do osadzenia w linii bez zewnętrznych plików, znacznik HTML do bezpośredniego wstrzyknięcia w strony internetowe i kompletny plik HTML do samodzielnego użytku. Każdy format służy różnym potrzebom integracyjnym w aplikacjach internetowych.
Czy mogę wygenerować znacznik obrazu HTML dla kodu kreskowego za pomocą jednej linii kodu?
Tak, IronBarcode pozwala wygenerować w pełni sformowany znacznik obrazu HTML za pomocą jednej płynnej linii kodu. Użyj BarcodeWriter.CreateBarcode() z wartością swojego kodu kreskowego i kodowaniem, a następnie dołącz metodę ToHtmlTag(), aby uzyskać kompletny znacznik obrazu HTML gotowy do zastosowania.
Kiedy powinienem używać URL danych zamiast tradycyjnych plików graficznych dla kodów kreskowych?
Użyj URL danych, gdy kody kreskowe są małe (poniżej 32KB) i wymagają natychmiastowego renderowania w linii. Idealnie nadają się do aplikacji jednostronicowych, szablonów e-mail, aplikacji z możliwością pracy offline i scenariuszy dynamicznego generowania kodów kreskowych. Metoda ToDataUrl() w IronBarcode sprawia, że ta konwersja jest płynna.
Jakie formaty kodów kreskowych są obsługiwane dla eksportu HTML?
IronBarcode obsługuje wszystkie swoje formaty kodów kreskowych dla eksportu HTML, w tym Code 128, kody QR i wiele innych. Metody eksportu ToDataUrl(), ToHtmlTag() i pliku HTML działają ze wszystkimi obsługiwanymi formatami kodów kreskowych w bibliotece.
Jak użycie URL danych poprawia wydajność aplikacji internetowej?
URL danych poprawiają wydajność poprzez osadzenie danych obrazu kodu kreskowego bezpośrednio w dokumencie HTML, eliminując osobne żądania HTTP dla plików graficznych. To zmniejsza liczbę podróży serwera i poprawia czasy ładowania strony, co jest szczególnie korzystne podczas używania IronBarcode do dynamicznego generowania kodów kreskowych w aplikacjach internetowych.

