การทํางานกับ XLSX Packaging

Aspose.Cells FOSS for C++ reads and writes the .xlsx เปิดรูปแบบ XML ผ่านชั้นการเรียงลําดับที่ตั้งไว้ XlsxWorkbookSerializer class จัดการโหลดและบันทึกส่วนของหนังสือทํางานทั้งหมด รวมทั้งใบงาน สไตล์ ชื่อที่กําหนด คุณสมบัติเอกสาร และกรองอัตโนมัติ.

การอัตราบรรจุและบันทึกไฟล์ XLSX

ใช้การ Workbook ระดับสําหรับการอัตราบรรจุและประหยัดทั้งหมดภายใน, XlsxWorkbookSerializer รับจัดการการบรรจุ Open XML:

#include "aspose/cells_foss/Workbook.h"

using namespace Aspose::Cells_FOSS;

int main() {
    // Load existing XLSX
    Workbook workbook("input.xlsx");

    // Modify content...

    // Save back to XLSX
    workbook.Save("output.xlsx");
    return 0;
}

คุณสมบัติเอกสาร

ไฟล์ XLSX มีคุณสมบัติหลักและเอกสารขยาย (ชื่อ, ผู้เขียน, วันที่สร้าง) ซึ่งถูกจัดการโดย XlsxDocumentProperties, ที่สร้างและบรรทุกของ docProps/core.xml และ docProps/app.xml ส่วน:

Part	บริหารโดย	Contains
`docProps/core.xml`	`XlsxDocumentProperties::BuildCorePropertiesDocument`	ชื่อ, ผู้แต่ง สร้างขึ้น ปรับเปลี่ยน
`docProps/app.xml`	`XlsxDocumentProperties::BuildExtendedPropertiesDocument`	ชื่อการใช้งาน, รุ่น

เมตาเดทและการตั้งค่าของตารางงาน

เมตาข้อมูลระดับหนังสือทํางาน การตั้งค่าการคํานวณ, ดูหนังสือและการคุ้มครองหนังสืองาน 👉 ถูกจัดการโดย XlsxWorkbookProperties:

BuildWorkbookPropertiesElement เขียนการคํานวณหนังสือทํางานและการตั้งค่าการซ้ํา
BuildWorkbookProtectionElement เขียนการป้องกันคําผ่านระดับสมุดทํางาน
BuildBookViewsElement เขียนตําแหน่งหน้าต่างและการตั้งค่าตารางที่ใช้งาน

สไตล์และรูปแบบเลข

ส่วนสไตล์ (xl/styles.xml) จัดการโดย XlsxWorkbookStyles.มันทําแผนที่ Style อวัตถุจากรุ่นในความจําไปยังบันทึกแบบอักษร, เติม, ขอบ และรูปแบบเลขที่เรียงลําดับ:

BuildStylesheet รวมรูปแบบทั้งหมดเป็นรุ่น XML
LoadStylesheet อ่านสไตล์จากไฟล์ XLSX ที่มีอยู่
StylesEqual ตรวจสอบว่าตัวอัตถุรูปแบบสองตัวจะผลิต XML แบบเดียวกันหรือไม่

การบรรจุกรองอัตโนมัติ

การกรองอัตโนมัติสถานะต่อตารางการทํางานถูกเรียงโดย XlsxWorkbookAutoFilter:

BuildAutoFilterElement เขียนเป็น <autoFilter> อุปกรณ์ XML
LoadAutoFilter อ่านการตั้งค่ากรองอัตโนมัติจากส่วนของใบงาน

ชื่อที่กําหนดไว้

ระยะที่ได้รับชื่อและสูตรถูกบรรจุในส่วนของหนังสือทํางาน และโหลดโดย XlsxWorkbookDefinedNames:

BuildDefinedNames เขียนทั้งหมด DefinedName ข้อความในหนังสือทํางาน XML
LoadWorkbookDefinedNames อ่านชื่อที่กําหนดไว้ระหว่างการอุดไฟล์

เคล็ดลับและปฏิบัติที่ดีที่สุด

การใช้งาน Workbook::Save(fileName) ในฐานะจุดออกเดียว ไม่เรียกศึกษาการเรียงลําดับโดยตรง เว้นแต่ขยายห้องสมุด.
การ .xlsx รูปแบบคือรูปแบบเดียวที่สนับสนุนอย่างเต็ม; การบันทึกเป็นรูปทรงอื่น ๆ ไม่ได้มีใน v0.1 .
เส้นทางไฟล์ที่ผ่านไปยัง Workbook(filePath) หรือ Save(filePath) ต้องใช้การแยกเส้นทางของแพลตฟอร์ม และมีคุณสมบัติอย่างเต็มที่เมื่อทํางานในสภาพแวดล้อม ที่กํากับงานอาจแตกต่างกัน.
การป้องกันหนังสือทํางานที่ใช้ผ่าน XlsxWorkbookProperties::BuildWorkbookProtectionElement ไม่ขึ้นอยู่กับการป้องกันระดับตารางงานที่ตั้งผ่าน Worksheet::Protect.

ปัญหาทั่วไป

Issue	Cause	แก้ไข
ไฟล์ไม่โหลดได้	XLSX ที่ไม่ถูกต้องหรือมีการเข้ารหัส	การันตีว่าไฟล์เป็น XLSX แบบธรรมดา (ไม่คุ้มครองผ่านคํารหัส)
สไตล์ที่สูญเสียหลังจากการเก็บ	สไตล์ที่ไม่ใช้ ก่อนการ Save	Call `Cell::SetStyle(style)` ก่อนหน้านี้ `Workbook::Save`
ชื่อที่กําหนดหายไปหลังจากการเดินทางกลับ	กว้างที่ตั้งไว้ในใบผิด	การใช้งาน `DefinedName::SetFormula` ที่อยู่เต็มระยะทาง

คําอธิบายการพบบ่อย API

ประเภท/วิธีการ	Description
`Workbook(filePath)`	อัตราการอัพโหลดไฟล์ XLSX
`Workbook::Save(fileName)`	เก็บเป็น XLSX
`XlsxWorkbookSerializer::Save`	Internal: รุ่นแบบเป็นเรียงใน Open XML
`XlsxWorkbookSerializer::Load`	Internal: deserializes เปิด XML เป็นแบบจําลอง
`XlsxDocumentProperties`	การบรรจุเอกสารหลักและเติมเอนก์สไตล์ของเภท
`XlsxWorkbookProperties`	การจัดเรียงเมตาเดทและการตั้งค่าของหนังสือทํางาน
`XlsxWorkbookStyles`	การบรรจุใบสไตล์
`XlsxWorkbookAutoFilter`	การกรอง XML แพ็คเกจอัตโนมัติ
`XlsxWorkbookDefinedNames`	คําที่กําหนดการ XML แพคเกจ

การทํางานกับ XLSX Packaging