Aspose.Cells Μετατροπέας Κειμένου για .NET

Aspose.Cells Text Converter for .NET is a high-performance API tailored for converting Microsoft Excel workbooks (XLS, XLSX, XLSM) into multiple text-based formats—including CSV, TSV, XML, and SQLSCRIPT—and vice versa. Built on the robust Aspose.Cells engine, this plugin streamlines text conversion workflows for data-migration tools, reporting pipelines, ETL processes, and spreadsheet processing services.

Εγκατάσταση και Ρύθμιση

1. ${SheetIndex}: Ο δείκτης φύλλου εργασίας (προεπιλογή 0‑βάση, προσαρμόσιμο με μετατόπιση).
2. Διαμορφώστε την μετρημένη άδεια χρήσης για να αποφύγετε περιορισμούς αξιολόγησης.

Για λεπτομερή ρύθμιση, δείτε το Εγκατάσταση οδηγός. Για την αδειοδότηση, ακολουθήστε Μετρημένη Αδειοδότηση .

Χαρακτηριστικά και Λειτουργίες

Ολοκληρωμένη Υποστήριξη Μορφών

• Είσοδος: XLS, XLSX, XLSM , CSV, TSV, XML, TXT
• Έξοδος: CSV, TSV, XML (προσαρμόσιμο), SQLSCRIPT (εντολές INSERT έτοιμες για βάση δεδομένων), XLSX, XLS
• Διπλής Κατεύθυνσης Μετατροπή: Μετατροπή από το Excel σε μορφές κειμένου ΚΑΙ από μορφές κειμένου πίσω στο Excel
• Υποστηρίζει μετατροπές round-trip μεταξύ βιβλίων εργασίας Excel και μορφών κειμένου

Έξυπνη Ανίχνευση Μορφής

• Αυτόματη Ανίχνευση Μορφής: Ανιχνεύει τις μορφές εισόδου και εξόδου από τις επεκτάσεις αρχείων
• Επεξεργασία βάσει επεκτάσεων: Δεν χρειάζεται να καθοριστεί SaveFormat για κοινές μετατροπές
• Έξυπνη Ανίχνευση: Αναγνωρίζει .csv, .tsv, .txt, .xlsx, .xls και άλλα αυτόματα

LowCode API για Απλοποιημένη Μετατροπή

• Μετατροπές Μίας Γραμμής: Μετατρέψτε αρχεία με μία κλήση μεθόδου
• Ελάχιστη Διαμόρφωση: Η αυτόματη ανίχνευση μορφής μειώνει τον κώδικα boilerplate
• Βελτιστοποιημένη Απόδοση: Απλοποιημένη διαδρομή εκτέλεσης για κοινά σενάρια
• Εύκολη Ενσωμάτωση: Αντικατάσταση τύπου drop-in για σύνθετη λογική μετατροπής

Προσαρμογή οριοθέτη & κωδικοποίησης

• Ορίστε προσαρμοσμένους οριοθέτες, χαρακτήρες παράθεσης και ακολουθίες διαφυγής για CSV/TSV
• Έλεγχος κωδικοποίησης (UTF-8, UTF-16, ISO-8859-1, κ.λπ.) για συμβατότητα
• Σεβαστείτε τις περιοχές εκτύπωσης, τις αλλαγές σελίδας και τις ρυθμίσεις εκτύπωσης του Excel.

Έλεγχος δομής XML

• Αντιστοίχιση δεδομένων φύλλου εργασίας σε στοιχεία και χαρακτηριστικά XML με προσαρμοσμένα πρότυπα
• Διαμορφώστε τα στοιχεία ρίζας, τους χώρους ονομάτων και την έξοδο σύμφωνη με το σχήμα
• Υποστηρίζει αναπαραστάσεις XML προσανατολισμένες σε γραμμές και σε κελιά

SQLSCRIPT Generation

• Μετατρέψτε αυτόματα κάθε γραμμή σε δηλώσεις SQL INSERT
• Προσαρμόστε τα ονόματα πινάκων, τις λίστες στηλών και τη μορφοποίηση τιμών
• Ομαδοποιήστε πολλαπλές εντολές INSERT για βελτιστοποιημένη εκτέλεση σε σχεσιακές βάσεις δεδομένων

