Resolve Runtime Copy Exceptions in IronBarcode

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

  1. 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).
  2. 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.
  3. 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
Curtis Chau
Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...

Read More
Ready to Get Started?
Nuget Downloads 1,904,967 | Version: 2025.10 just released