Μετατροπέας Aspose.Cells HTML για .NET

Aspose.Cells HTML Converter for .NET enables seamless, high-fidelity conversion between Excel workbooks (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) and HTML/MHTML documents. It exposes a focused API tailored for HTML export and import, ensuring quick integration into any .NET application that requires rendering or embedding spreadsheet content on the web.

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

Για να ξεκινήσετε, προσθέστε το Aspose.Cells for .NET πακέτο NuGet στο έργο σας. Ανατρέξτε στα αναλυτικά βήματα στη Εγκατάσταση σελίδα.

Για την αδειοδότηση, αυτό το πρόσθετο χρησιμοποιεί μετρημένη αδειοδότηση όπως το Aspose.Cells; δείτε τον Αδειοδότηση με μέτρηση οδηγό για λεπτομέρειες διαμόρφωσης.

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

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

• Excel σε HTML: Μετατρέψτε αρχεία Excel (XLS, XLSX, XLSM, XLTX, XLTM, XLSB) σε HTML ή MHTML που συμμορφώνονται με τα πρότυπα. • HTML σε Excel: Εισάγετε HTML/MHTML ξανά σε βιβλία εργασίας Excel για επεξεργασία πλήρους κύκλου.

Μετατροπή Υψηλής Πιστότητας

• Διατηρεί τη μορφοποίηση των κελιών, τις συγχωνευμένες περιοχές, τους τύπους (ως κείμενο), τις εικόνες, τα διαγράμματα και τα σχήματα. • Στυλ βασισμένο σε CSS για συνεπή εμφάνιση και αίσθηση σε όλες τις ιστοσελίδες. • Ανταποκρινόμενη έξοδος πίνακα HTML για απόδοση φιλική προς τα κινητά.

Προσαρμόσιμες Επιλογές Μετατροπής

• Προσαρμοσμένα χαρακτηριστικά κελιού: Προσθέστε προσαρμοσμένα χαρακτηριστικά HTML στα κελιά για βελτιωμένη διαδραστικότητα και σύνδεση δεδομένων. • Εξαγωγή επιλεκτικών φύλλων: Εξάγετε συγκεκριμένα φύλλα εργασίας αντί για ολόκληρο το βιβλίο εργασίας. • Έλεγχος μορφής εξαγωγής: Δημιουργήστε πλήρη έγγραφα HTML ή τμήματα για ενσωμάτωση. • Έλεγχος σελιδοποίησης: Διαχειριστείτε βιβλία εργασίας πολλαπλών φύλλων με προσαρμοσμένη πλοήγηση. • Διαχείριση πόρων: Διαμορφώστε ενσωματωμένους ή εξωτερικούς πόρους (εικόνες, γραμματοσειρές, CSS).

Επεξεργασία Βάσει Ροής

• Υποστήριξη Memory Stream: Μετατρέψτε απευθείας σε memory streams για επεξεργασία εντός μνήμης. • Αποτελεσματικό I/O: Τα API βασισμένα σε ροές ελαχιστοποιούν το αποτύπωμα μνήμης. • Ενσωμάτωση εφαρμογής Web: Εξάγετε αβίαστα HTML σε ροές απάντησης HTTP.

Επεξεργασία Μαζικών Εργασιών και Αυτοματοποίηση

• Επανάληψη σε πολλαπλά workbooks για αυτοματοποίηση μαζικής δημιουργίας HTML. • Γάντζοι συμβάντων για ενσωμάτωση προσαρμοσμένου HTML ή CSS κατά τη μετατροπή. • API ασφαλές ως προς νήματα που επιτρέπει παράλληλη επεξεργασία.

Βελτιστοποίηση Απόδοσης και Μνήμης

• API βασισμένα σε ροή για αποτελεσματικό I/O. • Lazy loading συγκεκριμένων φύλλων ή περιοχών για μεγάλα workbooks. • Υποστήριξη συμπιεσμένης εξόδου HTML (GZip) και ομαδοποίησης πόρων.

Καταγραφή και Διαχείριση Σφαλμάτων

• Παρέχει λεπτομερή διαγνωστικά για μη υποστηριζόμενα στοιχεία ή ελλιπείς γραμματοσειρές. • Στρατηγικές επανάληψης για παροδικά σφάλματα. • Κατάλληλη υποβάθμιση σε απόδοση απλού κειμένου όταν απαιτείται.

Συμβατότητα και Επεκτασιμότητα

