Resolve Runtime Copy Exceptions in IronBarcode

已更新:六月 1, 2025

Translated

View the article in English

This error is caused in some rare cases where the DLLs for our special ML model are not copied over properly. In the solution below, you can solve this one-time error.

Machine learning DLLs were not successfully automatically copied from the runtimes directory. This may occur on various operating systems or frameworks...

Solution

The solution to this problem is to first navigate to the runtimes folder. In your solution, this will be under /bin/Debug/net6.0/runtimes (Debug is an example, follow the Configuration you have set) (If you're using a different target framework, replace net6.0).
You will see all supported platforms and operating systems as directories in /runtimes/, go into the one that applies to you and copy the files out into the output /bin/Debug/net6.0/ directory manually.
Disabling the ML scan can also prevent the error. However, you should note that turning off ML scanning might make it harder to detect some barcodes, as this feature helps with barcode detection.

// Define scanning options, disabling machine learning for basic scan only
var myOptionsExample = new BarcodeReaderOptions
{
    // ScanMode is set to only use the basic scan, without ML-enhanced features
    ScanMode = BarcodeScanMode.OnlyBasicScan
};

// Perform barcode reading with the specified options
var results = BarcodeReader.Read("barcode.png", myOptionsExample);

// Define scanning options, disabling machine learning for basic scan only
var myOptionsExample = new BarcodeReaderOptions
{
    // ScanMode is set to only use the basic scan, without ML-enhanced features
    ScanMode = BarcodeScanMode.OnlyBasicScan
};

// Perform barcode reading with the specified options
var results = BarcodeReader.Read("barcode.png", myOptionsExample);

' Define scanning options, disabling machine learning for basic scan only
Dim myOptionsExample = New BarcodeReaderOptions With {.ScanMode = BarcodeScanMode.OnlyBasicScan}

' Perform barcode reading with the specified options
Dim results = BarcodeReader.Read("barcode.png", myOptionsExample)

$vbLabelText $csharpLabel