Class BarcodeGenerator
Namespace: Aspose.BarCode.Generation
Assembly: Aspose.BarCode.dll (25.1.0)
BarcodeGenerator para geração de imagens de código de barras no backend.
simbologias suportadas: 1D: Codabar, Code11, Code128, Code39, Code39FullASCII Code93, EAN13, EAN8, Interleaved2of5, MSI, Standard2of5, UPCA, UPCE, ISBN, GS1Code128, Postnet, Planet EAN14, SCC14, SSCC18, ITF14, SingaporePost ... 2D: Aztec, DataMatrix, PDf417, código QR ...
[XmlSerialization(Name = "Aspose.BarCode.Generator")]
public sealed class BarcodeGenerator : IDisposable
Herança
Implementa
Membros Herdados
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Exemplos
Este exemplo mostra como criar e salvar uma imagem de código de barras.
using(var generator = new BarcodeGenerator(EncodeTypes.Code128))
{
generator.CodeText = "123ABC";
generator.Save("code128.png");
}
Construtores
BarcodeGenerator(BaseEncodeType)
Cria uma instância de BarcodeGenerator.
public BarcodeGenerator(BaseEncodeType type)
Parâmetros
type
BaseEncodeType
Tipo de simbologia do código de barras. Use a classe Aspose.BarCode.Generation.EncodeTypes para configurar uma simbologia.
BarcodeGenerator(BaseEncodeType, string)
Cria uma instância de BarcodeGenerator.
public BarcodeGenerator(BaseEncodeType type, string codeText)
Parâmetros
type
BaseEncodeType
Tipo de simbologia do código de barras. Use a classe Aspose.BarCode.Generation.EncodeTypes para configurar uma simbologia.
codeText
string
Texto a ser codificado.
Propriedades
BarcodeType
Tipo de simbologia do código de barras.
[XmlSerialization(Type = XmlSerializationType.Element)]
public BaseEncodeType BarcodeType { get; set; }
Valor da Propriedade
CodeText
Texto a ser codificado.
[XmlSerialization(Type = XmlSerializationType.Element)]
public string CodeText { get; set; }
Valor da Propriedade
Parameters
Parâmetros de geração.
[XmlSerialization(Type = XmlSerializationType.Element)]
public BaseGenerationParameters Parameters { get; }
Valor da Propriedade
Métodos
Dispose()
public void Dispose()
ExportToXml(string)
Exporta propriedades do BarCode para o arquivo xml especificado.
public bool ExportToXml(string xmlFile)
Parâmetros
xmlFile
string
O nome do arquivo
Retorna
Indica se a exportação foi concluída com sucesso.
Retorna True em caso de sucesso; False caso contrário
ExportToXml(Stream)
Exporta propriedades do BarCode para o fluxo xml especificado.
public bool ExportToXml(Stream xml)
Parâmetros
xml
Stream
O fluxo xml
Retorna
Indica se a exportação foi concluída com sucesso.
Retorna True em caso de sucesso; False caso contrário
GenerateBarCodeImage()
Gera a imagem do código de barras com as configurações atuais.
public Bitmap GenerateBarCodeImage()
Retorna
Bitmap
Imagem do código de barras. Veja System.Drawing.Bitmap.
Exemplos
Este exemplo mostra como criar e salvar uma imagem de código de barras.
using(var generator = new BarcodeGenerator(EncodeTypes.Code128))
{
Bitmap barcode = generator.GenerateBarCodeImage();
barcode.Save("test.png");
}
ImportFromXml(string)
Importa propriedades do BarCode do arquivo xml especificado e cria uma instância de BarcodeGenerator.
public static BarcodeGenerator ImportFromXml(string xmlFile)
Parâmetros
xmlFile
string
O nome do arquivo
Retorna
Instância do BarcodeGenerator
ImportFromXml(Stream)
Importa propriedades do BarCode do fluxo xml especificado e cria uma instância de BarcodeGenerator.
public static BarcodeGenerator ImportFromXml(Stream xml)
Parâmetros
xml
Stream
O fluxo xml
Retorna
Instância do BarcodeGenerator
Save(Stream, BarCodeImageFormat)
Salva a imagem do código de barras no fluxo em um formato específico.
public void Save(Stream stream, BarCodeImageFormat format)
Parâmetros
stream
Stream
Saída System.IO.Stream.
format
BarCodeImageFormat
Especifica o formato do arquivo da imagem de saída.
Save(string, BarCodeImageFormat)
Salva a imagem do código de barras em um arquivo específico em um formato específico.
public void Save(string filename, BarCodeImageFormat format)
Parâmetros
filename
string
Caminho para salvar.
format
BarCodeImageFormat
Especifica o formato do arquivo da imagem de saída.
Save(string)
Salva a imagem do código de barras em um arquivo específico.
public void Save(string filename)
Parâmetros
filename
string
Caminho para salvar.
SetCodeText(byte[])
Define o texto do código como uma sequência de bytes.
public void SetCodeText(byte[] codeBytes)
Parâmetros
codeBytes
byte[]
Bytes do texto do código
SetCodeText(string, Encoding)
Codifica o texto do código com marca de ordem de bytes (BOM), usando a codificação especificada: como UTF8, UTF16, UTF32, etc. Códigos de barras 1D devem usar Encoding.ASCII ou ISO/IEC 8859-1 - Encoding.GetEncoding(28591). Códigos de barras 2D devem usar Encoding.UTF8.
public void SetCodeText(string codeText, Encoding encoding)
Parâmetros
codeText
string
String do CodeText
encoding
Encoding
Codificação aplicada
Exemplos
Este exemplo mostra como usar SetCodeText com códigos de barras 1D e 2D
//Codifica o texto do código de barras 1D com codificação ASCII de 7 bits, a marca de ordem de bytes (BOM) está ausente
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
gen.SetCodeText("123ABCD", Encoding.ASCII);
gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Codifica o texto do código de barras 1D com codificação ISO/IEC 8859-1 de 8 bits, a marca de ordem de bytes (BOM) está ausente
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
gen.SetCodeText("123ABCD", Encoding.GetEncoding(28591));
gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Codifica o texto do código de barras 2D com codificação UTF8 com marca de ordem de bytes (BOM)
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
gen.SetCodeText("123ABCD", Encoding.UTF8);
gen.Save("barcode.png", BarCodeImageFormat.Png);
}
SetCodeText(string, Encoding, bool)
Codifica o texto do código com inserção opcional de marca de ordem de bytes (BOM), usando a codificação especificada: como UTF8, UTF16, UTF32, etc. Códigos de barras 1D devem usar Encoding.ASCII ou ISO/IEC 8859-1 - Encoding.GetEncoding(28591). Códigos de barras 2D devem usar Encoding.UTF8.
public void SetCodeText(string codeText, Encoding encoding, bool insertBOM)
Parâmetros
codeText
string
String do CodeText
encoding
Encoding
Codificação aplicada
insertBOM
bool
flag que indica a inserção da marca de ordem de bytes (BOM) da codificação. Caso a codificação exija a inserção da marca de ordem de bytes (BOM), como UTF8, UTF16, UTF32, etc., e a flag esteja configurada como verdadeira, a BOM é adicionada. Se a flag for configurada como falsa, a inserção da BOM é ignorada.
Exemplos
Este exemplo mostra como usar SetCodeText com códigos de barras 1D e 2D
//Codifica o texto do código de barras 1D com codificação ASCII de 7 bits, a marca de ordem de bytes (BOM) está ausente
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
gen.SetCodeText("123ABCD", Encoding.ASCII, true);
gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Codifica o texto do código de barras 1D com codificação ISO/IEC 8859-1 de 8 bits, a marca de ordem de bytes (BOM) está ausente
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
gen.SetCodeText("123ABCD", Encoding.GetEncoding(28591), true);
gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Codifica o texto do código de barras 2D com codificação UTF8 com marca de ordem de bytes (BOM)
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
gen.SetCodeText("123ABCD", Encoding.UTF8, true);
gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Codifica o texto do código de barras 2D com codificação UTF8 sem marca de ordem de bytes (BOM)
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
gen.SetCodeText("123ABCD", Encoding.UTF8, false);
gen.Save("barcode.png", BarCodeImageFormat.Png);
}