C# CSV Ayrıştırıcı (Adım Adım) Eğitimi

Visual Studio NuGet Paket Yöneticisini Kullanmalı mıyım?

NuGet Paket Yöneticisi UI, paketi doğrudan projeye yüklemek için Visual Studio'da bulunmaktadır. Bu yöntem, görsel arayüzleri tercih eden ve kurulumdan önce paket ayrıntılarını görmek isteyen geliştiriciler için özellikle kullanışlıdır. Aşağıdaki ekran görüntüsü, bunu nasıl açacağınızı gösteriyor.

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

Paket Yöneticisi UI, NuGet web sitesindeki mevcut paket kütüphanelerini gösteren bir Göz Atma özelliği sağlar. Aşağıdaki ekran görüntüsünde gösterildiği gibi "IronXL" veriniz ve IronXL paketini bulun. IronXL'nin sunduğu ilgili Excel manipülasyon özelliklerini de keşfedebilirsiniz.

NuGet Paket Yöneticisi, geliştiricilerin .NET uygulamalarında Excel dosyalarını okumalarına, oluşturmalarına ve düzenlemelerine olanak tanıyan IronXL.Excel kütüphanesini gösteriyor. Paket 250K indirmeyle ve yükleme için hazır 2022.9.9454 sürümüyle gösterilmektedir

IronXL.Excel paketini seçin ve projeye eklemek için Yükle düğmesine tıklayın. Kurulum işlemi tüm bağımlılıkları otomatik olarak yönetir ve projenizi Excel dosya manipülasyonu için yapılandırır.

Ne Zaman Visual Studio Komut Satırı Kullanmalıyım?

Visual Studio menüsünde, Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu üzerine tıklayın. Bu yöntem, komut satırı arayüzleriyle rahat olan veya yapı kodlarında kurulum sürecini otomatikleştirmesi gereken geliştiriciler tarafından tercih edilir.

Visual Studio'da CSV ayrıştırma kütüphanelerini yüklemek için NuGet Paket Yöneticisi Konsolu'nu açmak

Paket Yöneticisi Konsolu ekranın altında görünecektir. Aşağıdaki komutu yazın ve enter tuşuna basın. IronXL yüklenecektir. Bu yöntem, belirli sürümleri yüklemeniz gerektiğinde veya Azure dağıtım betikleri veya AWS ortamlarıyla çalışırken özellikle faydalıdır.

Install-Package IronXL.Excel

Paket Yöneticisi Konsolu, NuGet deposundan başarılı indirmeler ve paket geri yükleme sürecini gösteren IronXL.Excel sürüm 2022.11.10251'nin başarılı kurulumu gösteriyor

XLSX Dosyasını CSV'ye Nasıl Dönüştürebilirim?

Microsoft Excel'i açın ve yeni bir XLSX dosyası oluşturun. Satırlarını ve sütunlarını bazı örnek verilerle doldurun. Üretim senaryoları için, IronXL kullanarak programmatik olarak Excel dosyaları oluşturmak isteyebilirsiniz. Aşağıdaki görüntü, bu eğitimdeki tüm dönüşümler için kullanılan dosyayı gösteriyor.

Şekil 6: C# içinde CSV ayrıştırmayı göstermek için kullanılacak basit envanter yapısını gösteren örnek Excel verisi

Dosyanız hazır olduğunda, aşağıdaki örnek kodu yazın ve programı çalıştırın. IronXL, özel karakterlerin ve veri türlerinin uygun şekilde yönetilmesi de dahil olmak üzere tüm karmaşık ayrıştırmayı dahili olarak yönetir:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the XLSX file into a WorkBook object
        ' The Load method automatically detects the file format
        Dim wb As WorkBook = WorkBook.Load("test.xlsx")

        ' Save the WorkBook as a CSV file
        ' This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv")

        ' Optional: Save with custom delimiter
        ' wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";")
    End Sub
End Class

Yürütme tamamlandıktan sonra, Parsed CSV.csv adlı yeni bir dosya oluşturulacak. CSV dosyalarını istediğiniz herhangi bir editörde veya okuyucuda okuyabilirsiniz. Ayrıca, daha fazla manipülasyon için CSV verilerini Excel'e geri aktarabilirsiniz. Aşağıdaki görüntü yukarıdaki komutun çıktısını gösterir—oluşturulan CSV verimiz. Çıktı dosyasında tırnak işaretleri kalın değerleri temsil edebilir.