Απόδοση και Κλιμακωσιμότητα

• Μετατροπή βασισμένη σε ροή για μεγάλα βιβλία εργασίας
• Παράλληλη μετατροπή χρησιμοποιώντας πολυπύρηνα συστήματα
• Ελαφρύ για εξαγωγές μονοφύλλων, υψηλή απόδοση για μαζικές μετατροπές

Διαχείριση σφαλμάτων και επικύρωση

• Καθαρή ιεραρχία εξαιρέσεων για σφάλματα μετατροπής, παραβιάσεις μορφής και προβλήματα I/O
• Hooks επικύρωσης για επιθεώρηση/διόρθωση δεδομένων πριν/μετά τη μετατροπή
• Σημεία ενσωμάτωσης καταγραφής για τα πλαίσια καταγραφής .NET

Παραδείγματα Χρήσης

Βασική Μετατροπή: CSV σε Excel (LowCode API)

Ο πιο απλός τρόπος για να μετατρέψετε ένα αρχείο κειμένου σε Excel χρησιμοποιώντας αυτόματη ανίχνευση μορφής:

using Aspose.Cells.LowCode;

// Convert CSV to XLSX (formats inferred from extensions)
TextConverter.Process("data.csv", "output.xlsx");

Δεν χρειάζεται να καθορίσετε μορφές—η API ανιχνεύει αυτόματα την είσοδο CSV και την έξοδο XLSX βάσει των επεκτάσεων αρχείων.

Βασική Μετατροπή: Excel σε CSV

Μετατρέψτε αρχεία Excel σε μορφή CSV με την ίδια ευκολία:

using Aspose.Cells.LowCode;

// Convert XLSX to CSV (formats inferred from extensions)
TextConverter.Process("spreadsheet.xlsx", "output.csv");

Πλήρες Παράδειγμα με Μετρητική Άδεια

Πλήρη εφαρμογή που δείχνει τη ρύθμιση αδειών και τη μετατροπή:

using System;
using Aspose.Cells;
using Aspose.Cells.LowCode;

class ConvertTextToExcel
{
    static void Main()
    {
        // Optional: Configure metered licensing for production use
        // new Metered().SetMeteredKey("PublicKey", "PrivateKey");

        // Convert CSV to XLSX (formats inferred from extensions)
        TextConverter.Process("sample.csv", "output.xlsx");
        
        Console.WriteLine("✓ Conversion completed successfully");
    }
}

Ανάλυση Χαρακτηριστικών: Αυτόματη Ανίχνευση Μορφής

Το LowCode API ανιχνεύει έξυπνα μορφές από τις επεκτάσεις αρχείων:

// CSV to Excel
TextConverter.Process("input.csv", "output.xlsx");   // Detects CSV → XLSX

// TSV to Excel
TextConverter.Process("input.tsv", "output.xlsx");   // Detects TSV → XLSX

// Excel to CSV
TextConverter.Process("input.xlsx", "output.csv");   // Detects XLSX → CSV

// Excel to TSV
TextConverter.Process("input.xlsx", "output.tsv");   // Detects XLSX → TSV

// TXT to Excel
TextConverter.Process("input.txt", "output.xlsx");   // Detects TXT → XLSX

// Excel to TXT
TextConverter.Process("input.xlsx", "output.txt");   // Detects XLSX → TXT

Υποστηριζόμενες Επεκτάσεις:

• Excel: .xlsx, .xls, .xlsm, .xltx, .xltm, .xlsb
• Κείμενο: .csv, .tsv, .txt
• XML: .xml
• Άλλα: Ανιχνεύεται αυτόματα βάσει επέκτασης

Ανάλυση Χαρακτηριστικών: Μετατροπή Διπλής Κατεύθυνσης

Ο Μετατροπέας Κειμένου υποστηρίζει μετατροπή και στις δύο κατευθύνσεις:

Κείμενο σε Excel:

// Import CSV data into Excel workbook
TextConverter.Process("sales_data.csv", "sales_report.xlsx");

// Import TSV data into Excel
TextConverter.Process("tab_delimited.tsv", "formatted_data.xlsx");

// Import XML into Excel
TextConverter.Process("data_export.xml", "spreadsheet.xlsx");

