Class BarcodeGenerator

Class BarcodeGenerator

Namespace: Aspose.BarCode.Generation
Assembly: Aspose.BarCode.dll (25.1.0)

BarcodeGenerator для генерации изображений штрих-кодов на серверной стороне.

поддерживаемые симбологии: 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, QR code ...

[XmlSerialization(Name = "Aspose.BarCode.Generator")]
public sealed class BarcodeGenerator : IDisposable

Наследование

object ← BarcodeGenerator

Реализует

IDisposable

Унаследованные члены

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Примеры

Этот пример показывает, как создать и сохранить изображение штрих-кода.

  using(var generator = new BarcodeGenerator(EncodeTypes.Code128))
  {
      generator.CodeText = "123ABC";
      generator.Save("code128.png");
  }

Конструкторы

BarcodeGenerator(BaseEncodeType)

Создает экземпляр BarcodeGenerator.

public BarcodeGenerator(BaseEncodeType type)

Параметры

type BaseEncodeType

Тип симбологии штрих-кода. Используйте класс Aspose.BarCode.Generation.EncodeTypes для настройки симбологии.

BarcodeGenerator(BaseEncodeType, string)

Создает экземпляр BarcodeGenerator.

public BarcodeGenerator(BaseEncodeType type, string codeText)

Параметры

type BaseEncodeType

Тип симбологии штрих-кода. Используйте класс Aspose.BarCode.Generation.EncodeTypes для настройки симбологии.

codeText string

Текст для кодирования.

Свойства

BarcodeType

Тип симбологии штрих-кода.

[XmlSerialization(Type = XmlSerializationType.Element)]
public BaseEncodeType BarcodeType { get; set; }

Значение свойства

BaseEncodeType

CodeText

Текст для кодирования.

[XmlSerialization(Type = XmlSerializationType.Element)]
public string CodeText { get; set; }

Значение свойства

string

Parameters

Параметры генерации.

[XmlSerialization(Type = XmlSerializationType.Element)]
public BaseGenerationParameters Parameters { get; }

Значение свойства

BaseGenerationParameters

Методы

Dispose() 

public void Dispose()

ExportToXml(string)

Экспортирует свойства BarCode в указанный xml-файл.

public bool ExportToXml(string xmlFile)

Параметры

xmlFile string

Имя файла

Возвращает

bool

Успешно ли завершился экспорт.

Возвращает True в случае успеха; False в противном случае

ExportToXml(Stream)

Экспортирует свойства BarCode в указанный xml-поток.

public bool ExportToXml(Stream xml)

Параметры

xml Stream

XML-поток

Возвращает

bool

Успешно ли завершился экспорт.

Возвращает True в случае успеха; False в противном случае

GenerateBarCodeImage()

Генерирует изображение штрих-кода с текущими настройками.

public Bitmap GenerateBarCodeImage()

Возвращает

Bitmap

Изображение штрих-кода. См. System.Drawing.Bitmap.

Примеры

Этот пример показывает, как создать и сохранить изображение штрих-кода.

  using(var generator = new BarcodeGenerator(EncodeTypes.Code128))
  {
      Bitmap barcode = generator.GenerateBarCodeImage();
      barcode.Save("test.png");
  }

ImportFromXml(string)

Импортирует свойства BarCode из указанного xml-файла и создает экземпляр BarcodeGenerator.

public static BarcodeGenerator ImportFromXml(string xmlFile)

Параметры

xmlFile string

Имя файла

Возвращает

BarcodeGenerator

Экземпляр BarcodeGenerator

ImportFromXml(Stream)

Импортирует свойства BarCode из указанного xml-потока и создает экземпляр BarcodeGenerator.

public static BarcodeGenerator ImportFromXml(Stream xml)

Параметры

xml Stream

XML-поток

Возвращает

BarcodeGenerator

Экземпляр BarcodeGenerator

Save(Stream, BarCodeImageFormat)

Сохраняет изображение штрих-кода в поток в определенном формате.

public void Save(Stream stream, BarCodeImageFormat format)

Параметры

stream Stream

Выходной System.IO.Stream.

