GS1-128

Updated: 22 de abril de 2026

¿IronBarcode admite la simbología GS1 UCC/EAN-128?

Los códigos de barras con GS1 son reconocidos y decodificados con precisión. Sin embargo, el problema radica en la falta actual de corchetes en el valor del código de barras mostrado.

Al usar GS1-128, IronBarcode actualmente produce: 01950123456789033103000123 (que es reconocido como un código de barras Code 128 con firma GS1). El valor deseado para ser mostrado en la salida de la imagen sería: 01950123456789033103000123. Sin embargo, el escáner de código de barras producirá (01)95012345678903(3103)000123 con una detección del tipo de código de barras como Code128.

Para generar un código de barras GS1-128, use el siguiente código:

using IronBarCode;

class BarcodeExample
{
    static void Main()
    {
        // Create a GS1-128 barcode using the specified value
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("01950123456789033103000123", BarcodeWriterEncoding.Code128GS1);

        // Add the barcode value text below the barcode on the generated image
        barcode.AddBarcodeValueTextBelowBarcode();

        // Save the barcode image as a PNG file
        barcode.SaveAsPng("gs1code128.png");
    }
}

using IronBarCode;

class BarcodeExample
{
    static void Main()
    {
        // Create a GS1-128 barcode using the specified value
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("01950123456789033103000123", BarcodeWriterEncoding.Code128GS1);

        // Add the barcode value text below the barcode on the generated image
        barcode.AddBarcodeValueTextBelowBarcode();

        // Save the barcode image as a PNG file
        barcode.SaveAsPng("gs1code128.png");
    }
}

Imports IronBarCode

Friend Class BarcodeExample
	Shared Sub Main()
		' Create a GS1-128 barcode using the specified value
		Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("01950123456789033103000123", BarcodeWriterEncoding.Code128GS1)

		' Add the barcode value text below the barcode on the generated image
		barcode.AddBarcodeValueTextBelowBarcode()

		' Save the barcode image as a PNG file
		barcode.SaveAsPng("gs1code128.png")
	End Sub
End Class

Imports IronBarCode

Friend Class BarcodeExample
	Shared Sub Main()
		' Create a GS1-128 barcode using the specified value
		Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("01950123456789033103000123", BarcodeWriterEncoding.Code128GS1)

		' Add the barcode value text below the barcode on the generated image
		barcode.AddBarcodeValueTextBelowBarcode()

		' Save the barcode image as a PNG file
		barcode.SaveAsPng("gs1code128.png")
	End Sub
End Class

Código de barras de salida

Ejemplo de código de barras de salida

El código anterior genera un código de barras GS1-128 con un divisor predeterminado. Si desea agregar divisores adicionales, puede insertar el separador Unicode \u00f1. Sin embargo, tenga en cuenta que al usar el método AddBarcodeValueTextBelowBarcode, se mostrará el carácter Unicode ñ (código 0x00F1). Para superar esta limitación, un enfoque alternativo es manipular la cadena y pasar el valor modificado al método AddAnnotationTextBelowBarcode. De esta manera, puede lograr la visualización deseada del valor del código de barras sin el carácter ñ.

using IronBarCode;

class BarcodeExampleWithAnnotation
{
    static void Main()
    {
        // Original barcode value
        string barcodeValue = "0195012345678903310300012300\u00f10000000123300000\u00f10000012312300000";
        
        // Remove unwanted unicode characters for display purposes
        string trimmedString = barcodeValue.Replace("\u00f1", "");

        // Create a GS1-128 barcode using the original value
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128GS1);

        // Add a custom annotation text below the barcode with the trimmed value
        barcode.AddAnnotationTextBelowBarcode(trimmedString);

        // Save the barcode image as a PNG file
        barcode.SaveAsPng("gs1code128.png");
    }
}

using IronBarCode;

class BarcodeExampleWithAnnotation
{
    static void Main()
    {
        // Original barcode value
        string barcodeValue = "0195012345678903310300012300\u00f10000000123300000\u00f10000012312300000";
        
        // Remove unwanted unicode characters for display purposes
        string trimmedString = barcodeValue.Replace("\u00f1", "");

        // Create a GS1-128 barcode using the original value
        GeneratedBarcode barcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128GS1);

