Συνεργασία με διαχείριση Spreadsheet

Η Workbook Η τάξη είναι το σημείο εισόδου για όλες τις λειτουργίες του φύλλου διασποράς στο Aspose.Cells FOSS για C++. παρέχει μεθόδους για τη δημιουργία νέων βιβλία εργασίας, φορτίζει υπάρχοντα αρχεία XLSX, διαχειρίζεται τα φύλλα εργασίας και αποθηκεύει το αποτέλεσμα.

Δημιουργία ενός νέου βιβλίου εργασίας

Αμέσως Workbook Για να δημιουργήσετε ένα κενό βιβλίο εργασίας. Ένα προεπιλεγμένο φύλλο εργασίας δημιουργείται αυτόματα.

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/Worksheet.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Summary");
    workbook.Save("output.xlsx");
    return 0;
}

Κατεβάστε ένα υπάρχον βιβλίο εργασίας

Πάρτε ένα αρχείο στο δρόμο για το Workbook κατασκευαστής για να φορτίσει ένα υπάρχον αρχείο XLSX. Μετά την φόρτωση, φύλλα εργασίας και τα δεδομένα κυττάρων είναι προσβάσιμα αμέσως.

Workbook workbook("existing.xlsx");
Worksheet& sheet = workbook.GetWorksheets()[0];
// Access or modify cells here
workbook.Save("modified.xlsx");

Εισαγωγή ιδιότητες εργαστηρίου

Η Worksheet Η τάξη εκθέτει τις ιδιότητες προβολής και προστασίας. Χρησιμοποιήστε αυτές για να ρυθμίσετε την ορατότητα φύλλου, την προβάλλονση δικτύου και το χρώμα του zoom.

Worksheet& sheet = workbook.GetWorksheets()[0];
sheet.SetName("Data");
sheet.SetShowGridlines(false);
sheet.SetShowRowColumnHeaders(true);
sheet.SetZoom(80);

Προστασία και μη προστασία ενός φύλλου εργασίας

Κλήση Worksheet::Protect να κλείσει ένα φύλλο κατά των εκδόσεων, και Worksheet::Unprotect Για να αφαιρέσετε την προστασία:

sheet.Protect("password");
// ... distribute the workbook ...
sheet.Unprotect("password");

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

Όταν προσθέτετε πολλαπλά φύλλα εργασίας προγραμματικά, χρησιμοποιήστε Workbook::EnsureUniqueSheetName Για να αποφύγετε τις συγκρούσεις ονόματος. χρησιμοποιήστε Workbook::EnsureValidDefinedNameScope να επιβεβαιώσει ότι τα ονόματα που έχουν οριστεί είναι σωστά καταγραφόμενα.

workbook.EnsureUniqueSheetName();
workbook.EnsureUniqueDefinedName();

Αποθηκεύοντας ένα βιβλίο εργασίας

Κλήση Workbook::Save(fileName) για να γράψετε το βιβλίο εργασίας σε δίσκο.Περισσότερα υπερφορτώσεις αποδέχονται ένα όνομα αρχείου, μια ροή ή μια ρητή SaveFormat.

workbook.Save("products.xlsx");

Συμβουλές και βέλτιστες πρακτικές

Πάντα καλέστε Workbook::Dispose() όταν γίνεται με ένα βιβλίο εργασίας για να απελευθερώσει μη διαχειρισμένους πόρους.
Τα ονόματα των φύλλων εργασίας πρέπει να είναι μοναδικά μέσα σε ένα βιβλίο εργασίας - χρήση EnsureUniqueSheetName Μετά την προσθήκη του μπαταρίου.
ΣΕΤΙΔΑ Worksheet::SetShowGridlines(false) για τα φύλλα υποβολής-στυλ για τη βελτίωση της αναγνώσιμης.
Χρησιμοποιήστε Worksheet::SetZoom(value) να ρυθμίσετε ένα προεπιλεγμένο επίπεδο ζουμ (προσάρτηση) για προβολές φύλλων εργασίας.
Τα χρώματα που ανατίθενται μέσω Worksheet::SetTabColor βοηθά τους χρήστες να διακρίνουν οπτικά τα φύλλα εργασίας.

κοινά ζητήματα

Θέμα	Αιτία	ΦΙΛΕΞΗ
Δεν βρέθηκε αρχείο στο φορτίο	Ακατάλληλος δρόμος	Χρησιμοποιήστε το απόλυτο μονοπάτι ή επαληθεύστε τη διεύθυνση εργασίας
Ονομασία σύγκρουσης	Δυπακτικά ονόματα όταν προσθέτετε φύλλα	Κλήση `EnsureUniqueSheetName()` Μετά από κάθε προσθήκη
Αλλαγές στο βιβλίο εργασίας δεν διατηρούνται	`Save` Δεν καλείται	Πάντα καλέστε `workbook.Save(path)` Πριν την έξοδο
Μνημεία προειδοποίηση	`Dispose` Δεν καλείται	Κλήση `workbook.Dispose()` Στο τέλος της περιοχής

Συνοπτική αναφορά API

Τάξη / Μέθοδος	Περιγραφή
`Workbook()`	Δημιουργία ενός νέου κενού βιβλίου εργασίας
`Workbook(filePath)`	Κατεβάστε ένα υπάρχον αρχείο XLSX
`Workbook::Save(fileName)`	Αποθηκεύστε το βιβλίο εργασίας στο δίσκο
`Workbook::EnsureUniqueSheetName()`	Διαλύει διπλά ονόματα φύλλων
`Workbook::Dispose()`	Απελευθέρωση πόρων
`Worksheet::SetName(name)`	Ανακαλύψτε το εργαστήριο
`Worksheet::SetShowGridlines(bool)`	Το δίκτυο Toggles γραμμής ορατότητας
`Worksheet::SetZoom(percent)`	Ορισμός του ποσοστού ζώματος
`Worksheet::Protect(password)`	Κλείνει το εργαστήριο
`Worksheet::Unprotect(password)`	Αποκλείει το εργαστήριο

Συνεργασία με διαχείριση Spreadsheet