El escaneo de códigos de barras en ASP.NET se vuelve sencillo con IronBarcode: instalar a través de NuGet, llamar a BarcodeReader.Read(), y obtener valores decodificados con tipo, confianza y datos de posición en un solo paso, sin necesidad de configuraciones complejas.
El escaneo de códigos de barras es un requisito estándar en las aplicaciones web modernas, que potencia la gestión de inventario, el procesamiento de documentos y los flujos de trabajo de validación de tickets. Según GS1 , los códigos de barras se utilizan en más de 6 mil millones de transacciones diarias en todo el mundo, una cifra que subraya lo importante que es la lectura precisa de códigos de barras para cualquier sistema comercial. El estándar ISO/IEC 15415 define métricas de calidad para símbolos de códigos de barras 2D, mientras que el estándar ISO/IEC 15416 cubre códigos de barras lineales 1D, ambos compatibles de forma nativa con IronBarcode .
Esta guía le muestra cómo agregar un escaneo de código de barras confiable a su aplicación ASP.NET Core usando IronBarcode, cubriendo la instalación, el procesamiento de carga de archivos, la integración de API REST y los patrones de implementación de producción. Al final, tendrás un código funcional tanto para un escáner de carga de archivos de páginas Razor como para un punto final de API JSON que acepta imágenes codificadas en base64 desde cualquier cliente.
Comenzar sólo lleva unos minutos. La biblioteca es compatible con aplicaciones ASP.NET Core y ASP.NET MVC tradicionales, lo que la hace adaptable a diversos tipos de proyectos. Las implementaciones empresariales funcionan igual de bien en Azure , AWS Lambda y contenedores Docker . La detección basada en aprendizaje automático de la biblioteca maneja imágenes de códigos de barras complejas aplicando automáticamente una corrección de imagen sofisticada, lo que resulta particularmente útil al procesar fotos tomadas con cámaras móviles en condiciones de iluminación variables.
Abra la consola del gestor de paquetes en Visual Studio y ejecute:
Alternativamente, utilice la CLI de .NET :
O busque "BarCode" en la interfaz de usuario del Administrador de paquetes NuGet de Visual Studio y haga clic en Instalar. El paquete gestiona automáticamente todas las dependencias.
Para implementaciones específicas de la plataforma, considere usar paquetes NuGet específicos de la plataforma que estén optimizados para su entorno de destino. La biblioteca ofrece paquetes estándar y BarCode.Slim para adaptarse a diferentes escenarios de implementación. Para obtener la guía de instalación completa, consulte la guía de instalación de IronBarcode .
Una vez instalado, agregue la declaración using necesaria a sus archivos C#:
using IronBarCode;Imports IronBarCodeEsta importación le brinda acceso a las capacidades completas de lectura y generación de códigos de barras de IronBarcode. La biblioteca admite más de 30 formatos de códigos de barras, incluyendo QR Code, Code 128, Code 39, Data Matrix y PDF417. Consulte la lista completa de formatos de códigos de barras compatibles para confirmar la compatibilidad con su caso de uso.
Para solucionar problemas de instalación, consulte la guía de solución de problemas de paquetes NuGet o envíe una solicitud de ingeniería para obtener soporte especializado.
Al implementar el escaneo de códigos de barras en ASP.NET, existen dos enfoques arquitectónicos principales. Comprender estos patrones le ayudará a elegir la configuración adecuada del lector de código de barras para cada caso de uso:
// Server-side processing -- recommended for most ASP.NET scenarios
var options = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Balanced,
ExpectMultipleBarcodes = true,
UseConfidenceThreshold = true,
ConfidenceThreshold = 0.85
};
var results = BarcodeReader.Read(stream, options);
foreach (var barcode in results)
{
Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Text}");
}Imports System
' Server-side processing -- recommended for most ASP.NET scenarios
Dim options As New BarcodeReaderOptions With {
.Speed = ReadingSpeed.Balanced,
.ExpectMultipleBarcodes = True,
.UseConfidenceThreshold = True,
.ConfidenceThreshold = 0.85
}
Dim results = BarcodeReader.Read(stream, options)
For Each barcode In results
Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Text}")
NextEl enfoque del lado del servidor le brinda el máximo control sobre el procesamiento de imágenes y funciona de manera consistente en todos los navegadores. Cuando el servidor procesa cada imagen, también obtiene un registro de auditoría limpio: cada código de barras escaneado pasa a través de su capa de aplicación, donde puede registrarlo, validarlo contra una base de datos o activar flujos de trabajo posteriores. Este patrón es particularmente adecuado para industrias reguladas como la atención médica, la logística y la fabricación, donde cada escaneo debe registrarse.
Para la integración de capturas de cámara del lado del cliente, los navegadores modernos soportan la API MediaDevices para acceso a la cámara, que se puede combinar con el procesamiento del lado del servidor de IronBarcode a través de una API REST, cubierto en detalle más adelante en esta guía. Elegir el procesamiento del lado del servidor también simplifica su modelo de seguridad: no hay lógica de procesamiento sensible expuesta al navegador, y toda la validación ocurre detrás del límite de su aplicación.
| Aspecto | Captura del lado del cliente + procesamiento del servidor | Procesamiento puro del lado del servidor |
|---|---|---|
| Best para | Escaneo en tiempo real con cámara | Procesamiento por lotes, carga de archivos |
| Compatibilidad con navegadores | Sólo navegadores modernos | Todos los navegadores |
| Experiencia de usuario | Retroalimentación instantánea | Flujo de carga estándar |
| Modelo de seguridad | Más complejo (CORS, autenticación) | Directo |
| Uso del ancho de banda | Inferior (preprocesado en el dispositivo) | Superior (carga de imagen sin procesar) |
El escaneo de carga de archivos es el escenario de código de barras más común en las aplicaciones web ASP.NET . Este patrón funciona para procesar facturas, etiquetas de envío o cualquier documento con códigos de barras incrustados. Para mejorar el rendimiento, considere implementar la lectura de códigos de barras asincrónica para manejar múltiples cargas simultáneamente.
Cree un formulario HTML adaptable en su vista ASP.NET :
@* Razor view -- barcode upload form *@
<form method="post" enctype="multipart/form-data" id="barcodeForm">
<div class="form-group">
<label for="barcodeFile">Select Barcode Image:</label>
<input type="file" name="barcodeFile" id="barcodeFile"
accept="image/*,.pdf" class="form-control"
capture="environment" />
</div>
<button type="submit" class="btn btn-primary" id="scanBtn">
<span class="spinner-border spinner-border-sm d-none" role="status"></span>
Scan Barcode
</button>
</form>
<div id="results">
@ViewBag.BarcodeResult
</div>@* Razor view -- barcode upload form *@
<form method="post" enctype="multipart/form-data" id="barcodeForm">
<div class="form-group">
<label for="barcodeFile">Select Barcode Image:</label>
<input type="file" name="barcodeFile" id="barcodeFile"
accept="image/*,.pdf" class="form-control"
capture="environment" />
</div>
<button type="submit" class="btn btn-primary" id="scanBtn">
<span class="spinner-border spinner-border-sm d-none" role="status"></span>
Scan Barcode
</button>
</form>
<div id="results">
@ViewBag.BarcodeResult
</div>El atributo capture="environment" activa la cámara trasera en dispositivos móviles, brindando a los usuarios una experiencia similar a una cámara nativa sin JavaScript.
La acción del controlador maneja la validación de archivos, el procesamiento del flujo de memoria y el formato de resultados:
[HttpPost]
[ValidateAntiForgeryToken]
[RequestSizeLimit(10_000_000)] // 10MB limit
public async Task<IActionResult> ScanBarcode(IFormFile barcodeFile)
{
var allowedExtensions = new[] { ".jpg", ".jpeg", ".png", ".gif",
".tiff", ".bmp", ".pdf" };
var extension = Path.GetExtension(barcodeFile.FileName).ToLowerInvariant();
if (!allowedExtensions.Contains(extension))
{
ModelState.AddModelError("", "Invalid file type");
return View();
}
if (barcodeFile != null && barcodeFile.Length > 0)
{
using var stream = new MemoryStream();
await barcodeFile.CopyToAsync(stream);
stream.Position = 0;
var options = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Balanced,
ExpectMultipleBarcodes = true,
ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional |
BarcodeEncoding.QRCode |
BarcodeEncoding.DataMatrix,
ImageFilters = new ImageFilterCollection
{
new SharpenFilter(),
new ContrastFilter()
}
};
var results = BarcodeReader.Read(stream, options);
ViewBag.BarcodeResult = results.Any()
? string.Join("<br/>", results.Select(r => $"<strong>{r.BarcodeType}:</strong> {r.Text}"))
: "No barcodes found in the image.";
}
return View();
}Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.AspNetCore.Http
Imports System.IO
Imports System.Threading.Tasks
Imports ZXing
<HttpPost>
<ValidateAntiForgeryToken>
<RequestSizeLimit(10_000_000)> ' 10MB limit
Public Async Function ScanBarcode(barcodeFile As IFormFile) As Task(Of IActionResult)
Dim allowedExtensions As String() = {".jpg", ".jpeg", ".png", ".gif", ".tiff", ".bmp", ".pdf"}
Dim extension As String = Path.GetExtension(barcodeFile.FileName).ToLowerInvariant()
If Not allowedExtensions.Contains(extension) Then
ModelState.AddModelError("", "Invalid file type")
Return View()
End If
If barcodeFile IsNot Nothing AndAlso barcodeFile.Length > 0 Then
Using stream As New MemoryStream()
Await barcodeFile.CopyToAsync(stream)
stream.Position = 0
Dim options As New BarcodeReaderOptions With {
.Speed = ReadingSpeed.Balanced,
.ExpectMultipleBarcodes = True,
.ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional Or
BarcodeEncoding.QRCode Or
BarcodeEncoding.DataMatrix,
.ImageFilters = New ImageFilterCollection From {
New SharpenFilter(),
New ContrastFilter()
}
}
Dim results = BarcodeReader.Read(stream, options)
ViewBag.BarcodeResult = If(results.Any(),
String.Join("<br/>", results.Select(Function(r) $"<strong>{r.BarcodeType}:</strong> {r.Text}")),
"No barcodes found in the image.")
End Using
End If
Return View()
End FunctionEsta implementación valida el tipo de archivo antes de procesarlo, lee códigos de barras de un flujo de memoria y devuelve todos los resultados detectados. IronBarcode procesa varios formatos de imagen , incluidos documentos TIFF, GIF y PDF de varias páginas, eliminando el código de manejo específico del formato.
El ejemplo anterior muestra un código de barras Código 128 estándar, un formato común en aplicaciones de envío e inventario. Después del escaneo, la pantalla de resultados confirma el valor decodificado junto con los metadatos de confianza:
IronBarcode devuelve el tipo de código de barras, el valor decodificado, la puntuación de confianza y los datos de posición de cada código de barras detectado en la imagen cargada.
Las aplicaciones ASP.NET modernas a menudo exponen capacidades de escaneo de códigos de barras a través de API REST, lo que permite la integración con aplicaciones móviles, aplicaciones de una sola página o servicios de terceros. Este patrón admite la captura de cámara del lado del cliente con procesamiento del lado del servidor.
Antes de escribir el controlador, planifique la capa de seguridad. Los datos del código de barras pueden contener contenido arbitrario, por lo que siempre debe validar las entradas. Siga las pautas de seguridad de IronBarcode para una protección completa:
[ApiController]
[Route("api/[controller]")]
public class BarcodeController : ControllerBase
{
private readonly ILogger<BarcodeController> _logger;
private readonly IMemoryCache _cache;
public BarcodeController(ILogger<BarcodeController> logger, IMemoryCache cache)
{
_logger = logger;
_cache = cache;
}
[HttpPost("scan")]
[ProducesResponseType(typeof(BarcodeResponse), 200)]
[ProducesResponseType(typeof(ErrorResponse), 400)]
public async Task<IActionResult> ScanBarcode([FromBody] BarcodeRequest request)
{
try
{
if (string.IsNullOrEmpty(request.ImageBase64))
return BadRequest(new ErrorResponse { Error = "Image data is required" });
var cacheKey = $"barcode_{request.ImageBase64.GetHashCode()}";
if (_cache.TryGetValue(cacheKey, out BarcodeResponse cachedResult))
return Ok(cachedResult);
byte[] imageBytes = Convert.FromBase64String(request.ImageBase64);
if (imageBytes.Length > 10 * 1024 * 1024)
return BadRequest(new ErrorResponse { Error = "Image size exceeds 10MB limit" });
var options = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Faster,
ExpectMultipleBarcodes = request.ExpectMultiple ?? false,
UseConfidenceThreshold = true,
ConfidenceThreshold = 0.8
};
var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));
var response = new BarcodeResponse
{
Success = true,
Barcodes = results.Select(r => new BarcodeData
{
Type = r.BarcodeType.ToString(),
Value = r.Text,
Confidence = r.Confidence,
Position = new BarcodePosition
{
X = r.Points.Select(p => p.X).Min(),
Y = r.Points.Select(p => p.Y).Min(),
Width = r.Width,
Height = r.Height
}
}).ToList()
};
_cache.Set(cacheKey, response, TimeSpan.FromMinutes(5));
return Ok(response);
}
catch (FormatException)
{
return BadRequest(new ErrorResponse { Error = "Invalid base64 image data" });
}
catch (Exception ex)
{
_logger.LogError(ex, "Error processing barcode scan");
return StatusCode(500, new ErrorResponse { Error = "Internal server error" });
}
}
}
public record BarcodeRequest(string ImageBase64, bool? ExpectMultiple);
public record BarcodeResponse
{
public bool Success { get; init; }
public List<BarcodeData> Barcodes { get; init; } = new();
}
public record BarcodeData
{
public string Type { get; init; }
public string Value { get; init; }
public double Confidence { get; init; }
public BarcodePosition Position { get; init; }
}
public record BarcodePosition(int X, int Y, int Width, int Height);
public record ErrorResponse
{
public bool Success => false;
public string Error { get; init; }
}Imports System
Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.Extensions.Logging
Imports Microsoft.Extensions.Caching.Memory
Imports System.Threading.Tasks
<ApiController>
<Route("api/[controller]")>
Public Class BarcodeController
Inherits ControllerBase
Private ReadOnly _logger As ILogger(Of BarcodeController)
Private ReadOnly _cache As IMemoryCache
Public Sub New(logger As ILogger(Of BarcodeController), cache As IMemoryCache)
_logger = logger
_cache = cache
End Sub
<HttpPost("scan")>
<ProducesResponseType(GetType(BarcodeResponse), 200)>
<ProducesResponseType(GetType(ErrorResponse), 400)>
Public Async Function ScanBarcode(<FromBody> request As BarcodeRequest) As Task(Of IActionResult)
Try
If String.IsNullOrEmpty(request.ImageBase64) Then
Return BadRequest(New ErrorResponse With {.Error = "Image data is required"})
End If
Dim cacheKey = $"barcode_{request.ImageBase64.GetHashCode()}"
Dim cachedResult As BarcodeResponse = Nothing
If _cache.TryGetValue(cacheKey, cachedResult) Then
Return Ok(cachedResult)
End If
Dim imageBytes As Byte() = Convert.FromBase64String(request.ImageBase64)
If imageBytes.Length > 10 * 1024 * 1024 Then
Return BadRequest(New ErrorResponse With {.Error = "Image size exceeds 10MB limit"})
End If
Dim options = New BarcodeReaderOptions With {
.Speed = ReadingSpeed.Faster,
.ExpectMultipleBarcodes = request.ExpectMultiple.GetValueOrDefault(False),
.UseConfidenceThreshold = True,
.ConfidenceThreshold = 0.8
}
Dim results = Await Task.Run(Function() BarcodeReader.Read(imageBytes, options))
Dim response = New BarcodeResponse With {
.Success = True,
.Barcodes = results.Select(Function(r) New BarcodeData With {
.Type = r.BarcodeType.ToString(),
.Value = r.Text,
.Confidence = r.Confidence,
.Position = New BarcodePosition With {
.X = r.Points.Select(Function(p) p.X).Min(),
.Y = r.Points.Select(Function(p) p.Y).Min(),
.Width = r.Width,
.Height = r.Height
}
}).ToList()
}
_cache.Set(cacheKey, response, TimeSpan.FromMinutes(5))
Return Ok(response)
Catch ex As FormatException
Return BadRequest(New ErrorResponse With {.Error = "Invalid base64 image data"})
Catch ex As Exception
_logger.LogError(ex, "Error processing barcode scan")
Return StatusCode(500, New ErrorResponse With {.Error = "Internal server error"})
End Try
End Function
End Class
Public Class BarcodeRequest
Public Property ImageBase64 As String
Public Property ExpectMultiple As Boolean?
End Class
Public Class BarcodeResponse
Public Property Success As Boolean
Public Property Barcodes As List(Of BarcodeData) = New List(Of BarcodeData)()
End Class
Public Class BarcodeData
Public Property Type As String
Public Property Value As String
Public Property Confidence As Double
Public Property Position As BarcodePosition
End Class
Public Class BarcodePosition
Public Property X As Integer
Public Property Y As Integer
Public Property Width As Integer
Public Property Height As Integer
End Class
Public Class ErrorResponse
Public ReadOnly Property Success As Boolean
Get
Return False
End Get
End Property
Public Property Error As String
End ClassEste punto final acepta imágenes codificadas en base64, el formato estándar para transmitir imágenes por HTTP. La respuesta incluye el tipo de código de barras, el valor decodificado, el nivel de confianza y la posición. Para escenarios de gran volumen, revise las opciones de optimización de la velocidad de lectura y procesamiento de códigos de barras por lotes .
IronBarcode procesa múltiples códigos de barras en una sola imagen en una sola llamada y devuelve una matriz de resultados. Cada entrada en la respuesta incluye datos de posición para que la aplicación cliente pueda resaltar los códigos de barras detectados en la pantalla.
La respuesta JSON estructurada proporciona a las aplicaciones cliente todo lo que necesitan para procesar y mostrar resultados de códigos de barras sin búsquedas adicionales.
El escaneo de códigos de barras en el mundo real frecuentemente involucra imágenes imperfectas: fotos tomadas en ángulos, con poca iluminación o códigos de barras parcialmente dañados. IronBarcode aborda estos escenarios a través de sus capacidades avanzadas de procesamiento de imágenes y umbrales de confianza de aprendizaje automático .
Antes de aplicar correcciones, identifique en qué categoría se encuentra su problema. La mayoría de las fallas de escaneo en producción se dividen en cinco grupos: problemas de calidad de imagen (borrosidad, ruido, baja resolución), problemas geométricos (rotación, inclinación, distorsión de la perspectiva), problemas de daños (etiquetas rotas, tinta manchada), problemas ambientales (resplandor, sombras, iluminación inconsistente) y detección de falsos positivos donde el lector encuentra un código de barras que no existe.
Conocer la categoría le ayudará a seleccionar la combinación de filtros y la velocidad de lectura adecuadas sin ejecutar un procesamiento innecesario en cada imagen. Para la mayoría de los escenarios de aplicaciones web, comenzar con ReadingSpeed.Balanced y AutoRotate = true cubre la mayoría de los casos. Solo escalar a ExtremeDetail cuando la primera pasada no devuelve resultados.
El enfoque de múltiples pasadas en el código siguiente implementa esta estrategia escalonada. El primer paso rápido maneja imágenes típicas rápidamente, manteniendo la latencia media baja para el caso común. El segundo pase detallado solo se activa cuando falla el primer pase, lo que garantiza que usted pague el costo de procesamiento adicional solo cuando realmente sea necesario. Este patrón mantiene su punto final ASP.NET receptivo bajo carga normal y al mismo tiempo maneja casos extremos difíciles de manera confiable.
| Problema | Síntoma | Solución |
|---|---|---|
| Imagen borrosa | Puntuaciones de confianza bajas, lecturas fallidas | Aplicar SharpenFilter , aumentar la velocidad ExtremeDetail |
| Código de barras rotado | Código de barras no detectado en absoluto | Habilitar AutoRotate = true |
| Código de barras dañado | Lecturas parciales, valores incorrectos | Habilitar la corrección de errores, utilizar RemoveFalsePositive |
| Contraste pobre | Detección inconsistente | Aplicar ContrastFilter y BrightnessFilter |
| El rendimiento es demasiado lento | Alta latencia en las cargas | Utilice ReadingSpeed.Faster y habilite el multihilo |
Para imágenes desafiantes, un enfoque de procesamiento por niveles produce los mejores resultados sin sacrificar el rendimiento en imágenes fáciles:
public class AdvancedBarcodeProcessor
{
private readonly ILogger<AdvancedBarcodeProcessor> _logger;
public async Task<List<ScannedBarcode>> ProcessChallengingImage(Stream imageStream)
{
// First pass -- fast, minimal processing
var fastOptions = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Balanced,
ExpectMultipleBarcodes = true,
AutoRotate = false,
UseConfidenceThreshold = true,
ConfidenceThreshold = 0.85
};
var results = BarcodeReader.Read(imageStream, fastOptions);
if (!results.Any())
{
// Second pass -- aggressive image correction
imageStream.Position = 0;
var detailedOptions = new BarcodeReaderOptions
{
Speed = ReadingSpeed.ExtremeDetail,
ExpectMultipleBarcodes = true,
AutoRotate = true,
RemoveFalsePositive = true,
UseConfidenceThreshold = true,
ConfidenceThreshold = 0.6,
Multithreaded = true,
ExpectBarcodeTypes = BarcodeEncoding.All,
ImageFilters = new ImageFilterCollection
{
new SharpenFilter(2.5f),
new ContrastFilter(2.0f),
new BrightnessFilter(1.2f),
new InvertFilter()
}
};
results = BarcodeReader.Read(imageStream, detailedOptions);
_logger.LogInformation("Second pass detected {Count} barcodes", results.Count());
}
return results.Select(r => new ScannedBarcode
{
Value = r.Text,
BarcodeType = r.BarcodeType.ToString(),
Confidence = r.Confidence,
RotationAngle = r.RotationAngle,
PageNumber = r.PageNumber
}).ToList();
}
}
public record ScannedBarcode
{
public string Value { get; init; }
public string BarcodeType { get; init; }
public double Confidence { get; init; }
public float RotationAngle { get; init; }
public int PageNumber { get; init; }
}Imports System.IO
Imports System.Collections.Generic
Imports System.Linq
Imports System.Threading.Tasks
Public Class AdvancedBarcodeProcessor
Private ReadOnly _logger As ILogger(Of AdvancedBarcodeProcessor)
Public Async Function ProcessChallengingImage(imageStream As Stream) As Task(Of List(Of ScannedBarcode))
' First pass -- fast, minimal processing
Dim fastOptions As New BarcodeReaderOptions With {
.Speed = ReadingSpeed.Balanced,
.ExpectMultipleBarcodes = True,
.AutoRotate = False,
.UseConfidenceThreshold = True,
.ConfidenceThreshold = 0.85
}
Dim results = BarcodeReader.Read(imageStream, fastOptions)
If Not results.Any() Then
' Second pass -- aggressive image correction
imageStream.Position = 0
Dim detailedOptions As New BarcodeReaderOptions With {
.Speed = ReadingSpeed.ExtremeDetail,
.ExpectMultipleBarcodes = True,
.AutoRotate = True,
.RemoveFalsePositive = True,
.UseConfidenceThreshold = True,
.ConfidenceThreshold = 0.6,
.Multithreaded = True,
.ExpectBarcodeTypes = BarcodeEncoding.All,
.ImageFilters = New ImageFilterCollection From {
New SharpenFilter(2.5F),
New ContrastFilter(2.0F),
New BrightnessFilter(1.2F),
New InvertFilter()
}
}
results = BarcodeReader.Read(imageStream, detailedOptions)
_logger.LogInformation("Second pass detected {Count} barcodes", results.Count())
End If
Return results.Select(Function(r) New ScannedBarcode With {
.Value = r.Text,
.BarcodeType = r.BarcodeType.ToString(),
.Confidence = r.Confidence,
.RotationAngle = r.RotationAngle,
.PageNumber = r.PageNumber
}).ToList()
End Function
End Class
Public Class ScannedBarcode
Public Property Value As String
Public Property BarcodeType As String
Public Property Confidence As Double
Public Property RotationAngle As Single
Public Property PageNumber As Integer
End ClassLa clase BarcodeReaderOptions proporciona un control detallado sobre cada aspecto del escaneo. Configurando AutoRotate se manejan imágenes capturadas en cualquier ángulo, mientras que los filtros de imagen mejoran la claridad para códigos de barras borrosos o con bajo contraste. Para obtener una configuración detallada, consulte el ejemplo de configuración del lector de código de barras y la configuración del lector específico de PDF .
Al trabajar con archivos PDF, considere estampar códigos de barras en ellos o crear códigos de barras como documentos PDF . Para el procesamiento de gran volumen, habilitar subprocesos múltiples a través de las capacidades asíncronas y multiproceso mejora significativamente el rendimiento.
La compatibilidad con diversos navegadores requiere una mejora progresiva. Los navegadores modernos en Android y Chrome de escritorio, Edge y Firefox soportan la API MediaDevices.getUserMedia() para acceso a la cámara. Safari en iOS lo admite desde la versión 11 en adelante. Es posible que los navegadores empresariales más antiguos, los modos de compatibilidad con IE11 y ciertos entornos corporativos bloqueados no admitan el acceso a la cámara, por lo que su ruta de carga de archivos alternativa siempre debe permanecer funcional.
El enfoque recomendado es utilizar la detección de características en tiempo de ejecución en lugar de rastrear el agente de usuario y luego mostrar u ocultar la interfaz de la cámara según corresponda. Comience con una interfaz compatible con cámara y luego vuelva con elegancia a la carga de archivos:
@* Razor view with progressive enhancement *@
<div class="barcode-scanner-container">
@* Camera capture -- hidden until JavaScript confirms support *@
<div id="cameraSection" class="d-none">
<video id="videoPreview" class="w-100" autoplay></video>
<button id="captureBtn" class="btn btn-primary mt-2">Capture and Scan</button>
</div>
@* File upload -- always available as fallback *@
<div id="uploadSection">
<form method="post" enctype="multipart/form-data"
asp-action="ScanBarcode" asp-controller="Barcode">
<div class="form-group">
<label>Upload Barcode Image:</label>
<input type="file" name="file" accept="image/*,.pdf"
class="form-control" required />
</div>
<button type="submit" class="btn btn-primary">Upload and Scan</button>
</form>
</div>
</div>@* Razor view with progressive enhancement *@
<div class="barcode-scanner-container">
@* Camera capture -- hidden until JavaScript confirms support *@
<div id="cameraSection" class="d-none">
<video id="videoPreview" class="w-100" autoplay></video>
<button id="captureBtn" class="btn btn-primary mt-2">Capture and Scan</button>
</div>
@* File upload -- always available as fallback *@
<div id="uploadSection">
<form method="post" enctype="multipart/form-data"
asp-action="ScanBarcode" asp-controller="Barcode">
<div class="form-group">
<label>Upload Barcode Image:</label>
<input type="file" name="file" accept="image/*,.pdf"
class="form-control" required />
</div>
<button type="submit" class="btn btn-primary">Upload and Scan</button>
</form>
</div>
</div>La integración de Blazor proporciona soporte para aplicaciones web modernas con una configuración mínima si prefiere un enfoque basado en componentes. Para solucionar problemas de implementación, consulte la guía de excepciones de copia de tiempos de ejecución .
El escaneo de códigos de barras en ASP.NET es sencillo con IronBarcode. Instalas un paquete NuGet, llamas a BarcodeReader.Read(), y obtienes resultados decodificados fiables en más de 30 formatos, incluyendo imágenes del mundo real desafiantes con las que otras bibliotecas tienen dificultades.
Para seguir construyendo sobre esta base, explore estos recursos:
Comience con una licencia de prueba gratuita para probar IronBarcode en su aplicación ASP.NET sin restricciones. La prueba incluye acceso completo a todas las funciones, incluidas la detección de múltiples formatos, la corrección de imágenes y los patrones de API REST que se muestran en esta guía, para que pueda evaluar el rendimiento de sus propias imágenes antes de comprometerse con una licencia de producción. Para las aplicaciones móviles .NET MAUI que necesitan escaneo en el dispositivo, consulte el tutorial del escáner de código de barras .NET MAUI que extiende la misma API a los destinos iOS y Android.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
IronBarcode es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesite leer, escribir y diseñar Códigos de Barras, rápido.
