Crystal Reports, geliştiricilerin uygulamaları için zengin özellikli raporlar oluşturmasına olanak tanıyan güçlü bir raporlama aracıdır. C# kullanarak Crystal Reports'a barkod eklemek, veri temsilinde yeni bir boyut kazandırır, yönetimi ve bilgilerin izlenmesini kolaylaştırır. Bu makalede, C# kullanarak Crystal Reports'a barkod entegrasyon adımlarını inceleyeceğiz.

How to Add a Barcode in Crystal Reports using C#

1. Barkod Kütüphanesini Yükleyin.
2. Bir Barkod görüntüsü oluşturun ve bir veritabanı tablosuna resim olarak kaydedin.
3. Crystal Report'un düzenini tasarlayın.
4. Veritabanına bağlantıyı kurun ve gerekli tabloyu seçin.
5. Crystal Report düzenine Barkod Resim alanı ekleyin.
6. Projeyi derleyin ve çalıştırın.

Bir Barkod Kütüphanesi Seçin

Uygulamaya dalmadan önce, Crystal Reports ve C#'ı destekleyen bir barkod kütüphanesi seçmek önemlidir. Popüler bir seçenek, .NET için IronBarcode.

IronBarcode nedir?

IronBarcode, barkod oluşturma ve okuma işlemlerini basitleştiren çok yönlü bir .NET kütüphanesidir. IronBarcode ile değerini kodlamak istediğiniz çeşitli barkodlar, Code 128 ve QR kodları dahil olmak üzere zahmetsizce oluşturabilirsiniz. Ayrıca boyutlandırma ve özelleştirme destekler. Okuma tarafında, IronBarcode, envanter yönetimi ve belge takibi için, görüntülerden veya PDF'lerden barkod verilerini çekebilir. Kullanıcı dostu API'si, projelerinize hızlı entegrasyon sağlar ve platformlar arası destek, farklı .NET sürümlerinde sorunsuz geliştirme imkanı sunar. Deneyimli bir geliştirici ya da acemi olun, IronBarcode, barkodlarla etkin çalışmanızı sağlar.

Yeni Bir Proje Oluşturun

ASP.NET Crystal Reports Web Sitesi oluşturmak için Visual Studio'yu açın. Visual Studio 2022'yi kullanıyorum. Herhangi birini kullanabilirsiniz, ancak o sürüme ait Visual Studio için Crystal raporlarının yüklü olduğundan emin olun.

Proje Adı, Konumu ve Hedef Platformunu seçin. Oluştur düğmesine tıklayın. Aşağıda gösterildiği gibi yeni bir proje oluşturulacaktır.

Başlamadan önce bir Veritabanına ihtiyacımız var. Yeni bir veritabanı ve örnek tablo oluşturalım.

Yeni Bir Veritabanı Oluşturun

Aşağıdaki betik, yeni bir veritabanı oluşturacaktır.