• Λειτουργεί σε όλο το .NET Framework, .NET Core και .NET 5/6+. • Μπορεί να συνδυαστεί με Aspose.Cells APIs για προχωρημένη επεξεργασία δεδομένων πριν από την εξαγωγή. • Ελαφρύ σύνολο βελτιστοποιημένο για εργασίες μετατροπής HTML.

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

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

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

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

string src = "template.xlsx";
HtmlConverter.Process(src, "PluginHtml1.html");

Προηγμένη Μετατροπή με Προσαρμοσμένες Επιλογές

Διαμορφώστε τις επιλογές μετατροπής για μεγαλύτερο έλεγχο της εξόδου HTML:

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

string src = "template.xlsx";

// Configure load options
LowCodeLoadOptions lclopts = new LowCodeLoadOptions();
lclopts.InputFile = src;

// Configure HTML save options
LowCodeHtmlSaveOptions lcsopts = new LowCodeHtmlSaveOptions();
HtmlSaveOptions htmlOpts = new HtmlSaveOptions();

// Add custom attribute to cells for data binding or JavaScript interaction
htmlOpts.CellNameAttribute = "SpecAddress";

// Export only the first worksheet (index 0)
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0 });

lcsopts.HtmlOptions = htmlOpts;

// Output to memory stream for in-memory processing
MemoryStream ms = new MemoryStream();
lcsopts.OutputStream = ms;

// Perform conversion
HtmlConverter.Process(lclopts, lcsopts);

// Verify custom attribute in output
string htmlContent = Encoding.ASCII.GetString(ms.ToArray());
Console.WriteLine(htmlContent.IndexOf("SpecAddress=\"B2\"") > 0 
    ? "Specified attribute has been output" 
    : "Cannot find the expected attribute");

Ανάλυση Χαρακτηριστικών: Προσαρμοσμένα Χαρακτηριστικά Κελιών

Προσθέστε προσαρμοσμένα χαρακτηριστικά HTML σε κελιά για βελτιωμένη ενσωμάτωση στο web:

HtmlSaveOptions htmlOpts = new HtmlSaveOptions();
htmlOpts.CellNameAttribute = "data-cell"; // Cells will have data-cell="A1", data-cell="B2", etc.

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

  • Διαχείριση συμβάντων JavaScript σε συγκεκριμένα κελιά
  • Δεσμευση δεδομένων σε web frameworks (Angular, React, Vue)
  • CSS στυλ βάσει διευθύνσεων κελιών
  • Βελτιώσεις προσβασιμότητας με χαρακτηριστικά ARIA

Ανάλυση Χαρακτηριστικού: Επιλεκτική Εξαγωγή Φύλλων

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

// Export only the first sheet (index 0)
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0 });

// Export multiple specific sheets
htmlOpts.SheetSet = new Aspose.Cells.Rendering.SheetSet(new int[] { 0, 2, 4 });

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

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

Ανάλυση Χαρακτηριστικού: Έξοδος Βασισμένη σε Ροή

Διεργασία μετατροπών εξ ολοκλήρου στη μνήμη χωρίς να αγγίξει το σύστημα αρχείων:

MemoryStream ms = new MemoryStream();
lcsopts.OutputStream = ms;
HtmlConverter.Process(lclopts, lcsopts);

// Use the stream content
byte[] htmlBytes = ms.ToArray();
string htmlString = Encoding.UTF8.GetString(htmlBytes);

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

  • Web APIs που επιστρέφουν περιεχόμενο HTML απευθείας
  • Λειτουργίες cloud με εφήμερη αποθήκευση
  • Αποθήκευση HTML εξόδου στη μνήμη ή στο Redis
  • Δημιουργία email με ενσωματωμένα δεδομένα Excel

Παραδοσιακό API: Πλήρης Έλεγχος

Για σενάρια που απαιτούν μέγιστο έλεγχο, χρησιμοποιήστε το παραδοσιακό Workbook API:

using Aspose.Cells;

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

HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.ExportGridLines = true;
saveOptions.ExportImagesAsBase64 = true;
saveOptions.PresentationPreference = true;

workbook.Save("out.html", saveOptions);

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

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

