Jeśli korzystasz z DevExpress w zakresie elementów sterujących siatki, wykresów, harmonogramów lub tabel przestawnych, zachowaj je. Ta migracja dotyczy zastąpienia BarCodeControl biblioteką, która potrafi również odczytywać kody kreskowe, działać bezgłowowo i być wdrażana poza kontekstem interfejsu użytkownika. Migracja ta nie ma wpływu na kontrolki interfejsu użytkownika DevExpress, z których korzystasz w aplikacjach WinForms lub Blazor. Zmienia się tylko kod dotyczący kodów kreskowych.
Typowy scenariusz, który skłania do tej migracji, to jedna z trzech sytuacji: pojawia się zapotrzebowanie na czytanie, a DevExpress nie jest w stanie go zaspokoić; Nowa usługa wymaga generowania BARCODE-ów w .NET Core lub funkcji chmurowej, w której nie ma zestawów WinForms; lub nadchodzi czas odnowienia Suite, a kalkulacja kosztu na funkcję przy użyciu pełnego zestawu narzędzi UI wyłącznie do generowania BarCode przestaje mieć sens.
Jeśli w tym samym projekcie znajdują się inne kontrolki DevExpress, należy pozostawić pakiety DevExpress NuGet na miejscu. Zmienia się tylko kod związany z kodami BarCode w plikach źródłowych. Jeśli generowanie kodów kreskowych było jedynym powodem, dla którego DevExpress pojawił się w danym projekcie, a nie używasz tam żadnych innych kontrolek DX, możesz usunąć pakiety DevExpress z tego projektu po migracji:
# Only remove DevExpress packages if no other DX controls are used in this project
dotnet remove package DevExpress.Win.NavigationDodaj aktywację licencji IronBarcode raz przy starcie aplikacji — w Program.cs, App.xaml.cs lub w twoim host builderze:
// In Program.cs (ASP.NET Core) or application entry point
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";Imports IronBarCode
' In Program.vb (ASP.NET Core) or application entry point
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"Brak połączenia sieciowego. Brak kodów błędów do sprawdzenia. Walidacja lokalna.
Przeszukaj swój kod źródłowy pod kątem typów BARCODE-ów DevExpress. Wszystko inne pozostaje bez zmian:
# Find barcode-related DevExpress usage — ignore grid, chart, and other DX components
grep -r "BarCodeControl\|Code128Generator\|QRCodeGenerator\|DataMatrixGenerator\|PDF417Generator\|AztecCodeGenerator\|DevExpress.XtraPrinting.BarCode" --include="*.cs" .
grep -r "barCode\.Module\|DrawToBitmap\|BarCode\.Symbology" --include="*.cs" .Wyniki tego wyszukiwania są dokładnie tym, co należy zastąpić. Nic więcej.
Jest to najczęstszy rodzaj migracji. BarCodeControl z Code128Generator symbologią staje się pojedynczym wywołaniem BarcodeWriter.CreateBarcode.
Przed — Kontrolka DevExpress WinForms:
using DevExpress.XtraEditors;
using DevExpress.XtraPrinting.BarCode;
using System.Drawing;
using System.Drawing.Imaging;
public void GenerateCode128(string data, string outputPath)
{
var barCode = new BarCodeControl();
var symbology = new Code128Generator();
symbology.CharacterSet = Code128CharacterSet.CharsetAuto;
barCode.Symbology = symbology;
barCode.Text = data;
barCode.Module = 0.02f;
barCode.ShowText = true;
barCode.Width = 400;
barCode.Height = 100;
var bitmap = new Bitmap(barCode.Width, barCode.Height);
barCode.DrawToBitmap(bitmap, new Rectangle(0, 0, barCode.Width, barCode.Height));
bitmap.Save(outputPath, ImageFormat.Png);
bitmap.Dispose();
}Imports DevExpress.XtraEditors
Imports DevExpress.XtraPrinting.BarCode
Imports System.Drawing
Imports System.Drawing.Imaging
Public Sub GenerateCode128(data As String, outputPath As String)
Dim barCode As New BarCodeControl()
Dim symbology As New Code128Generator()
symbology.CharacterSet = Code128CharacterSet.CharsetAuto
barCode.Symbology = symbology
barCode.Text = data
barCode.Module = 0.02F
barCode.ShowText = True
barCode.Width = 400
barCode.Height = 100
Dim bitmap As New Bitmap(barCode.Width, barCode.Height)
barCode.DrawToBitmap(bitmap, New Rectangle(0, 0, barCode.Width, barCode.Height))
bitmap.Save(outputPath, ImageFormat.Png)
bitmap.Dispose()
End SubPo — IronBarcode:
// NuGet: dotnet add package BarCode
using IronBarCode;
public void GenerateCode128(string data, string outputPath)
{
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
.ResizeTo(400, 100)
.SaveAsPng(outputPath);
}Imports IronBarCode
Public Sub GenerateCode128(data As String, outputPath As String)
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
.ResizeTo(400, 100) _
.SaveAsPng(outputPath)
End SubRozmiar dokumentu barCode.Module = 0.02f w jednostkach dokumentu został usunięty. .ResizeTo(400, 100) przyjmuje piksele bezpośrednio. Ręczne przypisanie Bitmap i wywołanie DrawToBitmap zostaje zamienione na .SaveAsPng(), które automatycznie obsługuje rozmiarowanie.
Przed — DevExpress QR z poprawkami błędów:
using DevExpress.XtraEditors;
using DevExpress.XtraPrinting.BarCode;
using System.Drawing;
using System.Drawing.Imaging;
public void GenerateQrCode(string url, string outputPath)
{
var barCode = new BarCodeControl();
var symbology = new QRCodeGenerator();
symbology.ErrorCorrectionLevel = QRCodeErrorCorrectionLevel.H;
symbology.CompactionMode = QRCodeCompactionMode.AlphaNumeric;
barCode.Symbology = symbology;
barCode.Text = url;
barCode.Width = 500;
barCode.Height = 500;
var bitmap = new Bitmap(barCode.Width, barCode.Height);
barCode.DrawToBitmap(bitmap, new Rectangle(0, 0, barCode.Width, barCode.Height));
bitmap.Save(outputPath, ImageFormat.Png);
bitmap.Dispose();
}Imports DevExpress.XtraEditors
Imports DevExpress.XtraPrinting.BarCode
Imports System.Drawing
Imports System.Drawing.Imaging
Public Sub GenerateQrCode(url As String, outputPath As String)
Dim barCode As New BarCodeControl()
Dim symbology As New QRCodeGenerator()
symbology.ErrorCorrectionLevel = QRCodeErrorCorrectionLevel.H
symbology.CompactionMode = QRCodeCompactionMode.AlphaNumeric
barCode.Symbology = symbology
barCode.Text = url
barCode.Width = 500
barCode.Height = 500
Dim bitmap As New Bitmap(barCode.Width, barCode.Height)
barCode.DrawToBitmap(bitmap, New Rectangle(0, 0, barCode.Width, barCode.Height))
bitmap.Save(outputPath, ImageFormat.Png)
bitmap.Dispose()
End SubPo — IronBarcode:
using IronBarCode;
public void GenerateQrCode(string url, string outputPath)
{
QRCodeWriter.CreateQrCode(url, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
.SaveAsPng(outputPath);
}Imports IronBarCode
Public Sub GenerateQrCode(url As String, outputPath As String)
QRCodeWriter.CreateQrCode(url, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
.SaveAsPng(outputPath)
End SubQRCodeErrorCorrectionLevel.H mapuje się na QRCodeWriter.QrErrorCorrectionLevel.Highest. Ustawienia CompactionMode.AlphaNumeric są automatycznie obsługiwane przez IronBarcode w oparciu o zawartość.
Kod QR z logo marki (zupełnie nowa funkcja — niemożliwa do zrealizowania w DevExpress):
using IronBarCode;
public void GenerateBrandedQrCode(string url, string logoPath, string outputPath)
{
QRCodeWriter.CreateQrCode(url, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
.AddBrandLogo(logoPath)
.SaveAsPng(outputPath);
}Imports IronBarCode
Public Sub GenerateBrandedQrCode(url As String, logoPath As String, outputPath As String)
QRCodeWriter.CreateQrCode(url, 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
.AddBrandLogo(logoPath) _
.SaveAsPng(outputPath)
End SubPrzed — DevExpress:
using DevExpress.XtraEditors;
using DevExpress.XtraPrinting.BarCode;
var barCode = new BarCodeControl();
var symbology = new DataMatrixGenerator();
symbology.MatrixSize = DataMatrixSize.Matrix26x26;
barCode.Symbology = symbology;
barCode.Text = "PART-7734-X";
// ... DrawToBitmap patternImports DevExpress.XtraEditors
Imports DevExpress.XtraPrinting.BarCode
Dim barCode As New BarCodeControl()
Dim symbology As New DataMatrixGenerator()
symbology.MatrixSize = DataMatrixSize.Matrix26x26
barCode.Symbology = symbology
barCode.Text = "PART-7734-X"
' ... DrawToBitmap patternPo — IronBarcode:
using IronBarCode;
BarcodeWriter.CreateBarcode("PART-7734-X", BarcodeEncoding.DataMatrix)
.ResizeTo(260, 260)
.SaveAsPng("datamatrix.png");Imports IronBarCode
BarcodeWriter.CreateBarcode("PART-7734-X", BarcodeEncoding.DataMatrix) _
.ResizeTo(260, 260) _
.SaveAsPng("datamatrix.png")Przed — DevExpress:
using DevExpress.XtraEditors;
using DevExpress.XtraPrinting.BarCode;
var barCode = new BarCodeControl();
barCode.Symbology = new PDF417Generator();
barCode.Text = "SHIPMENT-DATA-2026";
// ... DrawToBitmap patternImports DevExpress.XtraEditors
Imports DevExpress.XtraPrinting.BarCode
Dim barCode As New BarCodeControl()
barCode.Symbology = New PDF417Generator()
barCode.Text = "SHIPMENT-DATA-2026"
' ... DrawToBitmap patternPo — IronBarcode:
using IronBarCode;
BarcodeWriter.CreateBarcode("SHIPMENT-DATA-2026", BarcodeEncoding.PDF417)
.ResizeTo(400, 150)
.SaveAsPng("pdf417.png");Imports IronBarCode
BarcodeWriter.CreateBarcode("SHIPMENT-DATA-2026", BarcodeEncoding.PDF417) _
.ResizeTo(400, 150) _
.SaveAsPng("pdf417.png")DevExpress nie udostępnia API do odczytu. Jeśli pojawiła się potrzeba odczytu, właśnie w tym momencie IronBarcode natychmiast się zwraca:
using IronBarCode;
// Read from an image file
var results = BarcodeReader.Read("uploaded-label.png");
foreach (var result in results)
{
Console.WriteLine($"Found {result.Format}: {result.Value}");
}
// Read with options for better accuracy on difficult images
var options = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Balanced,
ExpectMultipleBarcodes = true,
MaxParallelThreads = 4
};
var detailedResults = BarcodeReader.Read("multi-barcode-sheet.png", options);Imports IronBarCode
' Read from an image file
Dim results = BarcodeReader.Read("uploaded-label.png")
For Each result In results
Console.WriteLine($"Found {result.Format}: {result.Value}")
Next
' Read with options for better accuracy on difficult images
Dim options As New BarcodeReaderOptions With {
.Speed = ReadingSpeed.Balanced,
.ExpectMultipleBarcodes = True,
.MaxParallelThreads = 4
}
Dim detailedResults = BarcodeReader.Read("multi-barcode-sheet.png", options)To nie było osiągalne z BarCodeControl bez obejść WinForms. IronBarcode obsługuje to natywnie:
using IronBarCode;
// In Program.cs or a controller
app.MapGet("/label/{sku}", (string sku) =>
{
var pngBytes = BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
.ResizeTo(400, 100)
.ToPngBinaryData();
return Results.File(pngBytes, "image/png", $"{sku}.png");
});
app.MapGet("/qr/{data}", (string data) =>
{
var pngBytes = QRCodeWriter.CreateQrCode(data, 300, QRCodeWriter.QrErrorCorrectionLevel.Highest)
.ToPngBinaryData();
return Results.File(pngBytes, "image/png");
});Imports IronBarCode
' In Program.vb or a controller
app.MapGet("/label/{sku}", Function(sku As String)
Dim pngBytes = BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
.ResizeTo(400, 100) _
.ToPngBinaryData()
Return Results.File(pngBytes, "image/png", $"{sku}.png")
End Function)
app.MapGet("/qr/{data}", Function(data As String)
Dim pngBytes = QRCodeWriter.CreateQrCode(data, 300, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
.ToPngBinaryData()
Return Results.File(pngBytes, "image/png")
End Function)IronBarcode odczytuje pliki PDF w sposób natywny. Bez PdfiumViewer, bez pętli renderowania, bez dodatkowych pakietów:
using IronBarCode;
// Read all barcodes from all pages of a PDF
var results = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in results)
{
Console.WriteLine($"Barcode: {result.Value} | Format: {result.Format}");
}Imports IronBarCode
' Read all barcodes from all pages of a PDF
Dim results = BarcodeReader.Read("shipping-manifest.pdf")
For Each result In results
Console.WriteLine($"Barcode: {result.Value} | Format: {result.Format}")
NextbarCode.Module kontroluje szerokość najwęższego paska w jednostkach dokumentu (zależnych od kontekstu DPI renderowania). Nie chodzi tu o liczbę pikseli. Podczas migracji nie próbuj przeliczać wartości modułu na piksele — zamiast tego zdecyduj się, jakie wymiary w pikselach chcesz i użyj .ResizeTo(width, height) bezpośrednio.
// Before: barCode.Module = 0.02f — document units, indirect sizing
// After:
.ResizeTo(400, 100) // explicit pixel dimensions' Before: barCode.Module = 0.02F — document units, indirect sizing
' After:
.ResizeTo(400, 100) ' explicit pixel dimensionsStary wzór przydzielał Bitmap o określonym rozmiarze, a następnie wywoływał DrawToBitmap, aby renderować do niego. .SaveAsPng() IronBarcode obsługuje to wszystko wewnętrznie. Nie przydzielasz niczego z góry.
// Before: must know size upfront, allocate, draw, save, dispose
barCode.Width = 400;
barCode.Height = 100;
var bitmap = new Bitmap(barCode.Width, barCode.Height);
barCode.DrawToBitmap(bitmap, new Rectangle(0, 0, barCode.Width, barCode.Height));
bitmap.Save(path, ImageFormat.Png);
bitmap.Dispose();
// After: size specified once, everything else handled
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
.ResizeTo(400, 100)
.SaveAsPng(path);' Before: must know size upfront, allocate, draw, save, dispose
barCode.Width = 400
barCode.Height = 100
Dim bitmap As New Bitmap(barCode.Width, barCode.Height)
barCode.DrawToBitmap(bitmap, New Rectangle(0, 0, barCode.Width, barCode.Height))
bitmap.Save(path, ImageFormat.Png)
bitmap.Dispose()
' After: size specified once, everything else handled
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
.ResizeTo(400, 100) _
.SaveAsPng(path)Jeśli BarCodeControl był powiązany z źródłem danych w projektancie WinForms, równoważny IronBarcode to wyraźnie odczytanie wartości z modelu i przekazanie jej do BarcodeWriter.CreateBarcode. IronBarcode nie uczestniczy w powiązaniu danych WinForms — jest to programowe API, a nie kontrolka interfejsu użytkownika. Jeśli potrzebujesz wyświetlić wygenerowany kod kreskowy na formularzu, wygeneruj bajty obrazu i ustaw je na PictureBox:
using IronBarCode;
// Generate and display in a WinForms PictureBox
private void UpdateBarcodeDisplay(string value)
{
var bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128)
.ResizeTo(400, 100)
.ToPngBinaryData();
using var ms = new System.IO.MemoryStream(bytes);
pictureBox1.Image = System.Drawing.Image.FromStream(ms);
}Imports IronBarCode
Imports System.IO
' Generate and display in a WinForms PictureBox
Private Sub UpdateBarcodeDisplay(value As String)
Dim bytes = BarcodeWriter.CreateBarcode(value, BarcodeEncoding.Code128) _
.ResizeTo(400, 100) _
.ToPngBinaryData()
Using ms As New MemoryStream(bytes)
pictureBox1.Image = System.Drawing.Image.FromStream(ms)
End Using
End SubStare importy do usunięcia:
// Remove these
using DevExpress.XtraEditors;
using DevExpress.XtraPrinting.BarCode;netNowy import do dodania:
// Add this
using IronBarCode;Imports IronBarCode| DevExpress BarCode | Odpowiednik IronBarcode |
|---|---|
new BarCodeControl() | Statyczne — brak instancji |
new Code128Generator() + barCode.Symbology = symbology | BarcodeEncoding.Code128 parametr |
new QRCodeGenerator() + QRCodeErrorCorrectionLevel.H | QRCodeWriter.CreateQrCode(data, size, QRCodeWriter.QrErrorCorrectionLevel.Highest) |
new DataMatrixGenerator() + DataMatrixSize.Matrix26x26 | BarcodeWriter.CreateBarcode(data, BarcodeEncoding.DataMatrix) |
new PDF417Generator() | BarcodeWriter.CreateBarcode(data, BarcodeEncoding.PDF417) |
new AztecCodeGenerator() | BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Aztec) |
barCode.Text = value | Pierwszy argument do CreateBarcode lub CreateQrCode |
barCode.Module = 0.02f | .ResizeTo(width, height) w pikselach |
barCode.ShowText = true | .AddBarcodeText() |
DrawToBitmap(bitmap, rect) | .SaveAsPng(path) |
new Bitmap(w, h) + ręczna likwidacja | Nie jest potrzebne |
Bitmap → MemoryStream → HTTP | .ToPngBinaryData() |
| Brak API do odczytu | BarcodeReader.Read(path) |
using DevExpress.XtraEditors + using DevExpress.XtraPrinting.BarCode | using IronBarCode |
Użyj tego wzorca grep, aby znaleźć wszystkie pliki wymagające aktualizacji:
grep -r "BarCodeControl\|Code128Generator\|QRCodeGenerator\|DataMatrixGenerator\|PDF417Generator\|AztecCodeGenerator" --include="*.cs" .
grep -r "barCode\.Module\|barCode\.Symbology\|DrawToBitmap\|DevExpress\.XtraPrinting\.BarCode" --include="*.cs" .Przejrzyj wszystkie dopasowania:
using DevExpress.XtraEditors; i using DevExpress.XtraPrinting.BarCode; przez using IronBarCode;new BarCodeControl() + konfigurację symboliki przez BarcodeWriter.CreateBarcode(data, BarcodeEncoding.X)new QRCodeGenerator() + konfigurację symboliki przez QRCodeWriter.CreateQrCode(data, size, errorLevel)barCode.Module = X przez .ResizeTo(width, height)DrawToBitmap + bitmap.Save przez .SaveAsPng(path).ToPngBinaryData()IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY" przy starcie aplikacjiBarcodeReader.Read() wszędzie tam, gdzie potrzebna jest możliwość odczytuJeśli w projekcie wykorzystuje się DevExpress wyłącznie do obsługi kodów kreskowych, a nie stosuje się innych komponentów DX, należy usunąć pakiety DevExpress NuGet po zastąpieniu wszystkich odwołań do kodów kreskowych. Jeśli w projekcie wykorzystywane są kontrolki siatki, wykresów lub inne kontrolki interfejsu użytkownika DevExpress, należy pozostawić te pakiety na miejscu — migracja dotyczy wyłącznie kodu kodu BarCode.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.
IronBarcode jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz szybko odczytać, zapisać i wystylizować kody kreskowe.