        // Add a custom annotation text below the barcode with the trimmed value
        barcode.AddAnnotationTextBelowBarcode(trimmedString);

        // Save the barcode image as a PNG file
        barcode.SaveAsPng("gs1code128.png");
    }
}

Imports IronBarCode

Class BarcodeExampleWithAnnotation
    Shared Sub Main()
        ' Original barcode value
        Dim barcodeValue As String = "0195012345678903310300012300" & ChrW(&HF1) & "000000123300000" & ChrW(&HF1) & "0000012312300000"
        
        ' Remove unwanted unicode characters for display purposes
        Dim trimmedString As String = barcodeValue.Replace(ChrW(&HF1), "")

        ' Create a GS1-128 barcode using the original value
        Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128GS1)

        ' Add a custom annotation text below the barcode with the trimmed value
        barcode.AddAnnotationTextBelowBarcode(trimmedString)

        ' Save the barcode image as a PNG file
        barcode.SaveAsPng("gs1code128.png")
    End Sub
End Class

Imports IronBarCode

Class BarcodeExampleWithAnnotation
    Shared Sub Main()
        ' Original barcode value
        Dim barcodeValue As String = "0195012345678903310300012300" & ChrW(&HF1) & "000000123300000" & ChrW(&HF1) & "0000012312300000"
        
        ' Remove unwanted unicode characters for display purposes
        Dim trimmedString As String = barcodeValue.Replace(ChrW(&HF1), "")

        ' Create a GS1-128 barcode using the original value
        Dim barcode As GeneratedBarcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128GS1)

        ' Add a custom annotation text below the barcode with the trimmed value
        barcode.AddAnnotationTextBelowBarcode(trimmedString)

        ' Save the barcode image as a PNG file
        barcode.SaveAsPng("gs1code128.png")
    End Sub
End Class

Código de barras de salida

Ejemplo de código de barras de salida con anotación

Al escanear el código de barras, la salida será (01)95012345678903(3103)000123(00)0000000123300000(00)00012312300000, y el tipo de código de barras se detectará como GS1Code128.

Analizar la codificación GS1-128

IronBarcode también puede analizar la codificación física de un código de barras GS1-128, mostrando qué conjuntos de caracteres del Código 128 (A, B o C) se utilizan para cada segmento de los datos. Use el método Code128GS1Parser.ParseWithEncoding para analizar una cadena GS1 con análisis de codificación incluido.

using IronBarCode;

// GS1-128 with encoding analysis
var gs1Result = Code128GS1Parser.ParseWithEncoding("(01)09501101530003");
Console.WriteLine(gs1Result.CharacterSetSummary);  // "C"
Console.WriteLine(gs1Result.HasEncodingInfo);      // true

using IronBarCode;

// GS1-128 with encoding analysis
var gs1Result = Code128GS1Parser.ParseWithEncoding("(01)09501101530003");
Console.WriteLine(gs1Result.CharacterSetSummary);  // "C"
Console.WriteLine(gs1Result.HasEncodingInfo);      // true

Imports IronBarCode

' GS1-128 with encoding analysis
Dim gs1Result = Code128GS1Parser.ParseWithEncoding("(01)09501101530003")
Console.WriteLine(gs1Result.CharacterSetSummary)  ' "C"
Console.WriteLine(gs1Result.HasEncodingInfo)      ' True

Imports IronBarCode

' GS1-128 with encoding analysis
Dim gs1Result = Code128GS1Parser.ParseWithEncoding("(01)09501101530003")
Console.WriteLine(gs1Result.CharacterSetSummary)  ' "C"
Console.WriteLine(gs1Result.HasEncodingInfo)      ' True

Dado que los datos GS1-128 son principalmente numéricos, el codificador utiliza el Código C para lograr la máxima compacidad. La propiedad HasEncodingInfo confirma que el análisis de codificación está disponible en el resultado.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...