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 код ...
[XmlSerialization(Name = "Aspose.BarCode.Generator")]
public sealed class 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; }
Значення властивості
CodeText
Текст, що підлягає кодуванню.
[XmlSerialization(Type = XmlSerializationType.Element)]
public string CodeText { get; set; }
Значення властивості
Parameters
Параметри генерації.
[XmlSerialization(Type = XmlSerializationType.Element)]
public BaseGenerationParameters Parameters { get; }
Значення властивості
Методи
Dispose()
public void Dispose()
ExportToXml(string)
Експортує властивості BarCode у вказаний xml-файл.
public bool ExportToXml(string xmlFile)
Параметри
xmlFile
string
Ім’я файлу
Повертає
Чи успішно завершено експорт.
Повертає True у разі успіху; False в іншому випадку
ExportToXml(Stream)
Експортує властивості BarCode у вказаний xml-потік.
public bool ExportToXml(Stream xml)
Параметри
xml
Stream
Xml-потік
Повертає
Чи успішно завершено експорт.
Повертає 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
ImportFromXml(Stream)
Імпортує властивості BarCode з вказаного xml-потоку та створює екземпляр BarcodeGenerator.
public static BarcodeGenerator ImportFromXml(Stream xml)
Параметри
xml
Stream
Xml-потік
Повертає
Екземпляр 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);
}