How to Export Barcodes as Streams in C#

Exemplo de Exportação de Código de Barras como Stream

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-as-stream-to-stream.cs

using IronBarCode;
using System.IO;

// Create one-dimensional barcode
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("IronBarcode1234", BarcodeEncoding.Code128);

// Convert barcode to stream
Stream barcodeStream = barcode.ToStream();

// Create QR code
GeneratedBarcode qrCode = QRCodeWriter.CreateQrCode("IronBarcode1234");

// Convert QR code to stream
Stream qrCodeStream = qrCode.ToStream();

Por Que Usar Streams em Vez de Arquivos?

Usar streams elimina dependências do sistema de arquivos e oferece processamento em memória para melhor desempenho. Essa abordagem é ideal para aplicações web, APIs e cenários onde a criação de arquivos temporários é restrita ou indesejável. O processamento baseado em stream oferece várias vantagens:

• Segurança Aprimorada: Sem arquivos temporários no disco que poderiam expor dados sensíveis
• Melhor Desempenho: Operações de memória direta são mais rápidas que I/O de disco
• Compatibilidade com Nuvem: Funciona perfeitamente em ambientes containerizados e sem servidor
• Eficiência de Recursos: Reduz uso de espaço em disco e sobrecarga do sistema de arquivos

Quando Devo Usar MemoryStream para Códigos de Barras?

Use MemoryStream quando precisar processar códigos de barras na memória, enviá-los diretamente para respostas HTTP ou integrá-los com outras APIs baseadas em fluxo sem criar arquivos temporários. Os cenários comuns incluem:

• Respostas de API Web: Retornar códigos de barras diretamente em respostas HTTP sem salvar em disco
• Armazenamento em Banco de Dados: Armazenar dados de códigos de barras como blobs binários em bancos de dados
• Anexos de Email: Gerar e anexar códigos de barras a emails de forma instantânea
• Armazenamento em Nuvem: Carregue diretamente para Azure Blob Storage, AWS S3 ou serviços similares
• Processamento em Tempo Real: Gera códigos de barras para consumo imediato sem persistência

Exportar Código de Barras como Fluxo em Vários Formatos de Imagem

Use os métodos ToJpegStream e ToStream para gerar fluxos no formato de imagem JPEG:

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-as-stream-to-jpeg-stream.cs

using IronBarCode;
using IronSoftware.Drawing;
using System.IO;

// Create one-dimensional barcode
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("IronBarcode1234", BarcodeEncoding.Code128);

// Convert barcode to JPEG stream
Stream barcodeStream = barcode.ToStream(AnyBitmap.ImageFormat.Jpeg);

// Create QR code
GeneratedBarcode qrCode = QRCodeWriter.CreateQrCode("IronBarcode1234");

// Convert QR code to JPEG stream
Stream qrCodeStream = qrCode.ToJpegStream();

Exemplos Avançados de Exportação de Fluxo

Este exemplo abrangente demonstra como criar códigos de barras a partir de vários tipos de dados e exportá-los como fluxos em diferentes formatos:

using IronBarCode;
using IronSoftware.Drawing;
using System.IO;
using System.Drawing.Imaging;

public class BarcodeStreamExporter
{
    public static void ExportMultipleFormats()
    {
        // Generate barcode with custom data
        var myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-2024-001", BarcodeEncoding.Code128);

        // Apply styling
        myBarcode.ResizeTo(300, 150);
        myBarcode.SetMargins(10);
        myBarcode.AddAnnotationTextAboveBarcode("Product ID");

        // Export to different stream formats
        Stream pngStream = myBarcode.ToPngStream();
        Stream jpegStream = myBarcode.ToJpegStream();
        Stream pdfStream = myBarcode.ToPdfStream();
        Stream tiffStream = myBarcode.ToTiffStream();

        // Use with HTTP response (ASP.NET Core example)
        // return File(pngStream, "image/png", "barcode.png");
    }

    public static byte[] GenerateQRCodeBytes(string data)
    {
        // Create QR code with error correction
        var qrCode = QRCodeWriter.CreateQrCodeWithLogo(data, "logo.png", 500);

        // Convert to byte array via stream
        using (var stream = qrCode.ToStream())
        {
            using (var memoryStream = new MemoryStream())
            {
                stream.CopyTo(memoryStream);
                return memoryStream.ToArray();
            }
        }
    }
}

using IronBarCode;
using IronSoftware.Drawing;
using System.IO;
using System.Drawing.Imaging;