Şekil 7: SaveAsCsv metodu tarafından oluşturulan CSV çıktısı, çevrilmiş Excel verilerini virgülle ayrılmış formatta gösteriyor

XLS Dosyalarını CSV'ye Dönüştürmenin Adımları Nelerdir?

Bu örnekte, XLS dosyalarını CSV formatına nasıl dönüştüreceğinizi göreceğiz. Süreç, IronXL'nin farklı Excel dosya formatlarında ne kadar çok yönlü olduğunu gösteren XLSX dönüşümü ile aynıdır.

Öncelikle, CSV formatına dönüştürebileceğimiz bir örnek XLS dosyası oluşturalım. XLS'nin eski bir Excel formatı olduğunu unutmayın, ancak IronXL, modern formatların yanı sıra bunu da sorunsuz şekilde yönetir:

Şekil 8: C# CSV kütüphaneleri kullanılarak ayrıştırılabilecek otomatik hesaplamalarla envanter veri yapısını gösteren örnek bir Excel dosyası

Ardından, örnek XLS dosyasını bir CSV dosyasına dönüştürmek için aşağıdaki kod bloğunu çalıştıracağız. IronXL, dönüşüm sırasında veri bütünlüğünü korur, formüller ve hesaplamalar dahil.

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the XLS file into a WorkBook object
        ' IronXL automatically handles the older XLS format
        Dim wb As WorkBook = WorkBook.Load("XLS.xls")

        ' Save the WorkBook as a CSV file
        ' All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv")

        ' Optional: Export specific worksheet
        ' Dim ws As WorkSheet = wb.GetWorkSheet("Sheet1")
        ' ws.SaveAsCsv("Example2.csv")
    End Sub
End Class

Yukarıdaki kodun çalıştırılmasının ardından, yeni oluşturulmuş bir CSV dosyanız olacak. Daha karmaşık senaryolar için, belirli aralıkları seçmek veya ihracattan önce verileri sıralamak isteyebilirsiniz.

WordPad içinde açılmış örnek CSV dosyası, başlıklarla düzgün formatlanmış virgülle ayrılmış verileri ve çoklu ürün girdilerini göstermektedir

TSV Formatından CSV Dosyalarını Nasıl Ayrıştırabilirim?

Elektronik tablo uygulamaları, veri tabanları arasında veri aktarmak için sıklıkla TSV dosyaları veya Tab-Separated Values dosyalarını kullanır. Bu, verileri noktalarla ayırarak ve her kaydı ayrı bir satırda bulunan bir veri tablosu olarak kaydeder. TSV dosyaları, verilerinizin CSV ayıklamasını engelleyebilecek virgüller içerdiğinde özellikle yararlıdır.

IronXL, daha iyi veri yönetimi için CSV dosyalarını TSV formatından ayrıştırmak için bir CSV ayıklayıcı sunar. Dönüşüm süreci basittir ve veri bütünlüğünü süreç boyunca korur.

Örneğe başlamamıza izin ver. Öncelikle, öğrenci verileri içeren bir TSV dosyası oluşturacağız:

Sekmelerle ayrılmış öğrenci verisinin Microsoft Word'de gösterilen örneği, Ad, E-posta, R-NO ve Not sütunlarını içeren bir TSV dosyasının yapısını gösteriyor

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

Imports IronXL

Class Program
    Shared Sub Main()
        ' Load the TSV file into a WorkBook object
        ' IronXL automatically detects tab-separated format
        Dim wb As WorkBook = WorkBook.Load("TSV.tsv")

        ' Save the WorkBook as a CSV file
        ' Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv")

        ' Alternative: Load with explicit delimiter specification
        ' Dim wb As WorkBook = WorkBook.LoadCSV("TSV.tsv", delimiter:=vbTab)
    End Sub
End Class

Aşağıda CSV formatındaki çıktıdır. IronXL'in sekmelerle ayrılmış değerleri, veri yapısını koruyarak nasıl virgüllerle ayrılmış değerlere doğru dönüştürdüğünü gözlemleyin:

WordPad içinde açılmış örnek CSV dosyası, ad, e-posta, sicil numarası ve virgüllerle ayrılmış not gibi alanlarla öğrenci kayıtlarını gösteriyor