Excel σε Κείμενο:

// Export Excel data to CSV
TextConverter.Process("inventory.xlsx", "inventory_export.csv");

// Export Excel to tab-delimited file
TextConverter.Process("report.xlsx", "report_data.tsv");

// Export Excel to plain text
TextConverter.Process("notes.xlsx", "notes.txt");

Περιστάσεις Χρήσης:

• Μεταφορά Δεδομένων: Μετακίνηση δεδομένων μεταξύ Excel και συστημάτων βάσεων δεδομένων
• Διαδικασίες ETL: Εξαγωγή δεδομένων από το Excel για επεξεργασία
• Αναφορές: Μετατροπή κειμενικών αρχείων καταγραφής σε Excel για ανάλυση
• Ενσωμάτωση: Ανταλλαγή δεδομένων με συστήματα που υποστηρίζουν μόνο μορφές κειμένου
• Αρχειοθέτηση: Μετατροπή αρχείων Excel σε απλό κείμενο για μακροπρόθεσμη αποθήκευση

Ανάλυση Χαρακτηριστικών: Έξοδος Βάσει Αρχείου vs Έξοδος Βάσει Ροής

Συγκρίνετε το απλοποιημένο LowCode API με την παραδοσιακή προσέγγιση:

Επιλέξτε τη μέθοδο εξόδου που ταιριάζει καλύτερα στο σενάριό σας:

using Aspose.Cells.LowCode;

// One line, automatic format detection
TextConverter.Process("data.csv", "output.xlsx");

Παραδοσιακό API (Για Προηγμένη Προσαρμογή):

using Aspose.Cells;

// Load workbook
Workbook workbook = new Workbook("sample.xlsx");

// Configure CSV options
TxtSaveOptions options = new TxtSaveOptions();
options.Separator = ',';
options.Encoding = System.Text.Encoding.UTF8;
options.QuoteType = TxtValueQuoteType.Always;

// Save with custom options
workbook.Save("output.csv", options);

Πότε να Χρησιμοποιήσετε Κάθε Ένα:

• LowCode API: Τυπικές μετατροπές, απαιτείται αυτόματη ανίχνευση, ελάχιστος κώδικας
• Παραδοσιακό API: Προσαρμοσμένοι οριοθέτες, έλεγχος κωδικοποίησης, επιλογές ειδικές για μορφές

Προχωρημένο: Προσαρμοσμένες Επιλογές CSV με το Παραδοσιακό API

Για λεπτομερή έλεγχο της εξόδου CSV:

using Aspose.Cells;

// Load your source workbook
Workbook workbook = new Workbook("sample.xlsx");

// Configure CSV export options
TxtSaveOptions csvOptions = new TxtSaveOptions(SaveFormat.Csv);
csvOptions.Separator = ';';  // Use semicolon instead of comma
csvOptions.Encoding = System.Text.Encoding.UTF8;
csvOptions.QuoteType = TxtValueQuoteType.Always;
csvOptions.KeepSeparatorsForBlankRow = false;
csvOptions.ExportAllSheets = false;  // Export only active sheet

// Save the workbook to CSV format
workbook.Save("output.csv", csvOptions);

Προχωρημένο: Μετατροπή TSV με επιλογές

Εξαγωγή σε τιμές διαχωρισμένες με καρτέλα με προσαρμοσμένες ρυθμίσεις:

using Aspose.Cells;

Workbook workbook = new Workbook("data.xlsx");

TxtSaveOptions tsvOptions = new TxtSaveOptions(SaveFormat.Tsv);
tsvOptions.Separator = '\t';  // Tab character
tsvOptions.Encoding = System.Text.Encoding.UTF8;

workbook.Save("output.tsv", tsvOptions);

Παράδειγμα Μαζικής Μετατροπής

Μετατρέψτε πολλαπλά αρχεία CSV σε μορφή Excel:

using System;
using Aspose.Cells.LowCode;
using System.IO;
using Aspose.Cells;

string[] csvFiles = Directory.GetFiles(".", "*.csv");

