기능 개요

기능 개요

Aspose.Cells FOSS for Go의 API은 Workbook, Worksheet, Cells, 및 Cell을 중심으로 합니다. 이 가이드는 라이브러리의 다른 기능인 스타일링, 데이터 검증, 테이블, 그림, 그리고 대용량 파일을 위한 스트리밍 읽기를 살펴봅니다.

셀 스타일링

Font, Fill, Alignment, 및 Border 설정을 재사용 가능한 Style로 그룹화한 뒤, Cell.SetStyle를 사용해 셀에 적용합니다:

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은 Horizontal, Vertical, 및 WrapText을 제어합니다; Border는 Top, Bottom, Left, 및 Right 규칙 가시성을 제어하고 Color도 포함합니다.

데이터 검증

Worksheet.AddDataValidation은 셀 범위에 검증 규칙을 붙입니다. DataValidation 구조체는 규칙 Type, 하나 또는 두 개의 Formula 값, 그리고 오류 메시지 필드를 포함합니다:

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)

정수 범위 검증은 DataValidationTypeWhole을 사용하며, Formula1/Formula2를 하한 및 상한으로 지정합니다.

표

Worksheet.AddTable은(는) 범위에 대해 구조화된 Table을 생성하며, 선택적 헤더 행과 명명된 테이블 스타일을 포함합니다:

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

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

Worksheet.GetTable(name)을(를) 사용하여 이름으로 기존 테이블을 검색합니다.

그림

Worksheet.AddPicture은(는) 이미지를 삽입하고; Picture.SetAnchor(row, col)은(는) 그 위치를 지정합니다:

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)

대용량 파일 스트리밍

StreamingReader은(는) 콜백을 통해 워크시트를 행 단위로 읽어들여, 수천 행에 달하는 워크북을 메모리에 완전히 로드할 필요가 없습니다:

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)
}

팁 및 모범 사례

• 파일에 수천 개의 행이 있을 수 있고 읽기만 필요하고 수정은 필요하지 않을 때 전체 Workbook 로드 대신 StreamingReader를 사용하십시오.
• 한 번 Style를 만든 뒤 각 셀마다 새로 만드는 대신 여러 셀에서 재사용하십시오.
• Cell.SetFormula는 수식 문자열을 그대로 저장합니다 — 저장 시 라이브러리가 아니라 열 때 Excel 또는 LibreOffice에 의해 평가됩니다.
• Save, AddDataValidation, 및 CSV 가져오기/내보내기 호출의 error 반환 값을 확인하십시오 — 잘못된 경로나 형식이 잘못된 입력으로 인해 스프레드시트 I/O가 실패할 수 있습니다.

일반적인 문제

FAQ

라이브러리가 수식을 직접 평가합니까?

No. Cell.SetFormula/GetFormula은 Excel 또는 LibreOffice가 파일을 열 때 평가하는 수식 문자열을 저장합니다.

대용량 워크북을 스트림-읽기뿐 아니라 스트림-쓰기 할 수 있나요?

StreamingReader은 스트리밍 읽기를 지원합니다. 현재 대용량 워크북을 쓰는 것은 표준 인메모리 Workbook/Worksheet API를 통해 이루어집니다.

AddTable가 자동으로 자동 필터를 적용합니까?

이는 현재 API 표면에서 확인되지 않았으며 — HasHeaderRow와 StyleName만이 문서화된 Table 필드입니다. 사용 사례에 중요하다면 생성된 .xlsx 파일을 기준으로 확인하십시오.

API Reference 요약

참조

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