CREATE DATABASE ProductDB;
USE [ProductDB]
GO
/****** Object:  Table [dbo].[Products]    Script Date: 3/10/2024 2:57:18 PM******/
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE TABLE [dbo].[Products](
    [Product_ID] [int] NULL,
    [Product_Name] [varchar](100) NULL,
    [Product_Price] [decimal](18, 0) NULL,
    [Product_Barcode] [image] NULL
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
GO

CREATE DATABASE ProductDB;
USE [ProductDB]
GO
/****** Object:  Table [dbo].[Products]    Script Date: 3/10/2024 2:57:18 PM******/
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
CREATE TABLE [dbo].[Products](
    [Product_ID] [int] NULL,
    [Product_Name] [varchar](100) NULL,
    [Product_Price] [decimal](18, 0) NULL,
    [Product_Barcode] [image] NULL
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
GO

Bu tabloya veri ekleyelim. Bir barkod oluşturup Ürün tablosuna kaydedeceğiz. Bu nedenle, verileri C# kodu kullanarak eklememiz ve projede barkod oluşturma özelliklerini kullanabilmek için IronBarcode Kütüphanesini kurmamız gerekiyor.

IronBarcode Kütüphanesi Yükleyin

NuGet Paket Yöneticisi Konsolu'nu kullanarak IronBarcode kütüphanesini yüklemek için şu adımları izleyin:

NuGet Paket Yöneticisi Konsolu'nu açın. Bunu Görünüm -> Diğer Pencereler -> Paket Yöneticisi Konsolu'na giderek bulabilirsiniz.

Paket Yöneticisi Konsolu'nda, IronBarcode kütüphanesini kurmak için şu komutu kullanın:

Install-Package BarCode

Komutu yürütmek için Enter tuşuna basın.

Alternatif olarak, Çözüm için NuGet Paketlerini Yönet'i kullanarak IronBarcode kütüphanesini yükleyebilirsiniz:

NuGet Paket Yöneticisi'nin IronBarcode kütüphanesini ve bağımlılıklarını indirmesini ve yüklemesini bekleyin. Yükleme tamamlandığında, Paket Yöneticisi Konsolu'nda bir onay mesajı göreceksiniz.

Şimdi, projenizde IronBarcode kütüphanesi yüklendi ve barkod oluşturma ve okuma özelliklerini kullanmaya başlayabilirsiniz.

Barkod Görüntüleri Oluşturun ve Veritabanında Saklayın

ADO.NET kullanarak barkod görüntüleri oluşturup veritabanında saklayacağız. Aşağıdaki kod, C#'ta barkod oluşturma örneğini gösterir.

using System;
using System.Data.SqlClient;
using IronBarCode;

class Program
{
    static void Main(string[] args)
    {
        // Create a barcode from a string value using Code128 format.
        var myBarcode = BarcodeWriter.CreateBarcode("77446252", BarcodeWriterEncoding.Code128);
        // Add the barcode value text below the barcode image.
        myBarcode.AddBarcodeValueTextBelowBarcode();
        // Resize the barcode image.
        myBarcode.ResizeTo(600, 300);

        // SQL connection to the SQL Server database.
        using (SqlConnection cn = new SqlConnection("Data Source=localhost\\SQLEXPRESS;Initial Catalog=ProductDB;User ID=sa;Password=123456;Integrated Security=SSPI;"))
        {
            // SQL command to insert the barcode into the Products table.
            SqlCommand cmd = new SqlCommand($"INSERT INTO dbo.Products VALUES (77446252, 'Pine Apple Small', '100', @Barcode)", cn);
            // Add parameter for the barcode binary data.
            cmd.Parameters.AddWithValue("@Barcode", myBarcode.BinaryStream);

            // Open the connection, execute the query, close the connection.
            cn.Open();
            cmd.ExecuteNonQuery();
            cn.Close();
        }
    }
}

using System;
using System.Data.SqlClient;
using IronBarCode;

class Program
{
    static void Main(string[] args)
    {
        // Create a barcode from a string value using Code128 format.
        var myBarcode = BarcodeWriter.CreateBarcode("77446252", BarcodeWriterEncoding.Code128);
        // Add the barcode value text below the barcode image.
        myBarcode.AddBarcodeValueTextBelowBarcode();
        // Resize the barcode image.
        myBarcode.ResizeTo(600, 300);

        // SQL connection to the SQL Server database.
        using (SqlConnection cn = new SqlConnection("Data Source=localhost\\SQLEXPRESS;Initial Catalog=ProductDB;User ID=sa;Password=123456;Integrated Security=SSPI;"))
        {
            // SQL command to insert the barcode into the Products table.
            SqlCommand cmd = new SqlCommand($"INSERT INTO dbo.Products VALUES (77446252, 'Pine Apple Small', '100', @Barcode)", cn);
            // Add parameter for the barcode binary data.
            cmd.Parameters.AddWithValue("@Barcode", myBarcode.BinaryStream);

            // Open the connection, execute the query, close the connection.
            cn.Open();
            cmd.ExecuteNonQuery();
            cn.Close();
        }
    }
}

Imports System
Imports System.Data.SqlClient
Imports IronBarCode

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create a barcode from a string value using Code128 format.
		Dim myBarcode = BarcodeWriter.CreateBarcode("77446252", BarcodeWriterEncoding.Code128)
		' Add the barcode value text below the barcode image.
		myBarcode.AddBarcodeValueTextBelowBarcode()
		' Resize the barcode image.
		myBarcode.ResizeTo(600, 300)

		' SQL connection to the SQL Server database.
		Using cn As New SqlConnection("Data Source=localhost\SQLEXPRESS;Initial Catalog=ProductDB;User ID=sa;Password=123456;Integrated Security=SSPI;")
			' SQL command to insert the barcode into the Products table.
			Dim cmd As New SqlCommand($"INSERT INTO dbo.Products VALUES (77446252, 'Pine Apple Small', '100', @Barcode)", cn)
			' Add parameter for the barcode binary data.
			cmd.Parameters.AddWithValue("@Barcode", myBarcode.BinaryStream)

			' Open the connection, execute the query, close the connection.
			cn.Open()
			cmd.ExecuteNonQuery()
			cn.Close()
		End Using
	End Sub
End Class

Imports System
Imports System.Data.SqlClient
Imports IronBarCode

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create a barcode from a string value using Code128 format.
		Dim myBarcode = BarcodeWriter.CreateBarcode("77446252", BarcodeWriterEncoding.Code128)
		' Add the barcode value text below the barcode image.
		myBarcode.AddBarcodeValueTextBelowBarcode()
		' Resize the barcode image.
		myBarcode.ResizeTo(600, 300)

		' SQL connection to the SQL Server database.
		Using cn As New SqlConnection("Data Source=localhost\SQLEXPRESS;Initial Catalog=ProductDB;User ID=sa;Password=123456;Integrated Security=SSPI;")
			' SQL command to insert the barcode into the Products table.
			Dim cmd As New SqlCommand($"INSERT INTO dbo.Products VALUES (77446252, 'Pine Apple Small', '100', @Barcode)", cn)
			' Add parameter for the barcode binary data.
			cmd.Parameters.AddWithValue("@Barcode", myBarcode.BinaryStream)

			' Open the connection, execute the query, close the connection.
			cn.Open()
			cmd.ExecuteNonQuery()
			cn.Close()
		End Using
	End Sub
End Class

Kod Açıklaması

1. Barkod Oluşturma

1. var myBarcode = BarcodeWriter.CreateBarcode("77446252", BarcodeWriterEncoding.Code128);

   • Bu satır, BarcodeWriter sınıfının CreateBarcode() metodunu kullanarak bir barkod oluşturur. Barkod, "77446252" dizesiyle temsil edilen verilerden, Code 128 kodlama formatı kullanılarak oluşturulur. myBarcode değişkeni artık oluşturulan barkodu tutar.

2. AddBarcodeValueTextBelowBarcode()

   • Bu işlev, barkodun altına barkod değerinin açıklama metnini ekler.

3. ResizeTo(600, 300)

   • Barkod görüntüsünün yüksekliği ve genişliğini belirtilen ölçülere göre ayarlar.

4. Barkod görüntülerini dosya sistemine kaydetmek için SaveAs() metodunu kullanabilirsiniz.

Yukarıdaki koddan oluşturulacak barkod aşağıdaki gibi olacaktır:

2. Veritabanı Bağlantısı Kurulumu

1. SqlConnection cn = new SqlConnection("Data Source=localhost\\SQLEXPRESS;Initial Catalog=ProductDB;User ID=sa;Password=123456;Integrated Security=SSPI;");

   • Bir SQL Server veritabanına bağlantı kurar. Bağlantı dizesi sunucuyu (localhost\\SQLEXPRESS), başlangıç kataloğunu (veritabanı adı: ProductDB) ve kimlik doğrulama bilgilerini (user ID sa ve password 123456) belirtir.

3. SQL Komut Oluşturma

1. SqlCommand cmd = new SqlCommand($"INSERT INTO dbo.Products VALUES (77446252, 'Pine Apple Small', '100', '{myBarcode.BinaryStream}' )", cn);

   • Yeni bir SqlCommand nesnesi oluşturur. Bu komut, Ürünler tablosuna veri eklemek için bir SQL sorgusunu temsil eder.
   • Sorgu, tablodaki sütunlara değerleri ekler: 77446252, 'Pine Apple Small', '100' ve oluşturulan barkodun ikili akışı (myBarcode.BinaryStream).

4. Veritabanı Etkileşimi

1. cn.Open();: Veritabanı bağlantısı açılır.
2. cmd.ExecuteNonQuery();: SQL sorgusu yürütülür ve belirtilen değerler Ürünler tablosuna eklenir.
3. cn.Close();: Kaynakları serbest bırakmak için veritabanı bağlantısı kapatılır.

Crystal Reports Barkod Oluşturucunuzu Tasarlayın

Şimdi, rapor düzenini tasarlayın, veritabanı bağlantılarını ekleyin ve gerekli alanları düzenleyin. Bu işlemde yeniyseniz, aşağıdaki adımları takip edin.

1. Alan Gezgini'ni Aç => Veritabanı Alanı => Veritabanı Uzmanı.

   

2. Yeni Bağlantı Oluştur'u Genişlet => OLE DB(ADO) => Yeni Bağlantı Oluştur.

   

3. Microsoft OLE DB Veri Kaynağını SQL Server için seçin ve İleri'ye tıklayın.

   

4. Aşağıda gösterildiği gibi Sunucu Adı, Giriş Bilgisi ve Veritabanı Adı belirtin.

   

5. İleri butonuna basın, yeni bir pencere açılacak ve ardından Bitir'e tıklayın.

6. Eklemek istediğiniz tabloyu seçin. Bu durumda, Ürünler tablosunu seçin.

   

7. Tamam Butonuna tıklayın.

Veritabanı Bağlantısını kurduk. Şimdi, Rapor düzenini kurulum yapalım.

Şimdi, "Crystal rapor C#'ta Barkod" metni ile bir Metin Kutusu ekledim. Bir metin kutusu ekledim ve Ürün Kimliği, Ürün Adı, Ürün Fiyatı Alanı ve Ürün Barkodu'nu veritabanı alanlarından sürükleyip kutunun içine yerleştirdim.

Crystal Report Görünümünde Crystal Report Önizlemesini Görün.

Projeyi derleyin ve çalıştırın. Çıktı şu şekildedir:

Örnek veri kümesi paketini indirmedim, doğru veri dosyasına sahip olduğumdan emin oldum ve kapsamlı veri görselleştirmesi için C#'ta bir Crystal Report oluşturdum.

Bu şekilde, Barkod Fontunu indirmeden Crystal Reports Uygulamasında barkod oluşturabiliriz. Benzer şekilde, gereksiniminize göre bir QR Kodu da ekleyebiliriz.

Sonuç

Sonuç olarak, C# kullanarak Crystal Reports'a barkod entegre etmek, veri temsilini ve yönetimini güçlendirmek için güçlü bir yol sunar. IronBarcode gibi güvenilir bir barkod kütüphanesi seçmek, süreçleri kolaylaştırır ve çok yönlülük ile kullanım kolaylığı sunar. IronBarcode, çeşitli barkod türlerinin, boyutlandırma ve özelleştirme özellikleri ile barkod oluşturma ve okuma görevlerinde değerli bir kaynak olduğunu kanıtlar. Burada sunulan adım adım kılavuz, kütüphaneyi seçmekten Crystal Report düzeni tasarımına kadar nahtabak uygulama sürecini sağlar.

Ayrıca, IronBarcode geliştiricilere, barkod entegrasyon deneyimlerini geliştirmek için ek işlevsellikler ve destek sağlama fırsatı sunar. Bu esneklik, IronBarcode'u, küçük ölçekli projeler veya kurumsal düzeyde uygulamalar üzerinde çalışan geliştiriciler için cazip bir seçim haline getirir.