foreach (string csvFile in csvFiles)
{
    try
    {
        string outputFile = Path.GetFileNameWithoutExtension(csvFile) + ".xlsx";

        TextConverter.Process(csvFile, outputFile);

        Console.WriteLine($"✓ Converted: {Path.GetFileName(csvFile)}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"✗ Error converting {csvFile}: {ex.Message}");
    }
}

Console.WriteLine($"Batch conversion complete. Processed {csvFiles.Length} files.");

Ενσωμάτωση Σωλήνωσης ETL

Ενσωματώστε τη μετατροπή κειμένου σε ροές εργασίας επεξεργασίας δεδομένων:

using Aspose.Cells.LowCode;
using System.Data;

public class DataPipeline
{
    public void ImportCsvToDatabase(string csvPath, string connectionString)
    {
        // Step 1: Convert CSV to Excel for easier data manipulation
        string excelPath = Path.GetTempFileName() + ".xlsx";
        TextConverter.Process(csvPath, excelPath);
        
        // Step 2: Load Excel and process data
        Workbook workbook = new Workbook(excelPath);
        Worksheet sheet = workbook.Worksheets[0];
        
        // Step 3: Extract data and insert into database
        DataTable dataTable = sheet.Cells.ExportDataTable(0, 0, 
            sheet.Cells.MaxDataRow + 1, 
            sheet.Cells.MaxDataColumn + 1, 
            true);  // First row has headers
        
        // Step 4: Bulk insert into database
        using (SqlConnection conn = new SqlConnection(connectionString))
        {
            conn.Open();
            using (SqlBulkCopy bulkCopy = new SqlBulkCopy(conn))
            {
                bulkCopy.DestinationTableName = "ImportedData";
                bulkCopy.WriteToServer(dataTable);
            }
        }
        
        // Clean up
        File.Delete(excelPath);
        
        Console.WriteLine($"✓ Imported {dataTable.Rows.Count} rows from {csvPath}");
    }
}

Παράδειγμα ενσωμάτωσης Web API

Διαχειριστείτε τη μεταφόρτωση και τις μετατροπές αρχείων κειμένου σε ASP.NET Core:

[HttpPost("convert-csv-to-excel")]
public IActionResult ConvertCsvToExcel(IFormFile file)
{
    try
    {
        // Save uploaded CSV
        string csvPath = Path.GetTempFileName();
        using (var stream = new FileStream(csvPath, FileMode.Create))
        {
            file.CopyTo(stream);
        }
        
        // Convert to Excel
        string excelPath = Path.ChangeExtension(csvPath, ".xlsx");
        TextConverter.Process(csvPath, excelPath);
        
        // Read result
        byte[] fileBytes = File.ReadAllBytes(excelPath);
        
        // Clean up
        File.Delete(csvPath);
        File.Delete(excelPath);
        
        return File(fileBytes, 
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            Path.GetFileNameWithoutExtension(file.FileName) + ".xlsx");
    }
    catch (Exception ex)
    {
        return StatusCode(500, $"Conversion error: {ex.Message}");
    }
}

Δημιουργία Σεναρίου SQL

Μετατρέψτε τα δεδομένα Excel σε δηλώσεις SQL INSERT:

using Aspose.Cells;
using Aspose.Cells.Saving;

Workbook workbook = new Workbook("sample.xlsx");

SqlScriptSaveOptions sqlOptions = new SqlScriptSaveOptions();
sqlOptions.TableName = "Employees";
sqlOptions.OperatorType = SqlScriptOperatorType.Insert;
sqlOptions.Separator = ';';

workbook.Save("insert_employees.sql", sqlOptions);

Συμβουλές και Καλές Πρακτικές

Βελτιστοποίηση Απόδοσης

• Χρησιμοποιήστε LowCode API: Εκμεταλλευτείτε TextConverter.Process() για βελτιστοποιημένες, μονογραμμικές μετατροπές.
• Επεξεργασία Ροής: Χρησιμοποιήστε ροές για μεγάλα αρχεία ώστε να ελαχιστοποιήσετε τη χρήση μνήμης.
• Ομαδικές λειτουργίες: Επεξεργαστείτε πολλαπλά αρχεία παράλληλα για σενάρια υψηλής απόδοσης.
• Απόρριψη πόρων: Απορρίψτε τα αντικείμενα βιβλίου εργασίας άμεσα όταν χρησιμοποιείτε την παραδοσιακή API.

Ανίχνευση Μορφής

• Επεκτάσεις αρχείων: Χρησιμοποιήστε τυπικές επεκτάσεις (.csv, .tsv, .xlsx) για αυτόματη ανίχνευση μορφής.
• Ρητές μορφές: Χρησιμοποιήστε το παραδοσιακό API με SaveFormat enum για μη‑τυπικές επεκτάσεις.
• Επικύρωση: Επαληθεύστε τη μορφή του αρχείου εισόδου πριν από τη μετατροπή για να αποφύγετε σφάλματα.

Ποιότητα Δεδομένων

• Κωδικοποίηση: Ευθυγραμμίστε τις ρυθμίσεις κωδικοποίησης με τα συστήματα-στόχους για να αποφύγετε τη διαφθορά χαρακτήρων.
• Διαχωριστικά: Επιλέξτε κατάλληλα διαχωριστικά βάσει του περιεχομένου των δεδομένων (αποφύγετε χαρακτήρες που εμφανίζονται στα δεδομένα).
• Κεφαλίδες: Διασφαλίστε ότι τα αρχεία CSV/TSV έχουν συνεπείς γραμμές κεφαλίδας για τη μετατροπή σε Excel.
• Κενές Γραμμές: Διαμορφώστε τη διαχείριση κενών γραμμών ώστε να αποφεύγονται περιττά κενά δεδομένων.

Ανάπτυξη Παραγωγής

• Αδειοδότηση με Μέτρηση: Αρχικοποιήστε την αδειοδότηση κατά την εκκίνηση της εφαρμογής: new Metered().SetMeteredKey("PublicKey", "PrivateKey")
• Διαχείριση Σφαλμάτων: Τυλίξτε τις κλήσεις μετατροπής σε μπλοκ try-catch με συγκεκριμένη διαχείριση εξαιρέσεων.
• Ασφάλεια Νήματος: Το LowCode API είναι ασφαλές για νήματα· δημιουργήστε ξεχωριστά αντικείμενα Workbook ανά νήμα για το παραδοσιακό API.
• Καταγραφή: Εφαρμόστε καταγραφή για μετρικές μετατροπής (μέγεθος αρχείου, αριθμός γραμμών, διάρκεια).
• Προσωρινά Αρχεία: Καθαρίστε τα προσωρινά αρχεία που δημιουργούνται κατά την επεξεργασία της διαδικτυακής εφαρμογής.

Στρατηγικές Ενσωμάτωσης

• Ροές Εργασίας ETL: Χρησιμοποιήστε το Text Converter ως πρώτο βήμα στις γραμμές δεδομένων.
• Σημεία Τερματισμού API: Επιστρέψτε τα μετατρεπόμενα αρχεία απευθείας από web APIs χρησιμοποιώντας ροές.
• Εισαγωγή Βάσης Δεδομένων: Μετατρέψτε CSV σε Excel για επικύρωση δεδομένων πριν από την εισαγωγή στη βάση δεδομένων.
• Επεξεργασία Προτύπων: Αποθηκεύστε πρότυπα XML/SQLSCRIPT εξωτερικά για εύκολες ενημερώσεις.

Κοινά Προβλήματα και Λύσεις

Συχνές Ερωτήσεις

Τι είναι ο Aspose.Cells Text Converter για .NET;? Μια εξειδικευμένη API για διπλής κατεύθυνσης μετατροπή μεταξύ λογιστικών φύλλων Excel και μορφών κειμένου όπως CSV, TSV, XML και SQLSCRIPT.

Πώς διαφέρει από τον Aspose.Cells για .NET;? Aspose.Cells is a multifunctional library. The Text Converter provides streamlined APIs specifically for text-focused conversion tasks.

Ποιοι τύποι αρχείων υποστηρίζονται;? XLS, XLSX, XLSM, CSV, TSV, XML, TXT, SQLSCRIPT και άλλα.

Μπορώ να μετατρέψω αρχεία CSV σε Excel;? Ναι! Ο Text Converter υποστηρίζει διπλής κατεύθυνσης μετατροπή: Excel ↔ CSV, Excel ↔ TSV, Excel ↔ TXT, κ.λπ.

Πώς λειτουργεί η αυτόματη ανίχνευση μορφής;? Το LowCode API αντλεί τις μορφές εισόδου και εξόδου από τις επεκτάσεις αρχείων (.csv, .xlsx, κλπ.), εξαλείφοντας την ανάγκη να καθορίζονται οι μορφές ρητά.

Πότε πρέπει να χρησιμοποιήσω LowCode vs Traditional API;? Χρησιμοποιήστε LowCode API (TextConverter.Process()) για απλές, τυπικές μετατροπές. Χρησιμοποιήστε το παραδοσιακό API όταν χρειάζεστε προσαρμοσμένους οριοθέτες, κωδικοποίηση ή επιλογές ειδικές για μορφές.

Μπορούν οι ρυθμίσεις δημιουργίας κειμένου να προσαρμοστούν;? Ναι, χρησιμοποιώντας SaveOptions υποκλάσεις όπως TxtSaveOptions, SqlScriptSaveOptions, κ.λπ. με το παραδοσιακό Workbook API.

Πρέπει να καθορίσω την παράμετρο SaveFormat;? Όχι με το LowCode API—οι μορφές ανιχνεύονται αυτόματα από τις επεκτάσεις αρχείων. Με το παραδοσιακό API, μπορείτε να καθορίσετε SaveFormat ρητά.

Μπορώ να μετατρέψω πολλαπλά φύλλα σε ξεχωριστά αρχεία CSV;;;? Ναι, επαναλάβετε μέσω των φύλλων εργασίας και εξάγετε το καθένα ξεχωριστά, ή χρησιμοποιήστε TxtSaveOptions.ExportAllSheets για να ελέγξετε τη συμπεριφορά.

Απαιτείται αδειοδότηση με μέτρηση;? Η αδειοδότηση με μέτρηση είναι προαιρετική, αλλά συνιστάται για παραγωγή ώστε να αποφεύγονται περιορισμοί αξιολόγησης και να παρακολουθείται η χρήση.

Σύνοψη Αναφοράς API

Κύριες Κλάσεις

• TextConverter: Στατική κλάση που παρέχει απλοποιημένες μεθόδους μετατροπής με ανίχνευση μορφής
• Workbook: Παραδοσιακή κλάση API για τη φόρτωση και τη διαχείριση αρχείων Excel
• TxtSaveOptions: Διαμόρφωση για εξαγωγή CSV/TSV με προσαρμοσμένους οριοθέτες και κωδικοποίηση
• TxtLoadOptions: Διαμόρφωση για τη φόρτωση αρχείων CSV/TSV στο Excel
• SqlScriptSaveOptions: Διαμόρφωση για τη δημιουργία σεναρίου SQL
• Metered: Κλάση για τη διαμόρφωση αδειοδότησης με μέτρηση

Βασικές Μέθοδοι

• TextConverter.Process(inputPath, outputPath): Μετατροπή μίας γραμμής με αυτόματη ανίχνευση μορφής
• Workbook.Save(path, SaveFormat): Αποθήκευση βιβλίου εργασίας σε καθορισμένη μορφή
• Workbook.Save(path, SaveOptions): Αποθήκευση βιβλίου εργασίας με προσαρμοσμένες επιλογές
• Metered.SetMeteredKey(publicKey, privateKey): Αρχικοποίηση αδειοδότησης με μέτρηση

Key Properties (TxtSaveOptions)

• Separator: Χαρακτήρας που χρησιμοποιείται για το διαχωρισμό τιμών (προεπιλογή: κόμμα για CSV, στηλοθέτης για TSV)
• Encoding: Κωδικοποίηση κειμένου (UTF-8, UTF-16, κ.λπ.)
• QuoteType: Πώς να παραθέτετε τιμές (Always, AsNeeded, Never)
• ExportAllSheets: Εξαγωγή όλων των φύλλων εργασίας ή μόνο του ενεργού φύλλου
• KeepSeparatorsForBlankRow: Συμπερίληψη διαχωριστών για κενές γραμμές

Υποστηριζόμενες τιμές SaveFormat

• SaveFormat.Csv: Τιμές διαχωρισμένες με κόμμα
• SaveFormat.Tsv: Τιμές διαχωρισμένες με ταμπ
• SaveFormat.Txt: Απλό κείμενο
• SaveFormat.Xml: Μορφή δεδομένων XML