format BarCodeImageFormat

Указывает формат файла выходного изображения.

Save(string, BarCodeImageFormat)

Сохраняет изображение штрих-кода в определенный файл в определенном формате.

public void Save(string filename, BarCodeImageFormat format)

Параметры

filename string

Путь для сохранения.

format BarCodeImageFormat

Указывает формат файла выходного изображения.

Save(string)

Сохраняет изображение штрих-кода в определенный файл.

public void Save(string filename)

Параметры

filename string

Путь для сохранения.

SetCodeText(byte[])

Устанавливает текст кода в виде последовательности байтов.

public void SetCodeText(byte[] codeBytes)

Параметры

codeBytes byte[]

Байты текстового кода

SetCodeText(string, Encoding)

Кодирует текст кода с меткой порядка байтов (BOM), используя указанное кодирование: например, UTF8, UTF16, UTF32 и т.д. 1D штрих-коды должны использовать Encoding.ASCII или ISO/IEC 8859-1 - Encoding.GetEncoding(28591). 2D штрих-коды должны использовать Encoding.UTF8.

public void SetCodeText(string codeText, Encoding encoding)

Параметры

codeText string

Строка CodeText

encoding Encoding

Применяемое кодирование

Примеры

Этот пример показывает, как использовать SetCodeText с 1D и 2D штрих-кодами

//Кодирует текст кода 1D штрих-кодов с 7-битным ASCII кодированием, метка порядка байтов (BOM) отсутствует
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
    gen.SetCodeText("123ABCD", Encoding.ASCII);
    gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Кодирует текст кода 1D штрих-кодов с 8-битным ISO/IEC 8859-1 кодированием, метка порядка байтов (BOM) отсутствует
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
    gen.SetCodeText("123ABCD", Encoding.GetEncoding(28591));
    gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Кодирует текст кода 2D штрих-кодов с UTF8 кодированием с меткой порядка байтов (BOM)
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
    gen.SetCodeText("123ABCD", Encoding.UTF8);
    gen.Save("barcode.png", BarCodeImageFormat.Png);
}

SetCodeText(string, Encoding, bool)

Кодирует текст кода с возможной вставкой метки порядка байтов (BOM), используя указанное кодирование: например, UTF8, UTF16, UTF32 и т.д. 1D штрих-коды должны использовать Encoding.ASCII или ISO/IEC 8859-1 - Encoding.GetEncoding(28591). 2D штрих-коды должны использовать Encoding.UTF8.

public void SetCodeText(string codeText, Encoding encoding, bool insertBOM)

Параметры

codeText string

Строка CodeText

encoding Encoding

Применяемое кодирование

insertBOM bool

флаг, указывающий на вставку метки порядка байтов (BOM) кодирования. Если кодирование требует вставки метки порядка байтов (BOM): например, UTF8, UTF16, UTF32 и т.д., и флаг установлен в true, BOM добавляется; если флаг установлен в false, вставка BOM игнорируется.

Примеры

Этот пример показывает, как использовать SetCodeText с 1D и 2D штрих-кодами

//Кодирует текст кода 1D штрих-кодов с 7-битным ASCII кодированием, метка порядка байтов (BOM) отсутствует
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
    gen.SetCodeText("123ABCD", Encoding.ASCII, true);
    gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Кодирует текст кода 1D штрих-кодов с 8-битным ISO/IEC 8859-1 кодированием, метка порядка байтов (BOM) отсутствует
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
    gen.SetCodeText("123ABCD", Encoding.GetEncoding(28591), true);
    gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Кодирует текст кода 2D штрих-кодов с UTF8 кодированием с меткой порядка байтов (BOM)
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
    gen.SetCodeText("123ABCD", Encoding.UTF8, true);
    gen.Save("barcode.png", BarCodeImageFormat.Png);
}
//Кодирует текст кода 2D штрих-кодов с UTF8 кодированием без метки порядка байтов (BOM)
using (BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.Code128))
{
    gen.SetCodeText("123ABCD", Encoding.UTF8, false);
    gen.Save("barcode.png", BarCodeImageFormat.Png);
}
 Русский