A digitalização de código de barras no ASP.NET torna-se simples com IronBarcode: instale via NuGet, chame BarcodeReader.Read(), e obtenha valores decodificados com dados de tipo, confiança e posição em um único passo -- sem necessidade de configuração complexa.
A digitalização de código de barras é uma exigência padrão nas aplicações web modernas, alimentando fluxos de trabalho de gestão de inventário, processamento de documentos e validação de tickets. De acordo com a GS1, os códigos de barras são usados em mais de 6 bilhões de transações diárias em todo o mundo -- um número que destaca a importância da leitura precisa de códigos de barras para qualquer sistema de negócios. O padrão ISO/IEC 15415 define métricas de qualidade para símbolos de código de barras 2D, enquanto o padrão ISO/IEC 15416 abrange códigos de barras lineares 1D, ambos os quais IronBarcode suporta nativamente.
Este guia mostra como adicionar digitalização confiável de códigos de barras à sua aplicação ASP.NET Core usando IronBarcode, abrangendo instalação, processamento de upload de arquivos, integração de API REST e padrões de implantação em produção. Até o final, você terá um código funcional para um scanner de upload de arquivos de página Razor e um endpoint de API JSON que aceita imagens codificadas em base64 de qualquer cliente.
Começar leva apenas alguns minutos. A biblioteca suporta tanto ASP.NET Core quanto aplicações tradicionais ASP.NET MVC, tornando-a adaptável para vários tipos de projetos. Implantações empresariais funcionam igualmente bem em Azure, AWS Lambda e contêineres Docker. A detecção alimentada por aprendizado de máquina da biblioteca lida com imagens de código de barras desafiadoras aplicando correção sofisticada de imagem automaticamente, o que é particularmente útil ao processar fotos tiradas com câmeras móveis em condições de iluminação variável.
Abra o Console do Gerenciador de Pacotes no Visual Studio e execute:
Alternativamente, use o .NET CLI:
Ou procure por "BarCode" na interface do gerenciador de pacotes NuGet do Visual Studio e clique em Instalar. O pacote gerencia automaticamente todas as dependências.
Para implantações específicas de plataforma, considere usar pacotes NuGet específicos da plataforma que são otimizados para seu ambiente de destino. A biblioteca oferece pacotes padrão e pacotes BarCode.Slim para se adequar a diferentes cenários de implantação. Para o guia completo de instalação, veja o guia de instalação do IronBarcode.
Uma vez instalado, adicione a declaração 'using' necessária aos seus arquivos C#:
using IronBarCode;Imports IronBarCodeEsta importação dá-lhe acesso à completa leitura e geração de códigos de barras do IronBarcode. A biblioteca suporta mais de 30 formatos de código de barras, incluindo QR Code, Code 128, Code 39, Data Matrix e PDF417. Veja a lista completa de formatos de código de barras suportados para confirmar a compatibilidade com seu caso de uso.
Para solucionar problemas de instalação, consulte o guia de solução de problemas de pacotes NuGet ou envie uma solicitação de engenharia para suporte especializado.
Ao implementar a digitalização de código de barras em ASP.NET, você tem duas abordagens arquitetônicas principais. Compreender esses padrões ajuda você a escolher as configurações do leitor de código de barras corretas 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}")
NextA abordagem do lado do servidor dá a você controle máximo sobre o processamento de imagens e funciona de forma consistente em todos os navegadores. Quando o servidor processa cada imagem, você também obtém um rastro de auditoria limpo: cada código de barras digitalizado passa por sua camada de aplicação onde você pode registrá-lo, validá-lo em relação a um banco de dados ou acionar fluxos de trabalho a jusante. Este padrão é particularmente adequado para indústrias regulamentadas, como saúde, logística e manufatura, onde cada digitalização deve ser registrada.
Para integração de captura de câmera no lado do cliente, navegadores modernos suportam a API MediaDevices para acesso à câmera, que pode ser combinada com o processamento no lado do servidor do IronBarcode através de uma API REST -- coberto em detalhes mais adiante neste guia. Escolher o processamento no lado do servidor também simplifica seu modelo de segurança: não há lógica sensível de processamento exposta ao navegador, e toda a validação acontece dentro dos limites da sua aplicação.
| Aspecto | Captura do Lado do Cliente + Processamento do Servidor | Processamento Puramente no Servidor |
|---|---|---|
| Ideal para | Digitalização em tempo real com câmera | Processamento em lote, uploads de arquivos |
| Suporte do navegador | Apenas navegadores modernos | Todos os navegadores |
| Experiência do usuário | Feedback instantâneo | Fluxo padrão de upload |
| Modelo de segurança | Mais complexo (CORS, auth) | Simples |
| Uso de largura de banda | Baixa (pré-processada no dispositivo) | Alta (upload de imagem bruta) |
A digitalização de upload de arquivo é o cenário de código de barras mais comum em aplicações web ASP.NET. Esse padrão funciona para processar faturas, etiquetas de envio ou qualquer documento com códigos de barras incorporados. Para melhorar a taxa de transferência, considere implementar leitura de código de barras assíncrona para lidar com múltiplos uploads simultaneamente.
Crie um formulário HTML responsivo em sua view 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>O atributo capture="environment" ativa a câmera traseira em dispositivos móveis, proporcionando aos usuários uma experiência similar a uma câmera nativa, sem JavaScript.
A ação do controlador lida com a validação de arquivos, o processamento do fluxo de memória e a formatação 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 FunctionEssa implementação valida o tipo de arquivo antes do processamento, lê códigos de barras de um fluxo de memória e retorna todos os resultados detectados. IronBarcode processa vários formatos de imagem, incluindo TIFF e GIF de múltiplas páginas e documentos PDF, eliminando código específico de manipulação de formato.
O exemplo acima mostra um padrão Code 128 -- um formato comum em aplicações de envio e inventário. Após a digitalização, a tela de resultado confirma o valor decodificado junto com metadados de confiança:
IronBarcode retorna o tipo de código de barras, valor decodificado, pontuação de confiança e dados de posição para cada código de barras detectado na imagem carregada.
Aplicações ASP.NET modernas frequentemente expõem capacidades de leitura de códigos de barras através de APIs REST, permitindo integração com aplicativos móveis, aplicações de página única ou serviços de terceiros. Esse padrão suporta captura de câmera do lado do cliente com processamento do lado do servidor.
Antes de escrever o controlador, planeje a camada de segurança. Os dados do código de barras podem conter conteúdo arbitrário, então sempre valide as entradas. Siga as diretrizes de segurança do IronBarcode para proteção 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 ClassEsse endpoint aceita imagens codificadas em base64 -- o formato padrão para transmissão de imagens sobre HTTP. A resposta inclui tipo de código de barras, valor decodificado, pontuação de confiança e posição. Para cenários de alto volume, revise as opções de processamento de códigos de barras em lote e otimização de velocidade de leitura.
IronBarcode processa múltiplos códigos de barras em uma única imagem em uma chamada, retornando um array de resultados. Cada entrada na resposta inclui dados de posição para que a aplicação cliente possa destacar os códigos de barras detectados na tela.
A resposta JSON estruturada fornece às aplicações clientes tudo o que é necessário para processar e exibir os resultados dos códigos de barras sem consultas adicionais.
A digitalização de códigos de barras no mundo real frequentemente envolve imagens imperfeitas -- fotos tiradas em ângulos, iluminação inadequada ou códigos de barras parcialmente danificados. IronBarcode aborda esses cenários através de suas capacidades avançadas de processamento de imagem e limiares de confiança baseados em aprendizado de máquina.
Antes de aplicar correções, identifique em qual categoria seu problema se enquadra. A maior parte das falhas de digitalização em produção se enquadra em um dos cinco grupos: problemas de qualidade de imagem (desfoque, ruído, baixa resolução), problemas geométricos (rotação, inclinação, distorção de perspectiva), problemas de dano (rótulos rasgados, tinta borrada), problemas de ambiente (reflexo, sombras, iluminação inconsistente), e detecção de falso positivo onde o leitor encontra um código de barras que não existe.
Saber a categoria ajuda a selecionar a combinação correta de filtro e velocidade de leitura sem executar processamento desnecessário em todas as imagens. Para a maioria dos cenários de aplicação web, começar com ReadingSpeed.Balanced e AutoRotate = true cobre a maioria dos casos. Apenas escale para ExtremeDetail quando a primeira tentativa não retornar resultados.
A abordagem de múltiplas passagens no código abaixo implementa essa estratégia em camadas. A rápida primeira passagem lida com imagens típicas rapidamente, mantendo a latência mediana baixa para casos comuns. A detalhada segunda passagem é acionada apenas quando a primeira tentativa falha, garantindo que você só pague o custo adicional de processamento quando realmente necessário. Esse padrão mantém seu endpoint ASP.NET responsivo sob carga normal, enquanto ainda lida com casos limítrofes difíceis de forma confiável.
| Problema | Sintoma | Solução |
|---|---|---|
| Imagem borrada | Pontuações de confiança baixas, leituras perdidas | Aplique SharpenFilter, aumente a velocidade ExtremeDetail |
| Código de barras girado | Código de barras não detectado | Habilite AutoRotate = true |
| Código de barras danificado | Leituras parciais, valores incorretos | Habilite correção de erros, use RemoveFalsePositive |
| Pouco contraste | Detecção inconsistente | Aplique ContrastFilter e BrightnessFilter |
| Desempenho muito lento | Alta latência em uploads | Use ReadingSpeed.Faster, habilite multithreading |
Para imagens desafiadoras, uma abordagem de processamento em camadas oferece os melhores resultados sem sacrificar o desempenho em imagens fáceis:
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 ClassA classe BarcodeReaderOptions fornece controle detalhado sobre todos os aspectos da digitalização. Configurar AutoRotate lida com imagens capturadas em qualquer ângulo, enquanto filtros de imagem melhoram a clareza para códigos de barras borrados ou com baixo contraste. Para configuração detalhada, consulte o exemplo de configurações do leitor de código de barras e configurações específicas para PDF.
Ao trabalhar com PDFs, considere carimbar códigos de barras em PDFs ou criar códigos de barras como documentos PDF. Para processamento em alto volume, habilitar multithreading através das capacidades assíncronas e multithread melhora significativamente a taxa de transferência.
Suportar navegadores diversos requer aprimoramento progressivo. Navegadores modernos em Android e desktop Chrome, Edge e Firefox suportam a API MediaDevices.getUserMedia() para acesso à câmera. Safari no iOS o suporta a partir da versão 11. Navegadores empresariais antigos, modos de compatibilidade do IE11 e certos ambientes corporativos protegidos podem não suportar acesso à câmera de forma alguma, então seu caminho de recuperação de upload de arquivos deve sempre permanecer funcional.
A abordagem recomendada é usar detecção de recursos em tempo de execução em vez de análise de user-agent, e então mostrar ou esconder a interface da câmera conforme apropriado. Comece com uma interface compatível com câmera e recorra graciosamente ao upload de arquivos:
@* 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>A integração Blazor fornece suporte para aplicativos web modernos com configuração mínima se você preferir uma abordagem baseada em componentes. Para resolução de problemas de implantação, consulte o guia de exceção de cópia de runtimes.
A digitalização de códigos de barras no ASP.NET é simples com o IronBarcode. Você instala um pacote NuGet, chama BarcodeReader.Read(), e obtém resultados decodificados confiáveis em mais de 30 formatos -- incluindo imagens desafiadoras do mundo real que outras bibliotecas têm dificuldade em lidar.
Para continuar construindo com base nesta fundação, explore estes recursos:
Comece com uma licença de teste gratuita para testar o IronBarcode em sua aplicação ASP.NET sem restrições. O teste inclui acesso total a todos os recursos, incluindo detecção de formato múltiplo, correção de imagem e os padrões de API REST mostrados neste guia -- para que você possa avaliar o desempenho em suas próprias imagens antes de se comprometer com uma licença de produção. Para aplicativos móveis .NET MAUI que precisam de escaneamento no dispositivo, veja o tutorial do leitor de código de barras .NET MAUI que estende a mesma API para alvos iOS e Android.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronBarcode faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa ler, escrever e formatar códigos de barras rapidamente.
