Funkciók áttekintése

Funkciók áttekintése

Aspose.Cells FOSS for Go’s API középpontjában áll Workbook, Worksheet, Cells és Cell. Ez az útmutató végigvezet a könyvtár egyéb képességein: stílus, adatvalidálás, táblázatok, képek és nagy fájlok streaming olvasása.

Cella formázása

Csoportosítsd a Font, Fill, Alignment és Border beállításokat egy újrahasználható Style-be, majd alkalmazd egy cellára a Cell.SetStyle segítségével:

wb := cells_foss.NewWorkbook()
ws := wb.Worksheets[0]

boldStyle := cells_foss.NewStyle()
boldStyle.Font.Bold = true
boldStyle.Font.Size = 12

highlightStyle := cells_foss.NewStyle()
highlightStyle.Font.Color = "FFFFFFFF"
highlightStyle.Font.Bold = true
highlightStyle.Fill = &cells_foss.Fill{
	Type:  cells_foss.FillTypeSolid,
	Color: "FF4472C4",
}

cell, _ := ws.Cells().Get("A1")
cell.SetStyle(boldStyle)

Alignment vezérli a Horizontal, Vertical és WrapText elemeket; Border szabályozza a Top, Bottom, Left és Right szabályláthatóságot, valamint a Color-t.

Adatvalidálás

Worksheet.AddDataValidation egy validációs szabályt csatol egy cellatartományhoz. A DataValidation struktúra tartalmazza a Type szabályt, egy vagy két Formula értéket, valamint a hibaüzenet mezőket:

wb := cells_foss.NewWorkbook()
ws := wb.Worksheets[0]

dv := &cells_foss.DataValidation{
	Type:             cells_foss.DataValidationTypeList,
	Formula1:         `"Apple,Banana,Cherry,Dragonfruit"`,
	AllowBlank:       true,
	ShowErrorMessage: true,
	ErrorTitle:       "Invalid Fruit",
	ErrorMessage:     "Please pick a fruit from the list.",
	ErrorStyle:       cells_foss.ErrorStyleStop,
}
ws.AddDataValidation("A2:A10", dv)

Az egész számú tartomány érvényesítése a DataValidationTypeWhole használatával történik, ahol a Formula1/Formula2 az alsó és felső határ.

Táblák

Worksheet.AddTable egy strukturált Table hoz létre egy tartományon, opcionális fejlécsorral és egy elnevezett táblastílussal:

wb := cells_foss.NewWorkbook()
ws := wb.Worksheets[0]

tbl := ws.AddTable("A1:F6")
tbl.HasHeaderRow = true
tbl.StyleName = "TableStyleMedium6"

Egy meglévő táblát név szerint lekérdezhet Worksheet.GetTable(name) segítségével.

Képek

Worksheet.AddPicture beágyaz egy képet; Picture.SetAnchor(row, col) elhelyezi azt:

wb := cells_foss.NewWorkbook()
ws := wb.Worksheets[0]
imageBytes := []byte{} // populate with real image bytes before use

pic := &cells_foss.Picture{Data: imageBytes, Format: "png"}
ws.AddPicture(pic)
pic.SetAnchor(5, 0)

Nagy fájlok streamelése

StreamingReader soronként olvas egy munkalapot egy visszahíváson keresztül, így egy több ezer soros munkafüzetnek sosem kell teljesen betöltődnie a memóriába:

path := "outputfiles/large_workbook.xlsx"
sr := cells_foss.NewStreamingReader(path)
err := sr.ProcessRows("Sheet1", func(rowIdx int, cells map[string]string) error {
	// process one row at a time
	return nil
})
if err != nil {
	fmt.Printf("Error streaming: %v\n", err)
}

Tippek és legjobb gyakorlatok

• Használja a StreamingReader helyett a teljes Workbook betöltést, ha egy fájl több ezer sort tartalmazhat, és csak olvasni kell, nem módosítani.
• Építsen egy Style egyszer, és használja újra több cellában, ahelyett, hogy minden cellához újat hozna létre.
• Cell.SetFormula szó szerint tárolja a képlet karakterláncot — a megnyitáskor az Excel vagy a LibreOffice értékeli ki, nem a könyvtár mentéskor.
• Ellenőrizze a error visszatérési értékét a Save, AddDataValidation és a CSV import/export hívásoknál — a táblázat I/O hibát okozhat érvénytelen útvonalak vagy hibás bemenet esetén.

Gyakori problémák

FAQ

A könyvtár maga értékeli ki a képleteket?

Nem. Cell.SetFormula/GetFormula tárol egy képlet karakterláncot, amelyet az Excel vagy a LibreOffice értékel ki, amikor a fájlt megnyitják.

Készíthetek-e adatfolyam-írást nagy munkafüzetekhez, nem csak adatfolyam-olvasást?

StreamingReader lefedi az adatfolyam-olvasásokat. Nagy munkafüzetek írása jelenleg a szabványos memóriában lévő Workbook/Worksheet API útján történik.

Alkalmazza-e a AddTable automatikusan az automatikus szűrőt?

Ez nincs megerősítve a jelenlegi API felületen — csak a HasHeaderRow és a StyleName dokumentált Table mezők. Ellenőrizze a generált .xlsx fájlban, ha ez fontos az Ön esetében.

API Reference összegzés

Lásd még:

• Aspose.Cells — Enterprise Product Family
• Aspose.Cells — Enterprise Documentation