Arbeta med Spreadsheet Management
Arbeta med Spreadsheet Management
Den Workbook klass är ingångspunkten för alla skivor i Aspose.Cells FOSS för C++. Det ger metoder för att skapa nya arbetsböcker, ladda befintliga XLSX-filer, hantera arbetsblad och spara resultatet.
Skapa en ny arbetsbok
Instantiate Workbook att skapa en tom arbetsbok. En standardarbetsflik skapas automatiskt.
#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;
}Ladda upp en befintlig arbetsbok
Gå igenom en filvägen till den Workbook Konstruktor för att ladda en befintlig XLSX-fil. Efter laddning är arbetsbladen och cellerna data tillgängliga omedelbart.
Workbook workbook("existing.xlsx");
Worksheet& sheet = workbook.GetWorksheets()[0];
// Access or modify cells here
workbook.Save("modified.xlsx");Konfigurera arbetsbladets egenskaper
Den Worksheet Klassen exponerar display och skydd egenskaper. Använd dessa för att konfigurera bladen synlighet, nätverksdisplay, zoom och tabfärg.
Worksheet& sheet = workbook.GetWorksheets()[0];
sheet.SetName("Data");
sheet.SetShowGridlines(false);
sheet.SetShowRowColumnHeaders(true);
sheet.SetZoom(80);Skydda och inte skydde ett arbetsblad
Call Worksheet::Protect att låsa ett blad mot redigeringar, och Worksheet::Unprotect För att avlägsna skydd:
sheet.Protect("password");
// ... distribute the workbook ...
sheet.Unprotect("password");Säkerställ unik lista och definierad namnområde
När du lägger till flera arbetsblad programmatiskt, använd Workbook::EnsureUniqueSheetName för att undvika namn kollisioner. användning Workbook::EnsureValidDefinedNameScope att validera att definierade namn är korrekt förklarade.
workbook.EnsureUniqueSheetName();
workbook.EnsureUniqueDefinedName();Spara en arbetsbok
Call Workbook::Save(fileName) att skriva arbetsboken till en skiva.Multiple överladdningar accepterar ett filnamn, en ström eller en uttrycklig SaveFormat.
workbook.Save("products.xlsx");Tips och bästa praxis
- Alltid ringa
Workbook::Dispose()När det görs med en arbetsbok för att släppa ohanterade resurser. - Arbetsblocknamn måste vara unik inom en arbetsbok - användning
EnsureUniqueSheetNameefter batch tillägg. - Setade
Worksheet::SetShowGridlines(false)för presentationsstilar för att förbättra läsbarheten. - Användning
Worksheet::SetZoom(value)att ställa in en standard zoomnivå (procenten) för arbetsblockvisningar. - Tab färger tilldelas via
Worksheet::SetTabColorHjälp användarna att visuellt skilja arbetsblad.
Vanliga frågor
| Issue | Cause | Fixar |
|---|---|---|
| Filer som inte hittades på laddning | fel väg | Använd absolut väg eller verifiera arbetsdirektivet |
| Namn på kollision | Duplicera namn när du lägger till blad | Call EnsureUniqueSheetName() Efter varje tillägg |
| Arbetsbokändringar inte sparas | Save inte kallas | Alltid ringa workbook.Save(path) innan utgången |
| Memory Leak varningar | Dispose inte kallas | Call workbook.Dispose() I slutet av scope |
API Referens sammanfattning
| Klass / Metod | Beskrivning |
|---|---|
Workbook() | Skapa en ny tom arbetsbok |
Workbook(filePath) | Ladda upp en befintlig XLSX-fil |
Workbook::Save(fileName) | Spara arbetsboken till disk |
Workbook::EnsureUniqueSheetName() | Lös duplicerade bladnamn |
Workbook::Dispose() | frigör resurser |
Worksheet::SetName(name) | Renoverar arbetsboken |
Worksheet::SetShowGridlines(bool) | Toggles grid linje synlighet |
Worksheet::SetZoom(percent) | Ställ in standard zoomprocent |
Worksheet::Protect(password) | Lås arbetsboken |
Worksheet::Unprotect(password) | Låter upp arbetsbladen |