public class BarcodeStreamExporter
{
    public static void ExportMultipleFormats()
    {
        // Generate barcode with custom data
        var myBarcode = BarcodeWriter.CreateBarcode("PRODUCT-2024-001", BarcodeEncoding.Code128);

        // Apply styling
        myBarcode.ResizeTo(300, 150);
        myBarcode.SetMargins(10);
        myBarcode.AddAnnotationTextAboveBarcode("Product ID");

        // Export to different stream formats
        Stream pngStream = myBarcode.ToPngStream();
        Stream jpegStream = myBarcode.ToJpegStream();
        Stream pdfStream = myBarcode.ToPdfStream();
        Stream tiffStream = myBarcode.ToTiffStream();

        // Use with HTTP response (ASP.NET Core example)
        // return File(pngStream, "image/png", "barcode.png");
    }

    public static byte[] GenerateQRCodeBytes(string data)
    {
        // Create QR code with error correction
        var qrCode = QRCodeWriter.CreateQrCodeWithLogo(data, "logo.png", 500);

        // Convert to byte array via stream
        using (var stream = qrCode.ToStream())
        {
            using (var memoryStream = new MemoryStream())
            {
                stream.CopyTo(memoryStream);
                return memoryStream.ToArray();
            }
        }
    }
}

Como Escolher o Formato Certo?

Selecione o formato apropriado com base em suas necessidades:

• PNG: Melhor para uso na web, suporta transparência, compressão sem perda
• JPEG: Tamanhos de arquivo menores, ideal quando a transparência não é necessária
• PDF: Perfeito para integração de documentos, relatórios e formatos imprimíveis
• TIFF: Propósitos de arquivamento de alta qualidade, suporte a várias páginas
• GIF: Paleta de cores limitada, adequado para códigos de barras simples com animação

Quais São os Cenários Comuns de Processamento de Fluxo?

O processamento de código de barras baseado em fluxo possibilita inúmeras aplicações práticas:

1. Resposta HTTP Direta: Serve códigos de barras para clientes web sem armazenamento intermediário
2. Armazenamento Binário em Banco de Dados: Armazene dados de código de barras como campos BLOB
3. Cache Baseado em Memória: Cache de códigos de barras gerados para cenários de alto desempenho
4. Encadeamento de Fluxos: Processa códigos de barras através de pipelines de transformação
5. Processamento em Lote: Gera milhares de códigos de barras sem I/O de disco

Trabalhando com Dados de Fluxo

Ao trabalhar com fluxos, você pode precisar ler códigos de barras de fluxos. Aqui está um exemplo de processamento de ida e volta:

using IronBarCode;
using System.IO;
using System.Collections.Generic;

public class StreamRoundTrip
{
    public static void ProcessBarcodeStream()
    {
        // Generate barcode and get stream
        var originalBarcode = BarcodeWriter.CreateBarcode("STREAM-TEST-123", BarcodeEncoding.Code128);
        Stream barcodeStream = originalBarcode.ToStream();

        // Read barcode back from stream
        var results = BarcodeReader.Read(barcodeStream);

        foreach (var result in results)
        {
            Console.WriteLine($"Value: {result.Value}");
            Console.WriteLine($"Format: {result.BarcodeType}");
        }

        // Don't forget to dispose of the stream
        barcodeStream.Dispose();
    }
}

using IronBarCode;
using System.IO;
using System.Collections.Generic;

public class StreamRoundTrip
{
    public static void ProcessBarcodeStream()
    {
        // Generate barcode and get stream
        var originalBarcode = BarcodeWriter.CreateBarcode("STREAM-TEST-123", BarcodeEncoding.Code128);
        Stream barcodeStream = originalBarcode.ToStream();

        // Read barcode back from stream
        var results = BarcodeReader.Read(barcodeStream);

        foreach (var result in results)
        {
            Console.WriteLine($"Value: {result.Value}");
            Console.WriteLine($"Format: {result.BarcodeType}");
        }

        // Don't forget to dispose of the stream
        barcodeStream.Dispose();
    }
}

Considerações sobre o desempenho

Ao exportar códigos de barras como fluxos, considere estas dicas de desempenho:

• Reutilizar Fluxos: Use MemoryStream com capacidade inicial para melhor desempenho
• Operações Assíncronas: Use métodos assíncronos ao lidar com grandes volumes
• Pooling de Fluxos: Implemente pooling de fluxos para operações de alta frequência
• Seleção de Formato: Escolha os formatos sabiamente—PNG geralmente é mais rápido que PDF