• Επιλεκτική εξαγωγή: Χρήση SheetSet για εξαγωγή μόνο των απαραίτητων φύλλων εργασίας και μείωση του χρόνου επεξεργασίας. • API βασισμένα σε ροή: Αξιοποιήστε τις ροές μνήμης σε διαδικτυακές εφαρμογές για ελαχιστοποίηση των εισόδων/εξόδων δίσκου. • Επικύρωση Εισόδου: Ελέγξτε το μέγεθος και την πολυπλοκότητα του φύλλου εργασίας πριν από τη μετατροπή για αποφυγή στενών σημείων απόδοσης.

Ποιότητα Εξόδου

• Προσαρμοσμένα Χαρακτηριστικά: Χρήση CellNameAttribute για καλύτερη ενσωμάτωση JavaScript και διαχείριση του DOM. • Διαχείριση Πόρων: Διαμορφώστε ενσωματωμένους vs. εξωτερικούς πόρους ανάλογα με το σενάριο ανάπτυξης. • Επιλογές Λεπτομερούς Ρύθμισης: Αξιοποίηση HtmlSaveOptions για τον έλεγχο των γραμμών πλέγματος, των τύπων και της διαχείρισης εικόνων.

Διαχείριση μνήμης

• Απόρριψη Πόρων: Πάντα να τυλίγετε τις λειτουργίες μετατροπής σε using μπλοκ για άμεση απελευθέρωση των πόρων. • Επαναχρησιμοποίηση Ροής: Επαναφορά και επαναχρησιμοποίηση ροών μνήμης για μαζικές μετατροπές ώστε να μειωθεί η πίεση στο GC.

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

• Διαχείριση Σφαλμάτων: Εφαρμόστε μπλοκ try-catch και καταγράψτε προειδοποιήσεις μετατροπής για διασφάλιση ποιότητας. • Επεξεργασία κατά παρτίδες: Εφαρμόστε πρότυπα παραγωγέα-καταναλωτή για μετατροπές υψηλού όγκου. • Στρατηγική προσωρινής αποθήκευσης: Αποθηκεύστε προσωρινά το παραγόμενο HTML με έξυπνο τρόπο σε δυναμικές εφαρμογές web. • Επαλήθευση εξόδου: Επικυρώστε ότι η έξοδος HTML περιέχει το αναμενόμενο περιεχόμενο χρησιμοποιώντας αναζητήσεις συμβολοσειρών ή αναλυτές HTML.

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

ΖήτημαΑνάλυση
Το αρχείο δεν βρέθηκεΕπαληθεύστε την ακρίβεια της διαδρομής του αρχείου και βεβαιωθείτε ότι οι backslashes στα Windows paths έχουν σωστή διαφυγή
Μη υποστηριζόμενη μορφή αρχείουΒεβαιωθείτε ότι η μορφή εισόδου υποστηρίζεται από το Aspose.Cells (XLS, XLSX, XLSM, XLTX, XLTM, XLSB)
Το προσαρμοσμένο χαρακτηριστικό δεν εμφανίζεταιΕπαληθεύστε CellNameAttribute ορίζεται πριν από την κλήση Process() και ελέγξτε την κωδικοποίηση εξόδου HTML
Υπέρβαση μνήμηςΧρησιμοποιήστε εξαγωγή επιλεκτικών φύλλων ή επεξεργαστείτε μεγάλα αρχεία σε τμήματα χρησιμοποιώντας μετατροπή βάσει περιοχής
Λείπουν εικόνες στο HTMLΔιαμόρφωση ExportImagesAsBase64 ή βεβαιωθείτε ότι οι εξωτερικές διαδρομές εικόνων είναι προσβάσιμες

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

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

  • HtmlConverter: Στατική κλάση που παρέχει απλοποιημένες μεθόδους μετατροπής
  • LowCodeLoadOptions: Διαμόρφωση για τη φόρτωση αρχείων Excel
  • LowCodeHtmlSaveOptions: Διαμόρφωση για την έξοδο HTML
  • HtmlSaveOptions: Λεπτομερείς ρυθμίσεις μετατροπής HTML
  • SheetSet: Καθορίζει ποια φύλλα εργασίας θα εξαχθούν

Απαραίτητα Ιδιότητες

  • CellNameAttribute: Προσαρμοσμένο όνομα HTML χαρακτηριστικού για την αναφορά κελιών
  • SheetSet: Πίνακας δεικτών φύλλων εργασίας για εξαγωγή
  • OutputStream: Στοχευμένη ροή για έξοδο HTML
  • InputFile: Διαδρομή αρχείου Excel προέλευσης
 Ελληνικά